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>
+ ¬e.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>
+ ¬e.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>