enumcharnames.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: Fan2Shrek Status: ready -->
<refentry xml:id="intlchar.enumcharnames" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>IntlChar::enumCharNames</refname>
  <refpurpose>Enumère tous les caractères Unicode assignés dans une plage</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis role="IntlChar">
   <modifier>public</modifier> <modifier>static</modifier> <type>bool</type><methodname>IntlChar::enumCharNames</methodname>
   <methodparam><type class="union"><type>int</type><type>string</type></type><parameter>start</parameter></methodparam>
   <methodparam><type class="union"><type>int</type><type>string</type></type><parameter>end</parameter></methodparam>
   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer><constant>IntlChar::UNICODE_CHAR_NAME</constant></initializer></methodparam>
  </methodsynopsis>
  <para>
   Enumère tous les caractères Unicode assignés entre les points de code de début et de fin (inclusivement le début, exclusivement la fin)
   et appelle une fonction pour chacun, passant la valeur du point de code et le nom du caractère.
  </para>
  <para>
   Pour les noms Unicode 1.0, seuls ceux qui diffèrent des noms modernes sont énumérés.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <variablelist>
   <varlistentry>
    <term><parameter>start</parameter></term>
    <listitem>
     <para>
      Le premier point de code dans la plage d'énumération.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>end</parameter></term>
    <listitem>
     <para>
      Un ou plusieurs points de code de plus que le dernier point de code dans la plage d'énumération (le premier après la plage).
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>callback</parameter></term>
    <listitem>
     <para>
      La fonction qui doit être appelée pour chaque nom de caractère. Les trois arguments suivants lui seront passés :
      <simplelist>
       <member><type>int</type> <literal>$codepoint</literal> - La valeur numérique du point de code</member>
         <member><type>int</type> <literal>$nameChoice</literal> - La même valeur que le paramètre <parameter>type</parameter> ci-dessous</member>
         <member><type>string</type> <literal>$name</literal> - Le nom du caractère</member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>type</parameter></term>
    <listitem>
     <para>
      Un sélecteur pour le type de noms à énumérer. Peut être une des constantes suivantes :
      <simplelist>
       <member><constant>IntlChar::UNICODE_CHAR_NAME</constant> (défaut)</member>
       <member><constant>IntlChar::UNICODE_10_CHAR_NAME</constant></member>
       <member><constant>IntlChar::EXTENDED_CHAR_NAME</constant></member>
       <member><constant>IntlChar::CHAR_NAME_ALIAS</constant></member>
       <member><constant>IntlChar::CHAR_NAME_CHOICE_COUNT</constant></member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </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>
        Cette méthode retourne maintenant &false; en cas d'échec ; précédemment elle retournait &null;.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Enumère une plage d'exemples de points de code</title>
   <programlisting role="php">
    <![CDATA[
<?php
IntlChar::enumCharNames(0x2600, 0x2610, function($codepoint, $nameChoice, $name) {
    printf("U+%04x %s\n", $codepoint, $name);
});
?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
    <![CDATA[
U+2600 BLACK SUN WITH RAYS
U+2601 CLOUD
U+2602 UMBRELLA
U+2603 SNOWMAN
U+2604 COMET
U+2605 BLACK STAR
U+2606 WHITE STAR
U+2607 LIGHTNING
U+2608 THUNDERSTORM
U+2609 SUN
U+260a ASCENDING NODE
U+260b DESCENDING NODE
U+260c CONJUNCTION
U+260d OPPOSITION
U+260e BLACK TELEPHONE
U+260f WHITE TELEPHONE
]]>
   </screen>
  </example>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>IntlChar::charName</function></member>
    <member><function>IntlChar::charFromName</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
-->