Files
doc-fr/reference/strings/functions/nl-langinfo.xml

353 lines
13 KiB
XML
Executable File

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6330e4d73192c49a6867c6bbc3cbf09d63a1e36a Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.nl-langinfo" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>nl_langinfo</refname>
<refpurpose>Rassemble des informations sur la langue et la configuration locale</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>nl_langinfo</methodname>
<methodparam><type>int</type><parameter>item</parameter></methodparam>
</methodsynopsis>
<para>
<function>nl_langinfo</function> est utilisée pour accéder à
chaque élément de la configuration locale. Contrairement à
la fonction <function>localeconv</function> qui renvoie
tous les éléments, <function>nl_langinfo</function> vous
permet de sélectionner un élément précis.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>item</parameter></term>
<listitem>
<para>
<parameter>item</parameter> peut être la valeur entière d'un
élément, ou le nom de sa constante. Voici une liste des noms
de constantes pour <parameter>item</parameter> qui peuvent
être utilisés et leur description. Certaines constantes peuvent
ne pas être définies, ou ne contenir aucune valeur pour certaines
locales.
<table>
<title>Constantes <function>nl_langinfo</function></title>
<tgroup cols="2">
<colspec colname="c1"/>
<colspec colname="c2"/>
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry namest="c1" nameend="c2" align="center"><emphasis>Constantes de la catégorie LC_TIME</emphasis></entry>
</row>
<row>
<entry><constant>ABDAY_(1-7)</constant></entry>
<entry>Nom court du jour de la semaine.</entry>
</row>
<row>
<entry><constant>DAY_(1-7)</constant></entry>
<entry>Nom du jour de la semaine (DAY_1 = Dimanche).</entry>
</row>
<row>
<entry><constant>ABMON_(1-12)</constant></entry>
<entry>Nom abrégé du mois de l'année.</entry>
</row>
<row>
<entry><constant>MON_(1-12)</constant></entry>
<entry>Nom du mois de l'année.</entry>
</row>
<row>
<entry><constant>AM_STR</constant></entry>
<entry>Chaîne pour Ante meridian.</entry>
</row>
<row>
<entry><constant>PM_STR</constant></entry>
<entry>Chaîne pour Post meridian.</entry>
</row>
<row>
<entry><constant>D_T_FMT</constant></entry>
<entry>
Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction
<function>strftime</function> pour représenter la date et l'heure.
</entry>
</row>
<row>
<entry><constant>D_FMT</constant></entry>
<entry>
Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction
<function>strftime</function> pour représenter la date.
</entry>
</row>
<row>
<entry><constant>T_FMT</constant></entry>
<entry>
Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction
<function>strftime</function> pour représenter l'heure.
</entry>
</row>
<row>
<entry><constant>T_FMT_AMPM</constant></entry>
<entry>
Chaîne pouvant être utilisée comme chaîne de formatage
pour la fonction <function>strftime</function> pour représenter
l'heure au format 12 heures, avec ante/post meridian.
</entry>
</row>
<row>
<entry><constant>ERA</constant></entry>
<entry>Ère de substitution.</entry>
</row>
<row>
<entry><constant>ERA_YEAR</constant></entry>
<entry>Année dans le format d'ère de substitution.</entry>
</row>
<row>
<entry><constant>ERA_D_T_FMT</constant></entry>
<entry>Date et heure dans le format d'ère de substitution
(chaîne pouvant être utilisée dans la fonction <function>strftime</function>).</entry>
</row>
<row>
<entry><constant>ERA_D_FMT</constant></entry>
<entry>Date dans le format d'ère de substitution
(chaîne pouvant être utilisée dans la fonction <function>strftime</function>).</entry>
</row>
<row>
<entry><constant>ERA_T_FMT</constant></entry>
<entry>Heure dans le format d'ère de substitution
(chaîne pouvant être utilisée dans la fonction <function>strftime</function>).</entry>
</row>
<row>
<entry namest="c1" nameend="c2" align="center"><emphasis>Constantes de la catégorie LC_MONETARY</emphasis></entry>
</row>
<row>
<entry><constant>INT_CURR_SYMBOL</constant></entry>
<entry>Symbole monétaire international.</entry>
</row>
<row>
<entry><constant>CURRENCY_SYMBOL</constant></entry>
<entry>Symbole monétaire local.</entry>
</row>
<row>
<entry><constant>CRNCYSTR</constant></entry>
<entry>Même valeur que <constant>CURRENCY_SYMBOL</constant>.</entry>
</row>
<row>
<entry><constant>MON_DECIMAL_POINT</constant></entry>
<entry>Caractère de virgule décimale.</entry>
</row>
<row>
<entry><constant>MON_THOUSANDS_SEP</constant></entry>
<entry>Séparateur de centaine (groupes de trois lettres).</entry>
</row>
<row>
<entry><constant>MON_GROUPING</constant></entry>
<entry>Comme l'élément <literal>"grouping"</literal>.</entry>
</row>
<row>
<entry><constant>POSITIVE_SIGN</constant></entry>
<entry>Signe pour les valeurs positives.</entry>
</row>
<row>
<entry><constant>NEGATIVE_SIGN</constant></entry>
<entry>Signe pour les valeurs négatives.</entry>
</row>
<row>
<entry><constant>INT_FRAC_DIGITS</constant></entry>
<entry>Chiffres partiels internationaux.</entry>
</row>
<row>
<entry><constant>FRAC_DIGITS</constant></entry>
<entry>Chiffres partiels locaux.</entry>
</row>
<row>
<entry><constant>P_CS_PRECEDES</constant></entry>
<entry>Retourne 1 si <constant>CURRENCY_SYMBOL</constant> précède une valeur positive.</entry>
</row>
<row>
<entry><constant>P_SEP_BY_SPACE</constant></entry>
<entry>Retourne 1 si un espace sépare <constant>CURRENCY_SYMBOL</constant> d'une valeur positive.</entry>
</row>
<row>
<entry><constant>N_CS_PRECEDES</constant></entry>
<entry>Retourne 1 si <constant>CURRENCY_SYMBOL</constant> précède une valeur négative.</entry>
</row>
<row>
<entry><constant>N_SEP_BY_SPACE</constant></entry>
<entry>Retourne 1 si un espace sépare <constant>CURRENCY_SYMBOL</constant> d'une valeur négative.</entry>
</row>
<row>
<entry><constant>P_SIGN_POSN</constant></entry>
<entry morerows="1" valign="middle">
<itemizedlist>
<listitem>
<simpara>
Retourne 0 si des parenthèses entourent la quantité et <constant>CURRENCY_SYMBOL</constant>.
</simpara>
</listitem>
<listitem>
<simpara>
Retourne 1 si la chaîne de signes précède la quantité et <constant>CURRENCY_SYMBOL</constant>.
</simpara>
</listitem>
<listitem>
<simpara>
Retourne 2 si la chaîne de signes suit la quantité et <constant>CURRENCY_SYMBOL</constant>.
</simpara>
</listitem>
<listitem>
<simpara>
Retourne 3 si la chaîne de signes précède immédiatement le <constant>CURRENCY_SYMBOL</constant>.
</simpara>
</listitem>
<listitem>
<simpara>
Retourne 4 si la chaîne de signes suit immédiatement le <constant>CURRENCY_SYMBOL</constant>.
</simpara>
</listitem>
</itemizedlist>
</entry>
</row>
<row>
<entry><constant>N_SIGN_POSN</constant></entry>
</row>
<row>
<entry namest="c1" nameend="c2" align="center"><emphasis>Constantes de la catégorie LC_NUMERIC</emphasis></entry>
</row>
<row>
<entry><constant>DECIMAL_POINT</constant></entry>
<entry>Caractère de virgule décimale.</entry>
</row>
<row>
<entry><constant>RADIXCHAR</constant></entry>
<entry>Même valeur que <constant>DECIMAL_POINT</constant>.</entry>
</row>
<row>
<entry><constant>THOUSANDS_SEP</constant></entry>
<entry>Caractère de séparation des centaines (groupe de trois lettres).</entry>
</row>
<row>
<entry><constant>THOUSEP</constant></entry>
<entry>Même valeur que <constant>THOUSANDS_SEP</constant>.</entry>
</row>
<row>
<entry><constant>GROUPING</constant></entry>
<entry/>
</row>
<row>
<entry namest="c1" nameend="c2" align="center"><emphasis>Constantes de la catégorie LC_MESSAGES</emphasis></entry>
</row>
<row>
<entry><constant>YESEXPR</constant></entry>
<entry>Chaîne d'expression rationnelle pour chercher l'entrée <literal>"yes"</literal>.</entry>
</row>
<row>
<entry><constant>NOEXPR</constant></entry>
<entry>Chaîne d'expression rationnelle pour chercher l'entrée <literal>"no"</literal>.</entry>
</row>
<row>
<entry><constant>YESSTR</constant></entry>
<entry>Affichage de la chaîne pour <literal>"yes"</literal>.</entry>
</row>
<row>
<entry><constant>NOSTR</constant></entry>
<entry>Affichage de la chaîne pour <literal>"no"</literal>.</entry>
</row>
<row>
<entry namest="c1" nameend="c2" align="center"><emphasis>Constantes de la catégorie LC_CTYPE</emphasis></entry>
</row>
<row>
<entry><constant>CODESET</constant></entry>
<entry>Retourne une chaîne de caractères avec le nom du jeux de caractères.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne l'élément, sous la forme d'une &string; ou &false; si
le paramètre <parameter>item</parameter> n'est pas valide.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>nl_langinfo</function></title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(nl_langinfo(CODESET));
var_dump(nl_langinfo(YESEXPR));
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
string(14) "ANSI_X3.4-1968"
string(5) "^[yY]"
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.no-windows;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>setlocale</function></member>
<member><function>localeconv</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
-->