cvs: phpdoc-fr /reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml
iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml ob-iconv-handler.xml

From:	Yannick Torres	Date:	Sun, 04 Feb 2007 20:48:54 +0000
Subject:	cvs: phpdoc-fr /reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml ob-iconv-handler.xml
Groups:	php.doc.fr
Request:	Send a blank email to doc-fr+get-5224@lists.php.net to get a copy of this message

yannick Sun Feb 4 20:48:54 2007 UTC Modified files: /phpdoc-fr/reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml ob-iconv-handler.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml:1.9 phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml:1.10 --- phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml:1.9 Tue Nov 16 21:44:42 2004 +++ phpdoc-fr/reference/iconv/functions/iconv-get-encoding.xml Sun Feb 4 20:48:53 2007 @@ -1,50 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-get-encoding"> - <refnamediv> - <refname>iconv_get_encoding</refname> - <refpurpose> - Lit le jeu de caractères courant - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>iconv_get_encoding</methodname> - <methodparam choice="opt"><type>string</type><parameter>type</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_get_encoding</function> retourne le paramètrage courant du - gestionnaire <function>ob_iconv_handler</function> ou bien &false; en cas d'échec. - Les valeurs possibles pour le paramètre optionnel <parameter>type</parameter> sont : - <simplelist> - <member>all</member> - <member>input_encoding</member> - <member>output_encoding</member> - <member>internal_encoding</member> - </simplelist> - Si <parameter>type</parameter> est omis ou différent de <literal>all</literal> - (c'est-à-dire "tous"), <function>iconv_get_encoding</function> retourne un - tableau contenant toutes les valeurs de ces constantes. - </para> - <para> - <example> - <title>Exemple avec <function>iconv_get_encoding</function></title> - <programlisting role="php"> + +<refentry id="function.iconv-get-encoding"> + <refnamediv> + <refname>iconv_get_encoding</refname> + <refpurpose>Lit le jeu de caractères courant</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>iconv_get_encoding</methodname> + <methodparam choice="opt"><type>string</type><parameter>type</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le paramètrage courant du gestionnaire <function>ob_iconv_handler</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>type</parameter></term> + <listitem> + <para> + Les valeurs possibles pour le paramètre optionnel <parameter>type</parameter> sont : + <simplelist> + <member>all</member> + <member>input_encoding</member> + <member>output_encoding</member> + <member>internal_encoding</member> + </simplelist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la valeur courante de la variable de configuration en cas de succès, + ou &false; si une erreur survient. + </para> + <para> + Si <parameter>type</parameter> est omis ou différent de <literal>all</literal> + (c'est-à-dire "tous"), <function>iconv_get_encoding</function> retourne un + tableau contenant toutes les valeurs de ces constantes. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv_get_encoding</function></title> + <programlisting role="php"> <![CDATA[ <pre> <?php - iconv_set_encoding("internal_encoding", "UTF-8"); - iconv_set_encoding("output_encoding", "ISO-8859-1"); - var_dump(iconv_get_encoding('all')); +iconv_set_encoding("internal_encoding", "UTF-8"); +iconv_set_encoding("output_encoding", "ISO-8859-1"); +var_dump(iconv_get_encoding('all')); ?> </pre> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -52,17 +80,24 @@ [output_encoding] => ISO-8859-1 [internal_encoding] => UTF-8 ) + ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>iconv_set_encoding</function> et - <function>ob_iconv_handler</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>iconv_set_encoding</function></member> + <member><function>ob_iconv_handler</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml:1.9 phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml:1.10 --- phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml:1.9 Sun Jan 7 10:22:00 2007 +++ phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml Sun Feb 4 20:48:53 2007 @@ -1,90 +1,113 @@ <?xml version='1.0' encoding='iso-8859-1'?> - - + +  - <refentry id="function.iconv-mime-decode-headers"> - <refnamediv> - <refname>iconv_mime_decode_headers</refname> - <refpurpose> - Décode des en-têtes <literal>MIME</literal> multiples - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>iconv_mime_decode_headers</methodname> - <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - - <para> - <function>iconv_mime_decode_headers</function> retourne un tableau - associatif qui contient les en-têtes <literal>MIME</literal> spécifiés - par le paramètre <parameter>encoded_headers</parameter>, ou bien &false; - si une erreur survient durant le décodage. - </para> - - <para> - Chaque clé du tableau retourné contient un nom d'en-tête distinct, - et sa valeur correspondante. Si plusieurs champs ont le même nom, - <function>iconv_mime_decode_headers</function> fera de ce champ un - tableau indexé, avec les valeurs dans leur ordre d'apparence. - </para> - - <para> - <parameter>mode</parameter> détermine le comportement de la fonction, - si <function>iconv_mime_decode_headers</function> rencontre un - en-tête <literal>MIME</literal> malformé. Vous pouvez spécifier une - combinaison des options suivantes : - <table> - <title>Options de <function>iconv_mime_decode_headers</function></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Valeur</entry> - <entry>Constante</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry><constant>ICONV_MIME_DECODE_STRICT</constant></entry> - <entry> - Si utilisés, les en-têtes sont décodés en respectant scrupuleusement - le standard de la <ulink url="&url.rfc;2047">RFC2047</ulink>. - Cette option est désactivée par défaut, car il y a de nombreux clients - mails qui ne suivent pas ces spécifications et qui ne produisent pas - d'en-têtes <literal>MIME</literal> corrects. - </entry> - </row> - <row> - <entry>2</entry> - <entry><constant>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</constant></entry> - <entry> - Si cette option est activée, <function>iconv_mime_decode_headers</function> - tente d'ignorer les erreurs de syntaxe et continue de traiter l'en-tête - donné. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - - <para> - Le paramètre optionnel <parameter>charset</parameter> spécifie le - jeu de caractères utilisé pour représenter le résultat. - S'il est omis, le jeu définit dans le fichier &php.ini; - <link linkend="iconv.configuration">iconv.internal_charset</link> - est utilisé. - </para> - - <example> - <title>Exemple avec <function>iconv_mime_decode_headers</function></title> - <programlisting role="php"> +<refentry id="function.iconv-mime-decode-headers"> + <refnamediv> + <refname>iconv_mime_decode_headers</refname> + <refpurpose>Décode des en-têtes <literal>MIME</literal> multiples</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>iconv_mime_decode_headers</methodname> + <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un tableau associatif qui contient les en-têtes <literal>MIME</literal> spécifiés + par le paramètre <parameter>encoded_headers</parameter>, ou bien &false; + si une erreur survient durant le décodage. + </para> + <para> + Chaque clé du tableau retourné contient un nom d'en-tête distinct, + et sa valeur correspondante. Si plusieurs champs ont le même nom, + <function>iconv_mime_decode_headers</function> fera de ce champ un + tableau indexé, avec les valeurs dans leur ordre d'apparence. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>encoded_headers</parameter></term> + <listitem> + <para> + Les en-têtes encodés, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + <parameter>mode</parameter> détermine le comportement de la fonction, + si <function>iconv_mime_decode_headers</function> rencontre un + en-tête <literal>MIME</literal> malformé. + <table> + <title>Masques acceptables pour la fonction <function>iconv_mime_decode_headers</function></title> + <tgroup cols="3"> + <thead> + <row> + <entry>Valeur</entry> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry>ICONV_MIME_DECODE_STRICT</entry> + <entry> + Si utilisés, les en-têtes sont décodés en respectant scrupuleusement + le standard de la <ulink url="&url.rfc;2047">RFC2047</ulink>. + Cette option est désactivée par défaut, car il y a de nombreux clients + mails qui ne suivent pas ces spécifications et qui ne produisent pas + d'en-têtes <literal>MIME</literal> corrects. + </entry> + </row> + <row> + <entry>2</entry> + <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> + <entry> + Si cette option est activée, <function>iconv_mime_decode_headers</function> + tente d'ignorer les erreurs de syntaxe et continue de traiter l'en-tête + donné. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Le paramètre optionnel <parameter>charset</parameter> spécifie le + jeu de caractères utilisé pour représenter le résultat. + S'il est omis, le jeu définit dans le fichier &php.ini; + <link linkend="iconv.configuration">iconv.internal_charset</link> + est utilisé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv_mime_decode_headers</function></title> + <programlisting role="php"> <![CDATA[ <?php $headers_string = <<<EOF @@ -93,9 +116,9 @@ Date: Thu, 1 Jan 1970 00:00:00 +0000 Message-Id: <example@example.com> Received: from localhost (localhost [127.0.0.1]) by localhost - with SMTP id example for <example@example.com>; - Thu, 1 Jan 1970 00:00:00 +0000 (UTC) - (envelope-from example-return-0000-example=example.com@example.com) + with SMTP id example for <example@example.com>; + Thu, 1 Jan 1970 00:00:00 +0000 (UTC) + (envelope-from example-return-0000-example=example.com@example.com) Received: (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 EOF; @@ -104,9 +127,9 @@ print_r($headers); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -122,19 +145,25 @@ ) ]]> - </screen> - </example> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>iconv_mime_decode</function></member> + <member><function>mb_decode_mimeheader</function></member> + <member><function>imap_mime_header_decode</function></member> + <member><function>imap_base64</function></member> + <member><function>imap_qprint</function></member> + </simplelist> + </para> + </refsect1> - <para> - Voir aussi - <function>iconv_mime_decode</function>, - <function>mb_decode_mimeheader</function>, - <function>imap_mime_header_decode</function>, - <function>imap_base64</function> et - <function>imap_qprint</function>. - </para> - </refsect1> - </refentry> +</refentry>  - + +  - <refentry id="function.iconv-mime-decode"> - <refnamediv> - <refname>iconv_mime_decode</refname> - <refpurpose> - Décode un champ d'en-tête MIME - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>iconv_mime_decode</methodname> - <methodparam><type>string</type><parameter>encoded_header</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_mime_decode</function> retourne un champ d'en-tête - décodé ou &false; si une erreur survient. - </para> - <para> - <parameter>mode</parameter> détermine une alternative dans le cas - où <function>iconv_mime_decode</function> rencontre un champ d'en-tête - <literal>MIME</literal> mal formé. Pour pouver spécifier n'importe lequels - des masques suivantes : - <table> - <title>Masques acceptés pour la fonction <function>iconv_mime_decode</function></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Valeur</entry> - <entry>Constante</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry>ICONV_MIME_DECODE_STRICT</entry> - <entry> - Si défini, l'en-tête correspondante sera décodé en suivant strictement - le standard <ulink url="&url.rfc;2047">RFC2047</ulink>. - Cette option est désactivé par défaut car il existe beaucoups - de mauvais <literal>mail user agents</literal> qui ne suivent pas - ce standard et donc, produisent de mauvaises en-têtes <literal>MIME</literal>. - </entry> - </row> - <row> - <entry>2</entry> - <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> - <entry> - Si défini, <function>iconv_mime_decode</function> essaie de continuer à décoder - l'en-tête passée même si des erreurs apparaissent. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - - <para> - Le paramètre par défaut <parameter>charset</parameter> spécifie le jeux de caractères - a utilisé pour représenter le résultat. S'il est omis, - <link linkend="iconv.configuration">iconv.internal_charset</link> sera utilisé. - </para> - - <example> - <title>Exemple avec <function>iconv_mime_decode</function></title> - <programlisting role="php"> + +<refentry id="function.iconv-mime-decode"> + <refnamediv> + <refname>iconv_mime_decode</refname> + <refpurpose>Décode un champ d'en-tête MIME</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>iconv_mime_decode</methodname> + <methodparam><type>string</type><parameter>encoded_header</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Décode un champ d'en-tête MIME. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>encoded_header</parameter></term> + <listitem> + <para> + L'en-tête encodé, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + <parameter>mode</parameter> détermine une alternative dans le cas + où <function>iconv_mime_decode</function> rencontre un champ d'en-tête + <literal>MIME</literal> mal formé. + <table> + <title>Masques acceptables pour la fonction <function>iconv_mime_decode</function></title> + <tgroup cols="3"> + <thead> + <row> + <entry>Valeur</entry> + <entry>Constante</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry>ICONV_MIME_DECODE_STRICT</entry> + <entry> + Si défini, l'en-tête correspondante sera décodé en suivant strictement + le standard <ulink url="&url.rfc;2047">RFC2047</ulink>. + Cette option est désactivé par défaut car il existe beaucoups + de mauvais <literal>mail user agents</literal> qui ne suivent pas + ce standard et donc, produisent de mauvaises en-têtes <literal>MIME</literal>. + </entry> + </row> + <row> + <entry>2</entry> + <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> + <entry> + Si défini, <function>iconv_mime_decode</function> essaie de continuer à décoder + l'en-tête passée même si des erreurs apparaissent. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Le paramètre par défaut <parameter>charset</parameter> spécifie le jeux de caractères + a utilisé pour représenter le résultat. S'il est omis, + <link linkend="iconv.configuration">iconv.internal_charset</link> sera utilisé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un champs <literal>MIME</literal> en cas de succès, + ou &false; si une erreur survient durant le décodage. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv_mime_decode</function></title> + <programlisting role="php"> <![CDATA[ <?php // Ceci affichera : "Subject: Prüfung Prüfung" @@ -77,18 +112,25 @@ 0, "ISO-8859-1"); ?> ]]> - </programlisting> - </example> - <para> - Voir aussi - <function>iconv_mime_decode_headers</function>, - <function>mb_decode_mimeheader</function>, - <function>imap_mime_header_decode</function>, - <function>imap_base64</function> et - <function>imap_qprint</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>iconv_mime_decode_headers</function></member> + <member><function>mb_decode_mimeheader</function></member> + <member><function>imap_mime_header_decode</function></member> + <member><function>imap_base64</function></member> + <member><function>imap_qprint</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml:1.15 phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml:1.16 --- phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml:1.15 Sun Jan 7 10:22:00 2007 +++ phpdoc-fr/reference/iconv/functions/iconv-mime-encode.xml Sun Feb 4 20:48:53 2007 @@ -1,157 +1,201 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-mime-encode"> - <refnamediv> - <refname>iconv_mime_encode</refname> - <refpurpose> - Construit un en-tête MIME avec les champs field_name et field_value - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>iconv_mime_encode</methodname> - <methodparam><type>string</type><parameter>field_name</parameter></methodparam> - <methodparam><type>string</type><parameter>field_value</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>preferences</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_mime_encode</function> compose et retourne une chaîne de caractères - qui représente un cahmp en-tête <literal>MIME</literal> qui ressemble à : - <screen> +<refentry id="function.iconv-mime-encode"> + <refnamediv> + <refname>iconv_mime_encode</refname> + <refpurpose>Construit un en-tête MIME avec les champs field_name et field_value</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>iconv_mime_encode</methodname> + <methodparam><type>string</type><parameter>field_name</parameter></methodparam> + <methodparam><type>string</type><parameter>field_value</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>preferences</parameter></methodparam> + </methodsynopsis> + <para> + Compose et retourne une chaîne de caractères qui représente un champs + en-tête <literal>MIME</literal> qui ressemble à : + <screen> <![CDATA[ Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile ]]> - </screen> - Dans l'exemple ci-dessus, "Subject" est le nom du champ et la portion qui commence par - "=?ISO-8859-1?..." est la valeur du champ. - </para> - <para> - Vous pouvez contrôler le comportement de la fonction <function>iconv_mime_encode</function> - en spécifiant un tableau associatif contenant la configuration des éléments dans le - paramètre <parameter>preferences</parameter>. La liste des éléments supportés par - <function>iconv_mime_encode</function> figure ci-dessous. Notez que les noms des éléments - sont sensibles à la casse. - <table> - <title>Liste des éléments supportés par <function>iconv_mime_encode</function></title> - <tgroup cols="5"> - <thead> - <row> - <entry>Elément</entry> - <entry>Type</entry> - <entry>Description</entry> - <entry>Valeur par défaut</entry> - <entry>Exemple</entry> - </row> - </thead> - <tbody> - <row> - <entry>scheme</entry> - <entry><type>boolean</type></entry> - <entry> - Spécifie la méthode d'encodage d'un champ. Les valeurs possibles sont "B" ou "Q", où - "B" signifie que le shéma d'encodage sera <literal>base64</literal> et "Q", - <literal>quoted-printable</literal>. - </entry> - <entry>B</entry> - <entry>B</entry> - </row> - <row> - <entry>input-charset</entry> - <entry><type>string</type></entry> - <entry> - Spécifie le jeux de caractères pour représenter le premier paramètre - <parameter>field_name</parameter> et le second paramètre - <parameter>field_value</parameter>. S'il est omis, - <function>iconv_mime_encode</function> - utilisera la directive de configuration - <link linkend="iconv.configuration">iconv.internal_charset</link> - de votre php.ini pour les représenter. - </entry> - <entry> - <link linkend="iconv.configuration">iconv.internal_charset</link> - </entry> - <entry>ISO-8859-1</entry> - </row> - <row> - <entry>output-charset</entry> - <entry><type>string</type></entry> - <entry> - Sépcifie le jeux de caractères à utiliser pour composer l'en-tête <literal>MIME</literal>. - S'il est omis, la même valeur que <literal>input-charset</literal> sera utilisée. - </entry> - <entry> - <link linkend="iconv.configuration">iconv.internal_charset</link> - </entry> - <entry>UTF-8</entry> - </row> - <row> - <entry>line-length</entry> - <entry>&integer;</entry> - <entry> - Spécifie la longueur maximale de chaque en-tête. - Si l'en-tête est plus grande que la longueur défini par ce paramètre, - l'en-tête résultant sera un en-tête composée de plusieurs lignes - conformément au standard <ulink - url="&url.rfc;2822">RFC2822 - Internet Message Format</ulink>. - S'il est omis, la longueur maximale sera fixée à 76 caractères. - </entry> - <entry>76</entry> - <entry>996</entry> - </row> - <row> - <entry>line-break-chars</entry> - <entry><type>string</type></entry> - <entry> - Spécifie les caractères de fin de ligne. - S'il est omis, la valeur par défaut sera "\r\n" - (<literal>CR</literal> <literal>LF</literal>). Notez que ce paramètre est toujours - représenté comme une chaîne ASCII au regard de la valeur du paramètre + </screen> + Dans l'exemple ci-dessus, "Subject" est le nom du champ et la portion qui commence par + "=?ISO-8859-1?..." est la valeur du champs. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>field_name</parameter></term> + <listitem> + <para> + Le nom du champs. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_value</parameter></term> + <listitem> + <para> + La valeur du champs. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>preferences</parameter></term> + <listitem> + <para> + Vous pouvez contrôler le comportement de la fonction <function>iconv_mime_encode</function> + en spécifiant un tableau associatif contenant la configuration des éléments dans le + paramètre <parameter>preferences</parameter>. La liste des éléments supportés par + <function>iconv_mime_encode</function> figure ci-dessous. Notez que les noms des éléments + sont sensibles à la casse. + <table> + <title>Liste des éléments supportés par <function>iconv_mime_encode</function></title> + <tgroup cols="5"> + <thead> + <row> + <entry>Elément</entry> + <entry>Type</entry> + <entry>Description</entry> + <entry>Valeur par défaut</entry> + <entry>Exemple</entry> + </row> + </thead> + <tbody> + <row> + <entry>scheme</entry> + <entry><type>boolean</type></entry> + <entry> + Spécifie la méthode d'encodage d'un champ. Les valeurs possibles sont "B" ou "Q", où + "B" signifie que le shéma d'encodage sera <literal>base64</literal> et "Q", + <literal>quoted-printable</literal>. + </entry> + <entry>B</entry> + <entry>B</entry> + </row> + <row> + <entry>input-charset</entry> + <entry><type>string</type></entry> + <entry> + Spécifie le jeux de caractères pour représenter le premier paramètre + <parameter>field_name</parameter> et le second paramètre + <parameter>field_value</parameter>. S'il est omis, + <function>iconv_mime_encode</function> + utilisera la directive de configuration + <link linkend="iconv.configuration">iconv.internal_charset</link> + de votre php.ini pour les représenter. + </entry> + <entry> + <link linkend="iconv.configuration">iconv.internal_charset</link> + </entry> + <entry>ISO-8859-1</entry> + </row> + <row> + <entry>output-charset</entry> + <entry><type>string</type></entry> + <entry> + Spécifie le jeux de caractères à utiliser pour composer l'en-tête <literal>MIME</literal>. + S'il est omis, la même valeur que <literal>input-charset</literal> sera utilisée. + </entry> + <entry> + <link linkend="iconv.configuration">iconv.internal_charset</link> + </entry> + <entry>UTF-8</entry> + </row> + <row> + <entry>line-length</entry> + <entry><type>integer</type></entry> + <entry> + Spécifie la longueur maximale de chaque en-tête. + Si l'en-tête est plus grande que la longueur défini par ce paramètre, + l'en-tête résultant sera un en-tête composée de plusieurs lignes + conformément au standard <ulink + url="&url.rfc;2822">RFC2822 - Internet Message Format</ulink>. + S'il est omis, la longueur maximale sera fixée à 76 caractères. + </entry> + <entry>76</entry> + <entry>996</entry> + </row> + <row> + <entry>line-break-chars</entry> + <entry><type>string</type></entry> + <entry> + Spécifie les caractères de fin de ligne. S'il est omis, la valeur par défaut sera "\r\n" + (<literal>CR</literal> <literal>LF</literal>). Notez que ce paramètre est toujours + représenté comme une chaîne ASCII au regard de la valeur du paramètre <literal>input-charset</literal>. - </entry> - <entry>\r\n</entry> - <entry>\n</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - - <example> - <title>Exemple avec <function>iconv_mime_encode</function></title> - <programlisting role="php"> + </entry> + <entry>\r\n</entry> + <entry>\n</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un champs <literal>MIME</literal> en cas de succès, + ou &false; si une erreur survient durant l'encodage. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv_mime_encode</function></title> + <programlisting role="php"> <![CDATA[ <?php $preferences = array( - "input-charset" => "ISO-8859-1", - "output-charset" => "UTF-8", - "line-length" => 76, - "line-break-chars" => "\n" + "input-charset" => "ISO-8859-1", + "output-charset" => "UTF-8", + "line-length" => 76, + "line-break-chars" => "\n" ); $preferences["scheme"] = "Q"; -// Ceci affichera : "Subject: =?UTF-8?Q?Pr=C3=BCfung_Pr=C3=BCfung?=" +// This yields "Subject: =?UTF-8?Q?Pr=C3=BCfung_Pr=C3=BCfung?=" echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences); $preferences["scheme"] = "B"; -// Ceci affichera : "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=" +// This yields "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=" echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences); ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_binary</function></member> + <member><function>mb_encode_mimeheader</function></member> + <member><function>imap_8bit</function></member> + </simplelist> + </para> + </refsect1> - <para> - Voir aussi - <function>imap_binary</function>, - <function>mb_encode_mimeheader</function> et - <function>imap_8bit</function>. - </para> - - </refsect1> - </refentry> +</refentry>  - + +  - <refentry id="function.iconv-set-encoding"> - <refnamediv> - <refname>iconv_set_encoding</refname> - <refpurpose> - Modifie le jeu courant de caractères d'encodage - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>iconv_set_encoding</methodname> - <methodparam><type>string</type><parameter>type</parameter></methodparam> - <methodparam><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_set_encoding</function> modifie le jeu de caractères courant, - et remplace la valeur courante du paramétre <parameter>type</parameter> par - <parameter>charset</parameter>. &return.success;. - </para> - <para> - Les valeurs possibles de <parameter>type</parameter> sont : - <simplelist> - <member>input_encoding</member> - <member>output_encoding</member> - <member>internal_encoding</member> - </simplelist> - </para> - <para> - <example> - <title>Exemple avec <function>iconv_set_encoding</function></title> - <programlisting role="php"> + +<refentry id="function.iconv-set-encoding"> + <refnamediv> + <refname>iconv_set_encoding</refname> + <refpurpose>Modifie le jeu courant de caractères d'encodage</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>iconv_set_encoding</methodname> + <methodparam><type>string</type><parameter>type</parameter></methodparam> + <methodparam><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Modifie le jeu de caractères courant, et remplace la valeur courante + du paramétre <parameter>type</parameter> par <parameter>charset</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>type</parameter></term> + <listitem> + <para> + Les valeurs possibles de <parameter>type</parameter> sont : + <simplelist> + <member>input_encoding</member> + <member>output_encoding</member> + <member>internal_encoding</member> + </simplelist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Le jeu de caractères. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv_set_encoding</function></title> + <programlisting role="php"> <![CDATA[ <?php - iconv_set_encoding("internal_encoding", "UTF-8"); - iconv_set_encoding("output_encoding", "ISO-8859-1"); +iconv_set_encoding("internal_encoding", "UTF-8"); +iconv_set_encoding("output_encoding", "ISO-8859-1"); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>iconv_get_encoding</function> et - <function>ob_iconv_handler</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>iconv_get_encoding</function></member> + <member><function>ob_iconv_handler</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-strlen.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-strlen.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-strlen.xml:1.8 phpdoc-fr/reference/iconv/functions/iconv-strlen.xml:1.9 --- phpdoc-fr/reference/iconv/functions/iconv-strlen.xml:1.8 Sun Dec 11 20:54:36 2005 +++ phpdoc-fr/reference/iconv/functions/iconv-strlen.xml Sun Feb 4 20:48:53 2007 @@ -1,44 +1,75 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-strlen"> - <refnamediv> - <refname>iconv_strlen</refname> - <refpurpose> - Retourne le nombre de caractères d'une chaîne - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>iconv_strlen</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_strlen</function> retourne le nombre de caractères de la - chaîne <parameter>str</parameter>. - </para> - <para> - À l'opposée de <function>strlen</function>, la valeur de retour de - <function>iconv_strlen</function> est le nombre de caractères faisant - partie de la séquence de bytes <parameter>str</parameter>, ce qui n'est - pas toujours la même chose que la taille en bytes de la chaîne de - caractères. - </para> - <para> - Si <parameter>charset</parameter> n'est pas passé en paramètre, - <parameter>str</parameter> est supposée être encodée en - <link linkend="iconv.configuration">iconv.internal_charset</link>. - </para> - <para> - Voir aussi - <function>strlen</function> et - <function>mb_strlen</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.iconv-strlen"> + <refnamediv> + <refname>iconv_strlen</refname> + <refpurpose>Retourne le nombre de caractères d'une chaîne</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>iconv_strlen</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + À l'opposée de <function>strlen</function>, la valeur de retour de + <function>iconv_strlen</function> est le nombre de caractères faisant + partie de la séquence de bytes <parameter>str</parameter>, ce qui n'est + pas toujours la même chose que la taille en bytes de la chaîne de + caractères. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + La &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Si <parameter>charset</parameter> n'est pas passé en paramètre, + <parameter>str</parameter> est supposée être encodée en + <link linkend="iconv.configuration">iconv.internal_charset</link>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de caractères de la chaîne <parameter>str</parameter>, + sous la forme d'un &integer;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strlen</function></member> + <member><function>mb_strlen</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-strpos.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-strpos.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-strpos.xml:1.10 phpdoc-fr/reference/iconv/functions/iconv-strpos.xml:1.11 --- phpdoc-fr/reference/iconv/functions/iconv-strpos.xml:1.10 Sun Dec 11 20:54:36 2005 +++ phpdoc-fr/reference/iconv/functions/iconv-strpos.xml Sun Feb 4 20:48:53 2007 @@ -1,67 +1,108 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-strpos"> - <refnamediv> - <refname>iconv_strpos</refname> - <refpurpose> - Trouve la position de la première occurence de needle dans haystack - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>iconv_strpos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_strpos</function> retourne la position numérique de la - première occurence de <parameter>needle</parameter> dans - <parameter>haystack</parameter>. - </para> - <para> - Le paramètre optionnel <parameter>offset</parameter> spécifie la position - à partir de laquelle la recherche doit commencer. - </para> - <para> - Si <parameter>needle</parameter> n'est pas trouvé, - <function>iconv_strpos</function> retournera &false;. - </para> - - &return.falseproblem; - - <para> - Si <parameter>haystack</parameter> ou <parameter>needle</parameter> ne - sont pas des chaînes de caractères, ils sont convertis en entiers et - appliqués en tant que valeur ordinale d'un caractère. - </para> - - <para> - À l'opposé de <function>strpos</function>, la valeur retournée par - <function>iconv_strpos</function> est le nombre de caractères - se trouvant avant needle, plutôt que la position en octets où needle a été trouvé. - Les caractères sont comptés en se basant sur le jeux de caractères spécifié par - <parameter>charset</parameter>. - </para> - - <para> - Si le paramètre <parameter>charset</parameter> est omis, - <parameter>string</parameter> sera encodé en accord avec - <link linkend="iconv.configuration">iconv.internal_charset</link>. - </para> - - <para> - Voir aussi - <function>strpos</function>, - <function>mb_strpos</function> et - <function>iconv_strrpos</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.iconv-strpos"> + <refnamediv> + <refname>iconv_strpos</refname> + <refpurpose>Trouve la position de la première occurence de needle dans haystack</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>iconv_strpos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Trouve la position de la première occurence de needle dans haystack. + </para> + <para> + À l'opposé de <function>strpos</function>, la valeur retournée par + <function>iconv_strpos</function> est le nombre de caractères + se trouvant avant needle, plutôt que la position en octets où needle a été trouvé. + Les caractères sont comptés en se basant sur le jeux de caractères spécifié par + <parameter>charset</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + La &string; entière. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + La &string; à chercher. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Le paramètre optionnel <parameter>offset</parameter> spécifie la position + à partir de laquelle la recherche doit commencer. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Si le paramètre <parameter>charset</parameter> est omis, + <parameter>string</parameter> sera encodé en accord avec + <link linkend="iconv.configuration">iconv.internal_charset</link>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Si <parameter>haystack</parameter> ou <parameter>needle</parameter> ne + sont pas des chaînes de caractères, ils sont convertis en entiers et + appliqués en tant que valeur ordinale d'un caractère. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la position numérique de la première occurence de + <parameter>needle</parameter> dans <parameter>haystack</parameter>. + </para> + <para> + Si <parameter>needle</parameter> n'est pas trouvé, + <function>iconv_strpos</function> retournera &false;. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>iconv_strrpos</function></member> + <member><function>mb_strpos</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml:1.10 phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml:1.11 --- phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml:1.10 Thu May 18 11:55:29 2006 +++ phpdoc-fr/reference/iconv/functions/iconv-strrpos.xml Sun Feb 4 20:48:53 2007 @@ -1,57 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-strrpos"> - <refnamediv> - <refname>iconv_strrpos</refname> - <refpurpose> - Trouve la position de la dernière occurence d'un élément - dans une chaîne, à partir d'un offset - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>iconv_strrpos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv_strrpos</function> retourne la position numérique de la - dernière occurence de <parameter>needle</parameter> dans - <parameter>haystack</parameter>. - </para> - - <para> - Si <parameter>needle</parameter> n'est pas trouvé, <function>iconv_strrpos</function> - retournera &false;. - </para> - - &return.falseproblem; - - <para> - Si <parameter>haystack</parameter> ou <parameter>needle</parameter> - ne sont pas des chaînes de caractères, ils seront convertis en chaîne de caractères et reconnus - comme code ASCII de chaque caractères. - </para> - - <para> - À l'opposé de la fonction <function>strpos</function>, la valeur retournée par - <function>iconv_strrpos</function> est le nombre de caractères avant needle, - plutôt que la position en octets de needle. Les caractères sont comptés en se basant sur - le jeux de caractères <parameter>charset</parameter>. - </para> - - <para> - Voir aussi - <function>strrpos</function>, - <function>iconv_strpos</function> et - <function>mb_strrpos</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.iconv-strrpos"> + <refnamediv> + <refname>iconv_strrpos</refname> + <refpurpose>Trouve la position de la dernière occurence d'un élément dans une chaîne</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>iconv_strrpos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + À l'opposé de la fonction <function>strpos</function>, la valeur retournée par + <function>iconv_strrpos</function> est le nombre de caractères avant needle, + plutôt que la position en octets de needle. Les caractères sont comptés en se basant sur + le jeux de caractères <parameter>charset</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + La &string; entière. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + La &string; cherchée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Si le paramètre optionnel <parameter>charset</parameter> est omis, + <parameter>string</parameter> est supposé être encodé en + <link linkend="iconv.configuration">iconv.internal_charset</link>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Si <parameter>haystack</parameter> ou <parameter>needle</parameter> + ne sont pas des chaînes de caractères, ils seront convertis en chaîne de caractères et reconnus + comme code ASCII de chaque caractères. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la position numérique de la dernière occurence de + <parameter>needle</parameter> dans <parameter>haystack</parameter>. + Les caractères sont comptés en tenant compte du jeu de caractères + spécifié <parameter>charset</parameter>. + </para> + <para> + Si <parameter>needle</parameter> n'est pas trouvé, <function>iconv_strrpos</function> + retournera &false;. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strrpos</function></member> + <member><function>iconv_strpos</function></member> + <member><function>mb_strrpos</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv-substr.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv-substr.xml diff -u phpdoc-fr/reference/iconv/functions/iconv-substr.xml:1.7 phpdoc-fr/reference/iconv/functions/iconv-substr.xml:1.8 --- phpdoc-fr/reference/iconv/functions/iconv-substr.xml:1.7 Fri Jan 7 21:37:32 2005 +++ phpdoc-fr/reference/iconv/functions/iconv-substr.xml Sun Feb 4 20:48:53 2007 @@ -1,74 +1,121 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv-substr"> - <refnamediv> - <refname>iconv_substr</refname> - <refpurpose> - Retourne une partie de chaîne iconv - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>iconv_substr</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - - <para> - <function>iconv_substr</function> retourne le segment de <parameter>str</parameter> - défini par <parameter>start</parameter> et <parameter>length</parameter>. - </para> - - <para> - Si <parameter>start</parameter> est positif, la chaîne retournée commencera - au caractère numéro <parameter>start</parameter>, - dans la chaîne <parameter>str</parameter>. Lepremier caractère est numéroté zéro. - </para> - - <para> - Si <parameter>start</parameter> est négatif, la chaîne retournée commencera au - caractère numéro <parameter>start</parameter> - dans la chaîne <parameter>str</parameter>. - </para> - - <para> - Si <parameter>length</parameter> est fourni et positif, la chaîne retournée contiendra au plus - <parameter>length</parameter> caractères, en commençant à partir du caractère - <parameter>start</parameter> (en fonction de la chaîne <parameter>str</parameter>). - Si <parameter>str</parameter> est plus petite que <parameter>start</parameter>, - <function>iconv_substr</function> retournera &false;. - </para> - - <para> - Si <parameter>length</parameter> est fourni et négatif, alors le même nombre de caractères - sera omis, en partant de la fin de la chaîne <parameter>str</parameter>. Si - <parameter>start</parameter> représente une position hors de la chaîne, - une chaîne vide sera retournée. - </para> - - <para> - Notez que <parameter>offset</parameter> et <parameter>length</parameter> - sont toujours considérés comme représentant une position calculée sur la représentation ASCII - des caractères déterminés par <parameter>charset</parameter>, contrairement à - <function>substr</function> qui se base toujours sur la position par octet. - Si <parameter>charset</parameter> est omis, le jeux de caractères est déterminé - par <link linkend="iconv.configuration">iconv.internal_encoding</link>. - </para> - - <para> - Voir aussi - <function>substr</function>, - <function>mb_substr</function> et - <function>mb_strcut</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.iconv-substr"> + <refnamediv> + <refname>iconv_substr</refname> + <refpurpose>Retourne une partie de chaîne iconv</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>iconv_substr</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le segment de <parameter>str</parameter> défini par + <parameter>start</parameter> et <parameter>length</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + La &string; originale. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Si <parameter>offset</parameter> n'est pas négatif, + <function>iconv_substr</function> retourne le segment de + <parameter>str</parameter> en commençant au <parameter>offset</parameter> ème + caractères, en comptant à partir de zéro. + </para> + <para> + Si <parameter>offset</parameter> est négatif, + <function>iconv_substr</function> retourne le segment en commant à la + position <parameter>offset</parameter> caractères et en allant vers la + fin de la &string; <parameter>str</parameter>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + If <parameter>length</parameter> is given and is positive, the return + value will contain at most <parameter>length</parameter> characters + of the portion that begins at <parameter>offset</parameter> + (depending on the length of <parameter>string</parameter>). + </para> + <para> + Si <parameter>length</parameter> est passé et négatif, + <function>iconv_substr</function> coupe la portion externe de + <parameter>str</parameter> depuis le <parameter>offset</parameter> ème + caractère jusqu'au <parameter>length</parameter> ème caractères depuis la fin de + la &string;. Dans le cas où <parameter>offset</parameter> est également négatif, + la position de départ est calculée en amont, suivant la règle expliquée plus haut. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + Si <parameter>charset</parameter> est omis, + <parameter>string</parameter> est supposé avoir été encodée en + <link linkend="iconv.configuration">iconv.internal_charset</link>. + </para> + <para> + Notez que <parameter>offset</parameter> et <parameter>length</parameter> + sont toujours considérés comme représentant une position calculée sur la représentation ASCII + des caractères déterminés par <parameter>charset</parameter>, contrairement à + <function>substr</function> qui se base toujours sur la position par octet. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la portion de <parameter>str</parameter> spécifié par les paramètres + <parameter>offset</parameter> et <parameter>length</parameter>. + </para> + <para> + Si <parameter>str</parameter> est plus petit que <parameter>offset</parameter>, + &false; sera retourné. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>substr</function></member> + <member><function>mb_substr</function></member> + <member><function>mb_strcut</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/iconv.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/iconv/functions/iconv.xml diff -u phpdoc-fr/reference/iconv/functions/iconv.xml:1.12 phpdoc-fr/reference/iconv/functions/iconv.xml:1.13 --- phpdoc-fr/reference/iconv/functions/iconv.xml:1.12 Sun Mar 13 18:53:45 2005 +++ phpdoc-fr/reference/iconv/functions/iconv.xml Sun Feb 4 20:48:53 2007 @@ -1,51 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.iconv"> - <refnamediv> - <refname>iconv</refname> - <refpurpose>Convertit une chaîne dans un jeu de caractères</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>iconv</methodname> - <methodparam><type>string</type><parameter>in_charset</parameter></methodparam> - <methodparam><type>string</type><parameter>out_charset</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - <function>iconv</function> convertit la chaîne <parameter>str</parameter> - depuis le jeu de caractères <parameter>in_charset</parameter> vers le jeu - de caractères <parameter>out_charset</parameter>. Elle retourne la chaîne - ainsi convertie, ou bien &false;, en cas d'échec. - </para> - <para> - Si vous ajoutez la chaîne <literal>//TRANSLIT</literal> au paramètre - <parameter>out_charset</parameter>, la translittération est activée. - Cela signifie que lorsqu'un caractère ne peut être représenté dans le jeu - de caractères cible, il peut être représenté approximativement à partir - d'un ou plusieurs caractères représentant le même caractère. - Si vous ajoutez la chaîne <literal>//IGNORE</literal>, les caractères qui - ne peuvent être représentés dans le jeu de caractères cible sont - tout simplement ignorés. Sinon, <parameter>str</parameter> sera coupé - à partir du premier caractère illégal rencontré. - </para> - <para> - <example> - <title>Exemple avec <function>iconv</function></title> - <programlisting role="php"> + +<refentry id="function.iconv"> + <refnamediv> + <refname>iconv</refname> + <refpurpose>Convertit une chaîne dans un jeu de caractères</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>iconv</methodname> + <methodparam><type>string</type><parameter>in_charset</parameter></methodparam> + <methodparam><type>string</type><parameter>out_charset</parameter></methodparam> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Convertit la chaîne <parameter>str</parameter> depuis le jeu de + caractères <parameter>in_charset</parameter> vers le jeu + de caractères <parameter>out_charset</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>in_charset</parameter></term> + <listitem> + <para> + Le jeu de caractères d'entrée. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>out_charset</parameter></term> + <listitem> + <para> + Le jeu de caractères de sortie. + </para> + <para> + Si vous ajoutez la chaîne <literal>//TRANSLIT</literal> au paramètre + <parameter>out_charset</parameter>, la translittération est activée. + Cela signifie que lorsqu'un caractère ne peut être représenté dans le jeu + de caractères cible, il peut être représenté approximativement à partir + d'un ou plusieurs caractères représentant le même caractère. + Si vous ajoutez la chaîne <literal>//IGNORE</literal>, les caractères qui + ne peuvent être représentés dans le jeu de caractères cible sont + tout simplement ignorés. Sinon, <parameter>str</parameter> sera coupé + à partir du premier caractère illégal rencontré. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + La &string; à convertir. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la &string; convertie ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>iconv</function></title> + <programlisting role="php"> <![CDATA[ <?php -echo iconv("ISO-8859-1","UTF-8","Ceci est un test."); +echo iconv("ISO-8859-1", "UTF-8", "Ceci est un test."); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml diff -u phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml:1.9 phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml:1.10 --- phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml:1.9 Sat Jun 25 16:25:22 2005 +++ phpdoc-fr/reference/iconv/functions/ob-iconv-handler.xml Sun Feb 4 20:48:53 2007 @@ -1,53 +1,79 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.ob-iconv-handler"> - <refnamediv> - <refname>ob_iconv_handler</refname> - <refpurpose> - Gestionnaire de sortie pour maîtriser le jeu de caractères de sortie - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>ob_iconv_handler</methodname> - <methodparam><type>string</type><parameter>contents</parameter></methodparam> - <methodparam><type>int</type><parameter>status</parameter></methodparam> - </methodsynopsis> - <para> - <function>ob_iconv_handler</function> convertit la chaîne utilisant - le jeu de caractères <parameter>internal_encoding</parameter> en - une chaîne utilisant celui de - <parameter>output_encoding</parameter>. - </para> - <para> - <parameter>internal_encoding</parameter> et - <parameter>output_encoding</parameter> doivent être définis par - <function>iconv_set_encoding</function> ou dans le fichier de configuration - &php.ini;. - </para> - <para> - <example> - <title>Exemple avec <function>ob_iconv_handler</function></title> - <programlisting role="php"> + +<refentry id="function.ob-iconv-handler"> + <refnamediv> + <refname>ob_iconv_handler</refname> + <refpurpose>Gestionnaire de sortie pour maîtriser le jeu de caractères de sortie</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ob_iconv_handler</methodname> + <methodparam><type>string</type><parameter>contents</parameter></methodparam> + <methodparam><type>int</type><parameter>status</parameter></methodparam> + </methodsynopsis> + <para> + Convertit la chaîne utilisant le jeu de caractères <parameter>internal_encoding</parameter> en + une chaîne utilisant celui de <parameter>output_encoding</parameter>. + </para> + <para> + <parameter>internal_encoding</parameter> et + <parameter>output_encoding</parameter> doivent être définis par + <function>iconv_set_encoding</function> ou dans le fichier de configuration + &php.ini;. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + Voir la documentation sur la fonction <function>ob_start</function> + pour plus d'informations sur les paramètres de cette fonction. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Voir la documentation sur la fonction <function>ob_start</function> + pour plus d'informations sur les valeurs retournées par cette fonction. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>ob_iconv_handler</function></title> + <programlisting role="php"> <![CDATA[ <?php - ob_start("ob_iconv_handler"); // start output buffering +iconv_set_encoding("internal_encoding", "UTF-8"); +iconv_set_encoding("output_encoding", "ISO-8859-1"); +ob_start("ob_iconv_handler"); // Commence la mise en buffer de l'affichage ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>iconv_get_encoding</function> et - <function>iconv_set_encoding</function>, et - <link linkend="ref.outcontrol">bufferisation de sortie</link>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>iconv_get_encoding</function></member> + <member><function>iconv_set_encoding</function></member> + <member><link linkend="ref.outcontrol">output-control functions</link></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file

cvs: phpdoc-fr /reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml ob-iconv-handler.xml

cvs: phpdoc-fr /reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml
iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml ob-iconv-handler.xml