com doc/tr: update for sync with English docs.: reference/array/functions/compact.xml reference/array/functions/count.xml reference/array/functions/current.xml reference/array/functions/each.xml reference/array/functions/end.xml reference/array/functions/in-array.xml reference/array/functions/key.xml reference/array/functions/krsort.xml reference/array/functions/ksort.xml reference/array/functions/list.xml reference/array/functions/natcasesort.xm

[email protected] (Nilgün Belma Bugüner) Fri, 12 Mar 2021 20:06:10 +0000
Newsgroups php.doc.tr
Message-ID <[email protected]>
Commit:    612bf73aaf95b5178ab9ae1e11fe2ef683dd5946
Author:    Nilgün Belma Bugüner <[email protected]>         Fri, 12 Mar 2021 23:06:10 +0300
Parents:   0161d713b397ace9ab5020459a3973cd45233f91
Branches:  master

Link:       http://git.php.net/?p=doc/tr.git;a=commitdiff;h=612bf73aaf95b5178ab9ae1e11fe2ef683dd5946

Log:
update for sync with English docs.

Changed paths:
  M  reference/array/functions/compact.xml
  M  reference/array/functions/count.xml
  M  reference/array/functions/current.xml
  M  reference/array/functions/each.xml
  M  reference/array/functions/end.xml
  M  reference/array/functions/in-array.xml
  M  reference/array/functions/key.xml
  M  reference/array/functions/krsort.xml
  M  reference/array/functions/ksort.xml
  M  reference/array/functions/list.xml
  M  reference/array/functions/natcasesort.xml
  M  reference/array/functions/rsort.xml
  M  reference/array/functions/uasort.xml
  M  reference/array/functions/uksort.xml
diff_612bf73aaf95b5178ab9ae1e11fe2ef683dd5946.txt (text/plain, 37.8 KB)
diff --git a/reference/array/functions/compact.xml b/reference/array/functions/compact.xml
index eb01fb4e..06719f7d 100644
--- a/reference/array/functions/compact.xml
+++ b/reference/array/functions/compact.xml
@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.compact" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>compact</refname>
-  <refpurpose>Değişkenlerle değerlerinden oluşan bir dizi oluşturur
+  <refpurpose>Değişkenlerle değerlerinden bir dizi oluşturur
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>compact</methodname>
-   <methodparam><type>mixed</type><parameter>değişken</parameter></methodparam>
-   <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>string</type></type><parameter>değişken</parameter></methodparam>
+   <methodparam rep="repeat"><type class="union"><type>array</type><type>string</type></type><parameter>değişkenler</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Değişkenlerle değerlerinden oluşan bir dizi oluşturur.
+   Değişkenlerle değerlerinden bir dizi oluşturur.
   </para>
   <para>
    <function>compact</function> işlevi, <parameter>değişken</parameter> ile
@@ -24,9 +24,11 @@
    kullanılır. Özetle, <function>extract</function> işlevinin yaptığının
    tersini yapar.
   </para>
-  <para>
-   Tanımsız değişkenler basitçe atlanır.
-  </para>
+  <note>
+   <para>
+    PHP 7.3 öncesinde, değer atanmamış dizgeler sessizce atlanırdı.
+   </para>
+  </note>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -34,6 +36,7 @@
    <variablelist>
     <varlistentry>
      <term><parameter>değişken</parameter></term>
+     <term><parameter>değişkenler</parameter></term>
      <listitem>
       <para>
        <function>compact</function> işlevi bu değiştirgeden sınırsız sayıda
@@ -53,6 +56,39 @@
    Belirtilen değişkenlerin tanımlı olanlarını içeren bir dizi ile döner.
   </para>
  </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+    Belirtilen dizge değer atanmamış bir değişkense <function>compact</function>
+    işlevi <constant>E_NOTICE</constant> seviyesinde bir hata çıktılar.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.3.0</entry>
+      <entry>
+      Belirtilen dizge değer atanmamış bir değişkense
+      <function>compact</function> işlevi <constant>E_NOTICE</constant>
+      seviyesinde bir hata çıktılar. Evvelce, böyle dizgeler sessizce atlanırdı.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -67,7 +103,7 @@ $olay = "UYARI";
 
 $idari_bölümler = array("il", "ilçe");
 
