locale.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1f68eecaa7c4c723abe72a5a040ea7b15023a5aa Maintainer: takagi Status: ready -->
<reference xml:id="class.locale" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>Locale クラス</title>
 <titleabbrev>Locale</titleabbrev>

 <partintro>

  <!-- {{{ Locale intro -->
  <section xml:id="locale.intro">
   &reftitle.intro;
   <simpara>
    "ロケール" とは、言語や文化等の地域固有の内容を API
    で取得する際に使用する識別子のことです。PHP で使用しているロケールは、
    ICU (そして他の多くの Unix 系 OS や Mac、Java など)
    が採用している CLDR ロケールと同じです。
    ロケールは、RFC 4646 形式の言語タグ (アンダースコアではなくハイフンを使用したもの)
    を使用します。古くから用いられているアンダースコア形式の識別子も使用できます。
    特にことわりがない限り、このクラスの関数では両方の形式の識別子を使用可能です。
   </simpara>
   <para>
    識別子の例を以下にあげます。
    <simplelist>
     <member>en-US (英語、米国)</member>
     <member>zh-Hant-TW (中国語、繁体字、台湾 )</member>
     <member>fr-CA, fr-FR (それぞれ、カナダのフランス語とフランスのフランス語)</member>
    </simplelist>
   </para>
   <simpara>
    Locale クラス (そしてそれに対応する手続き型の関数)
    を使用して、ロケール識別子に対する操作を行います。
    たとえばその識別子が妥当な形式かどうかを調べたりします。
    CLDR が UAX #35 で使用している (そして ICU も継承している)
    拡張は、ICU で普通に用いることができます。
   </simpara>
   <simpara>
    Locale クラスのインスタンスを作成することはできません。
    すべての関数/メソッドは :: を付けて呼び出します。
   </simpara>
   <simpara>
    null や空文字列は "root" ロケールとなります。
    この "root" ロケールは、CLDR においては
    "en_US_POSIX" と同じ意味になります。言語タグ (そして
    ロケール識別子) は大文字小文字を区別しません。
    仕様にあわせて大文字小文字の正規化を行う関数が存在します。
   </simpara>
  </section>
  <!-- }}} -->

  <section xml:id="locale.synopsis">
   &reftitle.classsynopsis;

   <!-- {{{ Synopsis -->
   <classsynopsis class="class">
    <ooclass>
     <classname>Locale</classname>
    </ooclass>

    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="locale.constants.actual-locale">Locale::ACTUAL_LOCALE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="locale.constants.valid-locale">Locale::VALID_LOCALE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>null</type>
     <varname linkend="locale.constants.default-locale">Locale::DEFAULT_LOCALE</varname>
     <initializer>null</initializer>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.lang-tag">Locale::LANG_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.extlang-tag">Locale::EXTLANG_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.script-tag">Locale::SCRIPT_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.region-tag">Locale::REGION_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.variant-tag">Locale::VARIANT_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.grandfathered-lang-tag">Locale::GRANDFATHERED_LANG_TAG</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>string</type>
     <varname linkend="locale.constants.private-tag">Locale::PRIVATE_TAG</varname>
    </fieldsynopsis>

    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.locale')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Locale'])">
     <xi:fallback/>
    </xi:include>
   </classsynopsis>
   <!-- }}} -->

  </section>

  <!-- {{{ Locale properties
   <section xml:id="locale.props">
   &reftitle.properties;
   <variablelist>
   <varlistentry xml:id="locale.props.name">
   <term><varname>name</varname></term>
   <listitem>
   <para>Prop description</para>
   </listitem>
   </varlistentry>
   </variablelist>
   </section>
   }}} -->

  &reference.intl.locale-constants;
  <section xml:id="locale.seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
     <member>
      <link xlink:href="&url.rfc;4646">RFC 4646 - Tags for Identifying Languages</link>
     </member>
     <member>
      <link xlink:href="&url.rfc;4647">RFC 4647 - Matching of Language Tags</link>
     </member>
     <member>
      <link xlink:href="&url.cldr.locale;">Unicode CLDR Project:Common Locale Data Repository</link>
     </member>
     <member>
      <link xlink:href="&url.iana.locale.subtags;">IANA Language Subtags Registry</link>
     </member>
     <member>
      <link xlink:href="&url.icu.locale.guide;">ICU User Guide - Locale</link>
     </member>
     <member>
      <link xlink:href="&url.icu.locale.api;">ICU Locale api</link>
     </member>
    </simplelist>
   </para>
  </section>

  <section role="changelog">
   &reftitle.changelog;
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.4.0</entry>
       <entry>
        クラス定数が型付けされました。
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </section>
 </partintro>

 &reference.intl.entities.locale;

</reference>
<!-- 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
-->