nl-langinfo.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bdef726773ce9f624da7958009367d607d7211ea Maintainer: shimooka Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<refentry xml:id="function.nl-langinfo" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>nl_langinfo</refname>
  <refpurpose>言語およびロケール情報を検索する</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>
   はロケールカテゴリの独立した要素にアクセスするために使用されます。
   <function>localeconv</function> と異なり、全ての要素を返します。
   <function>nl_langinfo</function> はいかなる特定要素も取得可能です。
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>item</parameter></term>
     <listitem>
      <para>
       <parameter>item</parameter> は要素の整数値、もしくは要素の定数名です。
       以下は、使用される <parameter>item</parameter>
       に対する定数名と説明の一覧です。
       これらの定数のいくつかは特定のロケールに対して未定義、
       もしくは値がありません。
       <table>
        <title>nl_langinfo 定数</title>
        <tgroup cols="2">
         <colspec colname="c1"/>
         <colspec colname="c2"/>
         <thead>
          <row>
           <entry>定数</entry>
           <entry>説明</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry namest="c1" nameend="c2" align="center"><emphasis><constant>LC_TIME</constant> カテゴリの定数</emphasis></entry>
          </row>
          <row>
           <entry><constant>ABDAY_<replaceable>(1-7)</replaceable></constant></entry>
           <entry>一週間中の n 番目の曜日名の略式表記</entry>
          </row>
          <row>
           <entry><constant>DAY_<replaceable>(1-7)</replaceable></constant></entry>
           <entry>一週間中の n 番目の曜日名 (DAY_1 = 日曜日)</entry>
          </row>
          <row>
           <entry><constant>ABMON_<replaceable>(1-12)</replaceable></constant></entry>
           <entry>n 番目の月の名前の略式表記</entry>
          </row>
          <row>
           <entry><constant>MON_<replaceable>(1-12)</replaceable></constant></entry>
           <entry>n 番目の月の名前</entry>
          </row>
          <row>
           <entry><constant>AM_STR</constant></entry>
           <entry>午前を表す文字列</entry>
          </row>
          <row>
           <entry><constant>PM_STR</constant></entry>
           <entry>午後を表す文字列</entry>
          </row>
          <row>
           <entry><constant>D_T_FMT</constant></entry>
           <entry><function>strftime</function> で日時を表すためのフォーマット文字列として使用することが可能な文字列</entry>
          </row>
          <row>
           <entry><constant>D_FMT</constant></entry>
           <entry><function>strftime</function> で日付を表すためのフォーマット文字列として使用することが可能な文字列</entry>
          </row>
          <row>
           <entry><constant>T_FMT</constant></entry>
           <entry><function>strftime</function> で時刻を表すためのフォーマット文字列として使用することが可能な文字列</entry>
          </row>
          <row>
           <entry><constant>T_FMT_AMPM</constant></entry>
           <entry><function>strftime</function> でAM/PM付き 12 時間表記を表すためのフォーマット文字列として使用することが可能な文字列</entry>
          </row>
          <row>
           <entry><constant>ERA</constant></entry>
           <entry>ロケール固有の元号付きフォーマット</entry>
          </row>
          <row>
           <entry><constant>ERA_YEAR</constant></entry>
           <entry>ロケール固有の元号付きフォーマットでの年</entry>
          </row>
          <row>
           <entry><constant>ERA_D_T_FMT</constant></entry>
           <entry>ロケール固有の元号付きフォーマットでの日時 (<function>strftime</function> で使用可能な文字列)</entry>
          </row>
          <row>
           <entry><constant>ERA_D_FMT</constant></entry>
           <entry>ロケール固有の元号付きフォーマットでの日付 (<function>strftime</function> で使用可能な文字列)</entry>
          </row>
          <row>
           <entry><constant>ERA_T_FMT</constant></entry>
           <entry>ロケール固有の元号付きフォーマットでの時刻 (<function>strftime</function> で使用可能な文字列)</entry>
          </row>
          <row>
           <entry namest="c1" nameend="c2" align="center"><emphasis><constant>LC_MONETARY</constant> カテゴリの定数</emphasis></entry>
          </row>
          <row>
           <entry><constant>INT_CURR_SYMBOL</constant></entry>
           <entry>国際通貨記号</entry>
          </row>
          <row>
           <entry><constant>CURRENCY_SYMBOL</constant></entry>
           <entry>地域通貨記号</entry>
          </row>
          <row>
           <entry><constant>CRNCYSTR</constant></entry>
           <entry><constant>CURRENCY_SYMBOL</constant> と同じ値</entry>
          </row>
          <row>
           <entry><constant>MON_DECIMAL_POINT</constant></entry>
           <entry>小数点文字</entry>
          </row>
          <row>
           <entry><constant>MON_THOUSANDS_SEP</constant></entry>
           <entry>1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字</entry>
          </row>
          <row>
           <entry><constant>MON_GROUPING</constant></entry>
           <entry>'grouping' と同じ</entry>
          </row>
          <row>
           <entry><constant>POSITIVE_SIGN</constant></entry>
           <entry>正値の表示に使用される記号</entry>
          </row>
          <row>
           <entry><constant>NEGATIVE_SIGN</constant></entry>
           <entry>負値の表示に使用される記号</entry>
          </row>
          <row>
           <entry><constant>INT_FRAC_DIGITS</constant></entry>
           <entry>国際的な方法で表現する際の小数点以下の桁数</entry>
          </row>
          <row>
           <entry><constant>FRAC_DIGITS</constant></entry>
           <entry>地域的な方法で表現する際の小数点以下の桁数</entry>
          </row>
          <row>
           <entry><constant>P_CS_PRECEDES</constant></entry>
           <entry><constant>CURRENCY_SYMBOL</constant> の前に正値がある場合 1 を返す</entry>
          </row>
          <row>
           <entry><constant>P_SEP_BY_SPACE</constant></entry>
           <entry><constant>CURRENCY_SYMBOL</constant> と正値がスペースで区切られる場合 1 を返す</entry>
          </row>
          <row>
           <entry><constant>N_CS_PRECEDES</constant></entry>
           <entry><constant>CURRENCY_SYMBOL</constant> の前に負値がある場合 1 を返す</entry>
          </row>
          <row>
           <entry><constant>N_SEP_BY_SPACE</constant></entry>
           <entry><constant>CURRENCY_SYMBOL</constant> と負値がスペースで区切られる場合 1 を返す</entry>
          </row>
          <row>
           <entry><constant>P_SIGN_POSN</constant></entry>
           <entry morerows="1" valign="middle">
            <itemizedlist>
             <listitem>
              <simpara>
               量および <constant>CURRENCY_SYMBOL</constant> を括弧で括る場合、0 を返す
              </simpara>
             </listitem>
             <listitem>
              <simpara>
               量および <constant>CURRENCY_SYMBOL</constant> の前に符号文字列を置く場合、1 を返す
              </simpara>
             </listitem>
             <listitem>
              <simpara>
               量および <constant>CURRENCY_SYMBOL</constant> の後に符号文字列を置く場合、2 を返す
              </simpara>
             </listitem>
             <listitem>
              <simpara>
               <constant>CURRENCY_SYMBOL</constant> の直前に符号文字列を置く場合、3 を返す
              </simpara>
             </listitem>
             <listitem>
              <simpara>
               <constant>CURRENCY_SYMBOL</constant> の直後に符号文字列を置く場合、4 を返す
              </simpara>
             </listitem>
            </itemizedlist>
           </entry>
          </row>
          <row>
           <entry><constant>N_SIGN_POSN</constant></entry>
          </row>
          <row>
           <entry namest="c1" nameend="c2" align="center"><emphasis><constant>LC_NUMERIC</constant> カテゴリの定数</emphasis></entry>
          </row>
          <row>
           <entry><constant>DECIMAL_POINT</constant></entry>
           <entry>小数点文字</entry>
          </row>
          <row>
           <entry><constant>RADIXCHAR</constant></entry>
           <entry><constant>DECIMAL_POINT</constant> と同じ値</entry>
          </row>
          <row>
           <entry><constant>THOUSANDS_SEP</constant></entry>
           <entry>1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字</entry>
          </row>
          <row>
           <entry><constant>THOUSEP</constant></entry>
           <entry><constant>THOUSANDS_SEP</constant> と同じ値</entry>
          </row>
          <row>
           <entry><constant>GROUPING</constant></entry>
           <entry/>
          </row>
          <row>
           <entry namest="c1" nameend="c2" align="center"><emphasis><constant>LC_MESSAGES</constant> カテゴリの定数</emphasis></entry>
          </row>
          <row>
           <entry><constant>YESEXPR</constant></entry>
           <entry><literal>"はい"</literal> の入力にマッチさせるための正規表現</entry>
          </row>
          <row>
           <entry><constant>NOEXPR</constant></entry>
           <entry><literal>"いいえ"</literal> の入力にマッチさせるための正規表現</entry>
          </row>
          <row>
           <entry><constant>YESSTR</constant></entry>
           <entry><literal>"はい"</literal> のための出力文字列</entry>
          </row>
          <row>
           <entry><constant>NOSTR</constant></entry>
           <entry><literal>"いいえ"</literal> のための出力文字列</entry>
          </row>
          <row>
           <entry namest="c1" nameend="c2" align="center"><emphasis><constant>LC_CTYPE</constant> カテゴリの定数</emphasis></entry>
          </row>
          <row>
           <entry><constant>CODESET</constant></entry>
           <entry>文字エンコーディング名の文字列を返す</entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   要素を文字列で返します。<parameter>item</parameter>
   が有効でない場合は &false; を返します。
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><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
-->