-$sonuç = compact("olay", "hiçbir_şey", $idari_bölümler);
+$sonuç = compact("olay", $idari_bölümler);
 print_r($sonuç);
 ?>
 ]]>
diff --git a/reference/array/functions/count.xml b/reference/array/functions/count.xml
index 5e8b8b52..37a1a0c9 100644
--- a/reference/array/functions/count.xml
+++ b/reference/array/functions/count.xml
@@ -1,28 +1,29 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: bc93886cd1bfeab5f49e8fb7a60786a4dc52246b Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.count" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>count</refname>
-  <refpurpose>Bir dizideki eleman sayısını veya bir nesnedeki özellik sayısını
+  <refpurpose>Bir dizideki eleman sayısını veya bir nesnedeki şeylerin sayısını
   döndürür</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>count</methodname>
-   <methodparam><type>mixed</type><parameter>girdi</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>kip</parameter><initializer>COUNT_NORMAL</initializer></methodparam>
+   <methodparam><type class="union"><type>Countable</type><type>array</type></type><parameter>girdi</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>kip</parameter><initializer><constant>COUNT_NORMAL</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
-   Bir dizideki eleman sayısını veya bir nesnedeki özellik sayısını döndürür.
+   Bir dizideki eleman sayısını veya bir nesnedeki şeylerin sayısını döndürür.
   </para>
   <para>
    Nesneler için, eğer <link linkend="ref.spl">SPL</link> kuruluysa
-   <literal>Countable</literal> tarafından gerçeklenen
-   <function>count</function> yöntemini sonucu almak için kullanabilirsiniz.
-   Nesne arayüzü sadece bir yönteme, <function>count</function> işlevinden
-   dönen değeri döndüren <function>count</function> yöntemine sahiptir.
+   <classname>Countable</classname> tarafından gerçeklenen
+   <methodname>Countable::count</methodname> yöntemini sonucu almak için
+   kullanabilirsiniz. Nesne arayüzü sadece bir yönteme,
+   <function>count</function> işlevinden dönen değeri döndüren
+   <methodname>Countable::count</methodname> yöntemine sahiptir.
   </para>
   <para>
    PHP'de kullanılan dizilerin nasıl gerçeklendiği ile ilgili daha ayrıntılı
@@ -38,7 +39,7 @@
      <term><parameter>girdi</parameter></term>
      <listitem>
       <para>
-       Dizi veya nesne.
+       Dizi veya <classname>Countable</classname> nesnesi.
       </para>
      </listitem>
     </varlistentry>
@@ -53,6 +54,14 @@
        <function>count</function> sonsuz iç içeliği algılayacak yetenekte
        değildir.
       </para>
+      <caution>
+       <para>
+        <function>count</function> işlevi sonsuz döngüden kaçınmak için iç
+        içeliği saptayabilir, fakat bunu her yaptığında (dizinin kendisini
+        birden fazla içerdiği durumda) bir <constant>E_WARNING</constant>
+        çıktılar ve beklenenden daha yüksek bir miktar döndürür.
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -61,48 +70,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Bir dizi dışında her şey tek elemanlı bir dizi kabul edilebileceğinden
-   işlev daima <parameter>girdi</parameter>'deki eleman sayısını döndürür.
-  </para>
-  <para>
-   Eğer <parameter>girdi</parameter> <type>array</type> veya
-   <type>object</type> türünde değilse <literal>Countable</literal> arayüzü,
-   <literal>1</literal> döndürür. Tek istisnası
-   <parameter>girdi</parameter>'nin &null; olması durumu olup böyle bir
-   durumda <literal>0</literal> döner.
-  </para>
-  <caution>
-   <para>
-    <function>count</function> işlevi atanmamış bir değişken için 0
-    döndürebilir, fakat değişken boş bir dizi ile ilklendirilmişse de 0
-    döndürecektir. Değişkenin tanımlı olup olmadığını
-    <function>isset</function> ile sınayabilirsiniz.
-   </para>
-  </caution>
- </refsect1>
- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.2.0</entry>
-       <entry>
-        İsteğe bağlı <parameter>kip</parameter> değiştirgesi eklendi.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
+   <parameter>girdi</parameter>'deki eleman sayısını döndürür.
+   <parameter>girdi</parameter> bir dizi veya <classname>Countable</classname>
+   arayüzü ile gerçeklenmiş bir nesne değilse <literal>1</literal> döner. Tek
+   istisnası <parameter>girdi</parameter>'nin &null; olması durumu olup böyle
+   bir durumda <literal>0</literal> döner.
   </para>
  </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -114,23 +89,32 @@
 $a[0] = 1;
 $a[1] = 3;
 $a[2] = 5;
