construct.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="collator.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>Collator::__construct</refname>
  <refpurpose>Создаёт новый экземпляр Collator</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <constructorsynopsis role="Collator">
   <modifier>public</modifier> <methodname>Collator::__construct</methodname>
   <methodparam><type>string</type><parameter>locale</parameter></methodparam>
  </constructorsynopsis>
  <para>
   Создаёт новый экземпляр <classname>Collator</classname>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>locale</parameter></term>
     <listitem>
      <para>
       Локаль, правила сопоставления которой следует использовать. Могут быть переданы специальные значения
       для языковых стандартов - если для языкового стандарта передана пустая строка (&string;),
       будут использоваться правила сопоставления языкового стандарта по умолчанию.
       Если передано значение <literal>"root"</literal>, будут использоваться правила <link xlink:href="&url.icu.uca;">UCA</link>.
      </para>
      <para>
       Атрибут <parameter>locale</parameter> обычно является наиболее важным атрибутом для
       правильной сортировки и сопоставления в соответствии с ожиданиями пользователей
       в разных странах и регионах. По умолчанию порядок сортировки <link xlink:href="&url.icu.uca;">UCA</link>
       будет правильно отсортировать только несколько языков, таких как голландский и португальский
       ("правильно" означает в соответствии с обычными ожиданиями пользователей этих языков).
       В противном случае вам необходимо указать локаль в UCA, чтобы правильно сопоставить текст для данного языка.
       Таким образом, необходимо указать языковой стандарт, чтобы выбрать Collator,
       который правильно адаптирован для этого языкового стандарта. Выбор языкового стандарта автоматически
       устанавливает значения для всех атрибутов на то, что подходит для этого языкового стандарта.
       Таким образом, в большинстве случаев другие атрибуты не нужно явно указывать.
       В некоторых случаях выбор локали будет иметь значение для производительности сравнения строк
       и/или длины ключа сортировки.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Возвращает "пустой" объект в случае возникновения ошибки.
   Используйте
   <function>intl_get_error_code</function>
   и/или
   <function>intl_get_error_message</function>,
   чтобы узнать что произошло.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Пример использования <function>Collator::__construct</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$coll = new Collator('en_CA');
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>Collator::create</function></member>
    <member><function>collator_create</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
-->