archived-doc-es/reference/mbstring/functions/mb-convert-case.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4d2ed4ef0bd24c3f2f8810ea899dd06bac4420e6 Maintainer: chuso Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->

<refentry xml:id="function.mb-convert-case" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>mb_convert_case</refname>
  <refpurpose>Realiza una conversión a mayúsculas/minúsculas de un string</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>mb_convert_case</methodname>
   <methodparam><type>string</type><parameter>str</parameter></methodparam>
   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>mb_internal_encoding()</initializer></methodparam>
  </methodsynopsis>
  <para>
   Realiza una conversión a mayúsculas/minúsculas en un <type>string</type>, de acuerdo al
   modo especificado por <parameter>mode</parameter>.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>str</parameter></term>
     <listitem>
      <para>
       El <type>string</type> que se va a convertir.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       El modo de conversión. Puede ser
       <constant>MB_CASE_UPPER</constant>, 
       <constant>MB_CASE_LOWER</constant>, o
       <constant>MB_CASE_TITLE</constant>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>encoding</parameter></term>
     <listitem>
      &mbstring.encoding.parameter;
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   La versión convertida del <parameter>string</parameter> tal como se
   especificó en el parámetro <parameter>mode</parameter>.
  </para>
 </refsect1>
 
 <refsect1 role="unicode">
  &reftitle.unicode;
  <para>
   A diferencia de las funciones estándar de mayúsculas/minúsculas, como
   <function>strtolower</function> y <function>strtoupper</function>,
   la conversión se lleva a cabo según los fundamentos de las propiedades de los
   caracteres Unicode. De esta forma, esta función no se ve afectada
   por las configuraciones regionales, ya que puede convertir cualquier carácter que
   contenga la propiedad 'alfabética', como la A con diéresis (Ä). 
  </para>
  <para>
   Para más información sobre las propiedades Unicode, por favor, revise <link
   xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>mb_convert_case</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$str = "mary had a Little lamb and she loved it so";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Muestra MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Muestra Mary Had A Little Lamb And She Loved It So
?>
]]>
    </programlisting>
   </example>
  </para>
  
  <para>
   <example>
    <title>Ejemplo de <function>mb_convert_case</function> con texto no latino en UTF-8</title>
    <programlisting role="php">
<![CDATA[
<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Muestra ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Muestra Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mb_strtolower</function></member>
    <member><function>mb_strtoupper</function></member>
    <member><function>strtolower</function></member>
    <member><function>strtoupper</function></member>
    <member><function>ucfirst</function></member>
    <member><function>ucwords</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->