-$sonuç = count($a);
-// $sonuç == 3
+var_dump(count($a));
 
 $b[0]  = 7;
 $b[5]  = 9;
 $b[10] = 11;
-$sonuç = count($b);
-// $sonuç == 3
+var_dump(count($b));
 
-$sonuç = count(null);
-// $sonuç == 0
+var_dump(count(null));
 
-$sonuç = count(false);
-// $sonuç == 1
+var_dump(count(false));
 ?>
 ]]>
     </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+int(3)
+int(3)
+
+Warning: count(): Parameter must be an array or an object that implements Countable in … on line 12 // PHP 7.2 ve sonrası
+int(0)
+
+Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14 // PHP 7.2 ve sonrası
+int(1)
+]]>
+    </screen>
    </example>
   </para>
   <para>
@@ -154,11 +138,36 @@ echo count($food); // 2
    </example>
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.2.0</entry>
+      <entry>
+       <function>count</function> işlevi <parameter>girdi</parameter>
+       olarak geçersiz sayılabilir türler aktarıldığında artık bir uyarı
+       çıktılamaktadır.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>empty</function></member>
     <member><function>is_array</function></member>
+    <member><function>is_countable</function></member>
     <member><function>isset</function></member>
     <member><function>strlen</function></member>
    </simplelist>
diff --git a/reference/array/functions/current.xml b/reference/array/functions/current.xml
index a2a4841e..35317c43 100644
--- a/reference/array/functions/current.xml
+++ b/reference/array/functions/current.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.current" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>current</refname>
@@ -10,10 +10,10 @@
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>current</methodname>
-   <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter>dizi</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Her dizinin, ilklendirme anında ilk elemanına konumlanan bir göstericisi
+   Her dizinin, ilklendirme anında ilk elemanını konumlayan bir göstericisi
    vardır.
   </para>
  </refsect1>
@@ -41,6 +41,30 @@
   </para>
   &return.falseproblem;
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        <parameter>dizi</parameter> artık daima değeri ile aktarılmaktadır.
+        Evvelce, mümkünse gönderimli değilse değeriyle aktarılırdı.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -73,9 +97,17 @@ var_dump(current($arr)); // array(0) { }
   &reftitle.notes;
   <note>
    <simpara>
-    Bir dizi sonunu <type>boolean</type> &false; değerinden ayıramazsınız.
-    element. &false; değerli elemanlar içeren bir dizide bilinçli olarak
-    ilerlemenin en doğru yolu <function>each</function> kullanmaktır.
+    <function>current</function> işlevini dahili göstericisi öğelerin sonunun
+    ötesini gösteren boş bir dizi ile  çağırmanın sonuçları <type>bool</type>
+    &false; öğesinden ayırt edilemez. &false; elemanlar içerebilecek bir dizide
+    bilinçli olarak ilerlemenin en doğru yolu
+    <link linkend="control-structures.foreach">foreach</link> kullanmaktır.
+   </simpara>
+   <simpara>
+    Yine de <function>current</function> kullanmak ve değerin gerçekten
+    <parameter>dizi</parameter>nin bir öğesi olup olmadığını doğru bir şekilde
+    kontrol etmek için, anahtarın &null; olmadığından kesinlikle emin
+    olunmalıdır.
    </simpara>
   </note>
  </refsect1>
diff --git a/reference/array/functions/each.xml b/reference/array/functions/each.xml
index 01263133..0b83b4fe 100644
--- a/reference/array/functions/each.xml
+++ b/reference/array/functions/each.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.each" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>each</refname>
@@ -11,18 +11,18 @@
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>each</methodname>
-   <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">dizi</parameter></methodparam>
   </methodsynopsis>
   <para>
    Belirtilen diziden, gösterici konumundaki anahtar değer çiftini
-   döndürür ve göstericiyi bir ilerletir.
+   döndürür ve göstericiyi sonraki öğeye ilerletir.
   </para>
   <para>
    <function>each</function> işini bitirdikten sonra dizi göstericisi bir
    sonraki elemana konumlanır; eğer gösterici zaten sonuncu elemandaysa
