setlocale.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 54ff7bf8e0f8fa90988cccf6b583517366605f6d Maintainer: nilgun Status: ready -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
 <refnamediv>
  <refname>setlocale</refname>
  <refpurpose>Yereli ayarlar</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
   <methodparam><type>int</type><parameter>sınıf</parameter></methodparam>
   <methodparam><type>string</type><parameter>yereller</parameter></methodparam>
   <methodparam rep="repeat"><type>string</type><parameter>kalan</parameter></methodparam>
   </methodsynopsis>
  <simpara>İsimli bağımsız değişkenleri desteklemeyen sözdizimi:</simpara>
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
   <methodparam><type>int</type><parameter>sınıf</parameter></methodparam>
   <methodparam><type>array</type><parameter>yerel_dizisi</parameter></methodparam>
  </methodsynopsis>
  <para>
   Yerel bilgisini ayarlar.
  </para>
  <warning>
   <para>
    Evre başına değil süreç başına yerel bilgisi ayarlanır. Çok evreli bir
    sunucu çalıştırıyorsanız, betiğinizde <function>setlocale</function>
    işlevini hiç çağırmadığınız halde yerel ayarlarında ani değişiklikler
    olduğunu gözlemlemişsinizdir. Bunun sebebi aynı anda aynı süreç altında
    başka evrelerde başka betiklerin çalışması ve  bunların süreç genelinde
    geçerli olan <function>setlocale</function> kullanımlarıdır. Windows
    üzerinde PHP 7.0.5 itibariyle yerel bilgisi evre başına sağlanmaktadır.
   </para>
  </warning>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>sınıf</parameter></term>
     <listitem>
      <para>
       <parameter>sınıf</parameter> olarak yerel ayarıyla ilgili belli bir
       işlevsellik belirten şu sabitlerden biri belirtilebilir:
       <itemizedlist>
        <listitem>
         <simpara>
          <constant>LC_ALL</constant> - aşağıdakilerin hepsi.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_COLLATE</constant> - dizge karşılaştırması için;
          <function>strcoll</function> işlevine bakınız.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_CTYPE</constant> - karakter sınıflaması ve dönüşümü
          için; bkz: <function>ctype_alpha</function>
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_MONETARY</constant> - Para biçemlemesi için; bkz,
          <function>localeconv</function>.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_NUMERIC</constant> - ondalık ayraçlar için; bkz,
          <function>localeconv</function>.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_TIME</constant> - tarih ve saat biçemlemesi için; bkz,
          <function>strftime</function>
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>LC_MESSAGES</constant> - sistem iletileri için (PHP
          <literal>libintl</literal> ile derlendiği takdirde kullanılabilir).
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>yereller</parameter></term>
     <listitem>
      <para>
       Eğer<literal>""</literal> şeklinde boş bir
       dizge belirtilmişse, yerel isimleri yukarıdaki sınıflarla aynı isimdeki
       ortam değişkenlerinden veya "<constant>LANG</constant>" ortam
       değişkeninden alınır.
      </para>
      <para>
       Eğer <parameter>yereller</parameter> <literal>"0"</literal> ise,
       yerel ayarı değiştirilmeden mevcut ayar döndürülür.
      </para>
      <para>
       Eğer <parameter>yereller</parameter> için birden fazla bağımsız değişken
       belirtilmişse, yeni yerel başarıyla ayarlanana kadar belirtilen her
       bağımsız değişken tek tek denenir. Yerel isimlerinin
       farklı sistemlerde farklı isimlerde bulunması durumunda veya
       kullanılabilir yerelin bulunamaması olasılığına karşı son çareleri
       belirtmek için kullanılır.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>kalan</parameter></term>
     <listitem>
      <para>
       Yerel ayarları başarılı olana kadar denenecek seçimlik dizge
       bağımsız değişkenler.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>yerel_dizisi</parameter></term>
      <listitem>
       <para>
        Yeni yerel başarıyla ayarlanana kadar belirtilen her dizi elemanı
        tek tek denenir. Yerel isimlerinin farklı sistemlerde farklı isimlerde
        bulunması durumunda veya kullanılabilir yerelin bulunamaması olasılığına
        karşı son çareleri belirtmek için kullanılır.
       </para>
      </listitem>
     </varlistentry>
   </variablelist>
   <note><para>
    Windows'ta, setlocale(LC_ALL, '') kullanımında,  sistemin bölgesel
    ayarlar/dil ayarlarında (Denetim Masasından erişilebilir) belirtilmiş
    yerelin ismi kullanılır.
   </para></note>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Ayarlama yapılabilmişse yeni yerel ismi, platformunuzda yereller işlevsel
   değilse, belirtilen yerel yoksa veya sınıf ismi geçersizse &false; döner.
  </para>
  <para>
   Geçersiz bir sınıf ismi ayrıca bir uyarı üretilmesine sebep olur. Sınıf ve
   yerel isimleri <link xlink:href="&url.rfc;1766">RFC 1766</link>
   ve <link xlink:href="&url.iso-639;">ISO 639</link>'da bulunabilir. Farklı
   sistemler yereller için farklı isimleme şemaları kullanırlar.
  </para>
  <note>
   <para>
    <function>setlocale</function> işlevinin dönüş değeri
    PHP'nin üzerinde çalıştığı sisteme bağlıdır. Sistemin
    <literal>setlocale</literal> işlevinin döndürdüğü değeri döndürür.
   </para>
  </note>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>setlocale</function> örnekleri</title>
    <programlisting role="php">
<![CDATA[
<?php
// Yereli Türkçe yapalım
setlocale(LC_ALL, 'tr_TR.UTF-8');

// Çıktısı: 22 Aralık 1978 Cuma
echo strftime("%e %B %Y %A\n", mktime(0, 0, 0, 12, 22, 1978));

// Türkçe için farklı yerel isimleri deneyelim
$loc_tr = setlocale(LC_ALL, 'tr_TR.UTF-8', 'tr_TR', 'tr', 'turkish');
echo "Türkçe için tercih edilen yerel ismi: '$loc_tr\n'";
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>- Windows için <function>setlocale</function> örnekleri</title>
    <programlisting role="php">
<![CDATA[
<?php
// Yereli Felemenkçe yapalım
setlocale(LC_ALL, 'nld_nld');

// Çıktısı: vrijdag 22 december 1978
echo strftime("%A %d %B %Y", mktime(0, 0, 0, 12, 22, 1978));

// Almanca için farklı yerel isimleri deneyelim
$loc_de = setlocale(LC_ALL, 'de_DE@euro', 'de_DE', 'deu_deu');
echo "Almanca için tercih edilen yerel ismi: '$loc_de'";
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <tip>
   <para>
    Windows kullanıcıları Microsoft'un <acronym>MSDN</acronym> sitesinde
    <parameter>yereller</parameter> dizgeleri hakkında bilgi bulabilirler.
    Desteklenen dil dizgeleri <link xlink:href="&url.setlocale.lang.win32;">
    &url.setlocale.lang.win32;</link> adresinde desteklenen ülke/bölge
    dizgeleri ise <link xlink:href="&url.setlocale.country.win32;">
    &url.setlocale.country.win32;</link> adresinde bulunabilir.
   </para>
  </tip>
 </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
-->