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

From: Date: Fri, 12 Mar 2021 20:06:10 +0000
Subject: 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
Groups: php.doc.tr 
Request: Send a blank email to doc-tr+get-2601@lists.php.net to get a copy of this message
Commit: 612bf73aaf95b5178ab9ae1e11fe2ef683dd5946 Author: Nilgün Belma Bugüner <nilgun@php.net> 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 --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>
« previous php.doc.tr (#2601) next »