-   gösterici sonuncudan sonraki olmayan elemana konumlanır. Diziyi baştan
-   taramak isterseniz göstericiyi <function>reset</function> ile dizinin
-   başlangıcına taşımanız gerekir.
+   gösterici sonuncudan sonraki olmayan elemana konumlanır. Dizi baştan
+   taranmak istenirse gösterici <function>reset</function> ile dizinin
+   başlangıcına taşınmalıdır.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -143,7 +143,7 @@ c => cranberry
    <para>
     Bir dizinin bir değişkene atanması özgün dizi göstericisini
     sıfırladığından yukarıdaki örnekte <varname>$fruit</varname> dizisini
-    döngü içinde başka bir değişkene atamamız sonsuz bir döngüye sebep olurdu.
+    döngü içinde başka bir değişkene atamak sonsuz bir döngüye sebep olurdu.
    </para>
   </caution>
   <warning>
diff --git a/reference/array/functions/end.xml b/reference/array/functions/end.xml
index 39cd1d9d..4d26946b 100644
--- a/reference/array/functions/end.xml
+++ b/reference/array/functions/end.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.end" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>end</refname>
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>end</methodname>
-   <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">dizi</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>end</function> işlevi <parameter>dizi</parameter>'nin dahili
@@ -68,6 +68,7 @@ echo end($meyveler); // iğde
     <member><function>prev</function></member>
     <member><function>reset</function></member>
     <member><function>next</function></member>
+    <member><function>array_key_last</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/in-array.xml b/reference/array/functions/in-array.xml
index 3da74de8..81758765 100644
--- a/reference/array/functions/in-array.xml
+++ b/reference/array/functions/in-array.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 68a9c82e06906a5c00e0199307d87dd3739f719b Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.in-array" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>in_array</refname>
@@ -12,10 +12,11 @@
    <type>bool</type><methodname>in_array</methodname>
    <methodparam><type>mixed</type><parameter>iğne</parameter></methodparam>
    <methodparam><type>array</type><parameter>samanlık</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>sıkı</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   <parameter>samanlık</parameter>'ta <parameter>iğne</parameter>'yi' arar.
+   <parameter>sıkı</parameter> &true; olmadıkça gevşek karşılaştırma kullanarak
+   <parameter>samanlık</parameter>'ta <parameter>iğne</parameter>'yi arar.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -45,7 +46,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>türüne_de_bak</parameter></term>
+     <term><parameter>sıkı</parameter></term>
      <listitem>
       <para>
        Bu değiştirgede &true; belirtilmişse <function>in_array</function>
@@ -64,29 +65,6 @@
    <parameter>iğne</parameter> bulunursa &true;, aksi takdirde &false; döner.
   </para>
  </refsect1>
- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.2.0</entry>
-       <entry>
-        <parameter>iğne</parameter> olarak bir dizi belirtilebilir oldu.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -106,9 +84,8 @@ if (in_array("mac", $os)) {
 ]]>
     </programlisting>
     <para>
