doc-fr/reference/mbstring/functions/mb-convert-case.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b4afab59db15ea4b7c5dc2132d85932b4859bcf2 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>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; // Affiche : MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Affiche : Mary Had A Little Lamb And She Loved It So
?>
]]>
    </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; // Affiche ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Affiche Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>
]]>
    </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
-->