mb-convert-case.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<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>Modifie la casse d'une chaîne</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>mb_convert_case</methodname>
   <methodparam><type>string</type><parameter>string</parameter></methodparam>
   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Effectue la modification de la casse de la chaîne spécifiée,
   suivant le <parameter>mode</parameter> spécifié.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>string</parameter></term>
     <listitem>
      <para>
       La chaîne à convertir.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       Le mode de conversion. Peut être un parmi :
       <constant>MB_CASE_UPPER</constant>, 
       <constant>MB_CASE_LOWER</constant>, 
       <constant>MB_CASE_TITLE</constant>,
       <constant>MB_CASE_FOLD</constant>,
       <constant>MB_CASE_UPPER_SIMPLE</constant>,
       <constant>MB_CASE_LOWER_SIMPLE</constant>,
       <constant>MB_CASE_TITLE_SIMPLE</constant>,
       <constant>MB_CASE_FOLD_SIMPLE</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 chaîne dont la casse a été changée, suivant le
   <parameter>mode</parameter> fourni.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.3.0</entry>
       <entry>
        Mise en œuvre des règles de mise en minuscule conditionnelle pour la lettre grecque sigma,
        qui s'appliquent uniquement aux modes <constant>MB_CASE_LOWER</constant>
        et <constant>MB_CASE_TITLE</constant>, mais pas aux modes
        <constant>MB_CASE_LOWER_SIMPLE</constant> et <constant>MB_CASE_TITLE_SIMPLE</constant>.
       </entry>
      </row>
      <row>
       <entry>7.3.0</entry>
       <entry>
        Ajout du support de
        <constant>MB_CASE_FOLD</constant>,
        <constant>MB_CASE_UPPER_SIMPLE</constant>,
        <constant>MB_CASE_LOWER_SIMPLE</constant>,
        <constant>MB_CASE_TITLE_SIMPLE</constant>, et
        <constant>MB_CASE_FOLD_SIMPLE</constant>
        en tant que <parameter>mode</parameter>.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <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, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str, PHP_EOL;
?>
]]>
    </programlisting>
   </example>
  </para>

  <para>
   <example>
    <title>Exemple avec <function>mb_convert_case</function> avec du
     texte UTF-8 non latin</title>
    <programlisting role="php">
<![CDATA[
<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str, PHP_EOL;
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <para>
   Contrairement aux fonctions standards comme
   <function>strtolower</function> et <function>strtoupper</function>,
   la modification est réalisée en se basant sur le dictionnaire Unicode.
   Par conséquent, le comportement de cette fonction n'est pas modifié
   par des configurations locales, et il peut convertir n'importe quel
   caractère qui a des propriétés alphabétiques, comme
   le a majuscule tréma (<literal>A-umlaut</literal>, Ä).
  </para>
  <para>
   Pour plus d'informations sur les propriétés de l'Unicode, visitez le site de
   <link xlink:href="&url.unicode.reports;">&url.unicode.reports;</link>.
  </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
-->