-     The second condition fails because <function>in_array</function> işlevi
-     harf büyüklüğüne duyarlı olduğundan ikinci koşul başarısız olur ve sonuç
-     şu olur:
+     <function>in_array</function> işlevi harf büyüklüğüne duyarlı olduğundan
+     ikinci koşul başarısız olur ve sonuç şu olur:
     </para>
     <screen>
 <![CDATA[
diff --git a/reference/array/functions/key.xml b/reference/array/functions/key.xml
index 8e2d7cdf..8a648fbc 100644
--- a/reference/array/functions/key.xml
+++ b/reference/array/functions/key.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 755faca201b5ba15e23735f21ed056b47d954398 Maintainer: nilgun Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
 <refentry xml:id="function.key" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,8 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>key</methodname>
-   <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
+   <type class="union"><type>int</type><type>string</type><type>null</type></type><methodname>key</methodname>
+   <methodparam><type class="union"><type>array</type><type>object</type></type><parameter>dizi</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>key</function> işlevi belirtilen diziden göstericinin işaret
@@ -40,6 +40,30 @@
    gösterici son elemandan sonrasını gösteriyorsa &null; döner.
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        <parameter>dizi</parameter> artık daima değeri ile aktarılmaktadır.
+        Evvelce, mümkünse gönderimli değilse değeriyle aktarılırdı.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -58,7 +82,7 @@ $dizi = array(
 // Değeri "elma" olan tüm anahtarları gösterir
 while ($meyve_adı = current($dizi)) {
     if ($meyve_adı == 'elma') {
-        echo key($dizi).'<br />';
+        echo key($dizi). "\n";
     }
     next($dizi);
 }
@@ -82,6 +106,7 @@ meyve5<br />
    <simplelist>
     <member><function>current</function></member>
     <member><function>next</function></member>
+     <member><link linkend="control-structures.foreach">foreach</link></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/krsort.xml b/reference/array/functions/krsort.xml
index 98077990..a53beacf 100644
--- a/reference/array/functions/krsort.xml
+++ b/reference/array/functions/krsort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 2550f62c6a8e60a690a462e9b6eb60e08abcc61f Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.krsort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>krsort</refname>
@@ -11,7 +11,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>krsort</methodname>
    <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>SORT_REGULAR</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Bir diziyi anahtar/değer ilişkisini koruyarak anahtarlarına göre tersine
@@ -30,15 +30,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>seçenekler</parameter></term>
-     <listitem>
-      <para>
-       İsteğe bağlı bu değiştirge ile sıralama türünü değiştirebilirsiniz.
-       Olası seçenekler için <function>sort</function> işlevine bakınız.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/ksort.xml b/reference/array/functions/ksort.xml
index 9e57d884..76b4e890 100644
--- a/reference/array/functions/ksort.xml
+++ b/reference/array/functions/ksort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 2550f62c6a8e60a690a462e9b6eb60e08abcc61f Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.ksort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ksort</refname>
@@ -11,7 +11,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>ksort</methodname>
    <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>SORT_REGULAR</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Bir diziyi anahtar/değer ilişkisini koruyarak anahtarlarına göre sıralar.
@@ -30,15 +30,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>seçenekler</parameter></term>
-     <listitem>
-      <para>
-       İsteğe bağlı bu değiştirge ile sıralama türünü değiştirebilirsiniz.
-       Olası seçenekler için <function>sort</function> işlevine bakınız.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/list.xml b/reference/array/functions/list.xml
index d79bcdfb..48f68123 100644
--- a/reference/array/functions/list.xml
+++ b/reference/array/functions/list.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.list" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>list</refname>
@@ -11,13 +11,35 @@
   <methodsynopsis>
    <type>array</type><methodname>list</methodname>
    <methodparam><type>mixed</type><parameter>değişken</parameter></methodparam>
-   <methodparam rep="repeat" choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
+   <methodparam rep="repeat" choice="opt"><type>mixed</type><parameter>değişkenler</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>array</function> gibi bu da bir işlev değil bir dil oluşumudur.
    <function>list</function> işlevi tek deyimde birden fazla değişkene atama
    yapmak için kullanılır.
   </para>
+  <note>
+   <para>
+    PHP 7.1.0 öncesinde, <function>list</function> işlevi sadece sayısal
+    dizilerde çalışır ve indislerin sıfırdan başladığı varsayılırdı.
+   </para>
+  </note>
+  <warning>
+   <para>
+    PHP 5'te, <function>list</function> işlevi değerleri atamaya en sağdaki
+    değiştirgeyle başlardı.  PHP 7'de, ise en soldaki değiştirge ile başlar.
+   </para>
+   <para>
+    Sıradan değişkenlerle çalışılıyorsa bundan endişe duymak gerekmez.
+    Ancak indisli diziler kullanılıyorsa, indislerin işlenme sırasının
+    <function>list</function> işlevinde yazıldığı gibi soldan sağa olacağı
+    umulursa da PHP 5'te işlenme sırası sağdan soladır.
+   </para>
+   <para>
+    Genel olarak, işlemin sırasına güvenmek önerilmez, çünkü gelecekte yine
+    değişebilir.
+   </para>
+  </warning>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -27,7 +49,15 @@
      <term><parameter>değişken</parameter></term>
      <listitem>
       <para>
-       Bir değişken.
+       Değişken.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>değişkenler</parameter></term>
+     <listitem>
+      <para>
+       Diğer değişkenler.
       </para>
      </listitem>
     </varlistentry>
@@ -40,6 +70,53 @@
    Atanan dizi döner.
   </para>
  </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.3.0</entry>
+       <entry>Dizi bozmada gönderim atamaları için destek eklendi.</entry>
+      </row>
+      <row>
+       <entry>7.1.0</entry>
+       <entry>
+        <function>list</function> işlevine anahtarlar belirtilebiliyor.
+        Bu, tamsayı olmayan veya sıralı olmayan anahtarlarla dizilerin
+        yok edilmesini sağlar.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Atama işlemlerinin gerçekleştirilme sırası değişti.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        <function>list</function> ifadeleri artık tamamen boş olamıyor.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Dizeler artık patlatılmıyor.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -84,11 +161,11 @@ var_dump($bar); // NULL
 
 <?php
 
-$sonuç = mysql_query("SELECT id, ad, ucret FROM personel", $conn);
-while (list($id, $ad, $ücret) = mysql_fetch_row($sonuç)) {
+$sonuç = $pdo->query("SELECT id, ad, ucret FROM personel");
+while (list($id, $ad, $ücret) = $result->fetch(PDO::FETCH_NUM)) {
     echo " <tr>\n" .
           "  <td><a href=\"info.php?id=$id\">$ad</a></td>\n" .
-          "  <td>$ücret</td>\n" .
+          "  <td>$ucret</td>\n" .
           " </tr>\n";
 }
 
@@ -142,6 +219,20 @@ var_dump($a);
      Aşağıdaki çıktıyı verir (dikkatı ederseniz, eleman sırası
      <function>list</function> ile belirtilen sıra ile aynıdır):
     </para>
+    &example.outputs.7;
+    <screen>
+<![CDATA[
+array(3) {
+  [0]=>
+  string(5) "kahve"
+  [1]=>
+  string(4) "uyku"
+  [2]=>
+  string(6) "kafein"
+}
+]]>
+    </screen>
+    &example.outputs.5;
     <screen>
 <![CDATA[
 array(3) {
@@ -156,24 +247,79 @@ array(3) {
     </screen>
    </example>
   </para>
- </refsect1>
- <refsect1 role="notes">
-  &reftitle.notes;
-  <warning>
-   <para>
-    <function>list</function> değerleri en sağdaki değiştirgeden itibaren
-    atar. Düz değişken kullanıyorsanız bundan dolayı endişelenmeniz gerekmez.
-    Fakat indisli diziler kullanıyorsanız, dizi indislerinin,
-    <function>list</function>'teki yazılış sırasına göre soldan sağa
-    sıralanacağını düşünürsünüz. Fakat atama sağdan sola doğru  yapılır.
-   </para>
-  </warning>
-  <note>
-   <para>
-    <function>list</function> sadece sayısal indisli dizilerle çalışır ve
-    indislerin 0'dan başladığı varsayılır.
-   </para>
-  </note>
+  <para>
+   <example>
+    <title>- <function>list</function> ve indis tanımlarının sırası</title>
+    <simpara>
+     <function>list</function> tarafından tüketilecek dizi indislerinin
+     tanımlanma sırası konu dışıdır.
+    </simpara>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$foo = array(2 => 'a', 'foo' => 'b', 0 => 'c');
+$foo[1] = 'd';
+list($x, $y, $z) = $foo;
+var_dump($foo, $x, $y, $z);
+]]>
+    </programlisting>
+    <para>
+     Çıktısı aşağıdadır (elemanlar <function>list</function> sözdiziminde yazıldıkları gibi sıralanmıştır):
+    </para>
+    <screen>
+<![CDATA[
+array(4) {
+  [2]=>
+  string(1) "a"
+  ["foo"]=>
+  string(1) "b"
+  [0]=>
+  string(1) "c"
+  [1]=>
+  string(1) "d"
+}
+string(1) "c"
+string(1) "d"
+string(1) "a"
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>- Anahtarlar ve <function>list</function></title>
+    <simpara>
+     PHP 7.1.0 itibariyle, <function>list</function> artık rasgele ifadeler
+     halinde verilebilecek belirgin anahtarlar da içerebilir. Tamsayı ve dize
+     anahtarlarının karıştırılmasına izin verilir; ancak, anahtarı olan ve
+     olmayan öğeler karıştırılamaz.
+    </simpara>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$data = [
+    ["id" => 1, "name" => 'Tom'],
+    ["id" => 2, "name" => 'Fred'],
+];
+foreach ($data as ["id" => $id, "name" => $name]) {
+    echo "id: $id, name: $name\n";
+}
+echo PHP_EOL;
+list(1 => $second, 3 => $fourth) = [1, 2, 3, 4];
+echo "$second, $fourth\n";
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+id: 1, name: Tom
+id: 2, name: Fred
+
+2, 4
+]]>
+    </screen>
+   </example>
+  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/array/functions/natcasesort.xml b/reference/array/functions/natcasesort.xml
index 861a7a31..32be158c 100644
--- a/reference/array/functions/natcasesort.xml
+++ b/reference/array/functions/natcasesort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 32952c4ddc71070da5c2e0344ef50f5afef08ae1 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.natcasesort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>natcasesort</refname>
@@ -23,6 +23,7 @@
    kullanarak sıralar. Bu algoritmaya "doğal sıralama" algoritması adı
    verilir.
   </para>
+   &note.sort-unstable;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
diff --git a/reference/array/functions/rsort.xml b/reference/array/functions/rsort.xml
index 47159345..6d762f47 100644
--- a/reference/array/functions/rsort.xml
+++ b/reference/array/functions/rsort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 2550f62c6a8e60a690a462e9b6eb60e08abcc61f Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.rsort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>rsort</refname>
@@ -11,7 +11,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>rsort</methodname>
    <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>SORT_REGULAR</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Bu işlev belirtilen diziyi tersine (büyükten küçüğe) sıralar.
@@ -29,16 +29,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>seçenekler</parameter></term>
-     <listitem>
-      <para>
-       Bu değiştirge ile sıralamayı değiştirebilirsiniz. Bu değiştirgede
-       belirtilebilecek değerler için <function>sort</function> işlevine
-       bakınız.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>
diff --git a/reference/array/functions/uasort.xml b/reference/array/functions/uasort.xml
index 41b33b76..25a7227b 100644
--- a/reference/array/functions/uasort.xml
+++ b/reference/array/functions/uasort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.uasort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>uasort</refname>
@@ -13,7 +13,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>uasort</methodname>
    <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
-   <methodparam><type>callback</type><parameter>karş_işlevi</parameter></methodparam>
+   <methodparam><type>callable</type><parameter>karş_işlevi</parameter></methodparam>
   </methodsynopsis>
   <para>
    Bu işlev kullanıcı tarafından sağlanmış bir karşılaştırma işlevini
@@ -42,7 +42,7 @@
      <term><parameter>karş_işlevi</parameter></term>
      <listitem>
       <para>
-       Kullanıcı tanamlı karşılaştırma işlevi örnekleri için
+       Kullanıcı tanımlı karşılaştırma işlevi örnekleri için
        <function>usort</function> ve <function>uksort</function>
        işlevlerine bakınız.
       </para>
diff --git a/reference/array/functions/uksort.xml b/reference/array/functions/uksort.xml
index d433ea08..c78a4e93 100644
--- a/reference/array/functions/uksort.xml
+++ b/reference/array/functions/uksort.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.uksort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>uksort</refname>
@@ -12,7 +12,7 @@
   <methodsynopsis>
    <type>bool</type><methodname>uksort</methodname>
    <methodparam><type>array</type><parameter role="reference">dizi</parameter></methodparam>
-   <methodparam><type>callback</type><parameter>karş_işlevi</parameter></methodparam>
+   <methodparam><type>callable</type><parameter>karş_işlevi</parameter></methodparam>
   </methodsynopsis>
   <para>
    Bu işlev kullanıcı tarafından sağlanmış bir karşılaştırma işlevini
@@ -20,6 +20,7 @@
    mevcut kuralların dışında bir kurala göre sıralamak isterseniz bu işlev çok
    işe yarar.
   </para>
+  &note.sort-unstable;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -37,14 +38,9 @@
      <term><parameter>karş_işlevi</parameter></term>
      <listitem>
       <para>
-       Karşılaştırma için geriçağırım işlevi.
-      </para>
-      <para>
-       <parameter>karş_işlevi</parameter> dizi anahtarlarının aktarılacağı iki
-       değiştirge kabul etmelidir. Birinci değiştirgenin ikinciden büyük,
-       küçük veya ona eşit olduğu durumlarda sırayla sıfırdan büyük, sıfırdan
-       küçük bir değer veya sıfır döndürmelidir.
+       &return.callbacksort;
       </para>
+      &callback.cmp;
      </listitem>
     </varlistentry>
    </variablelist>