com doc/tr: new translation: reference/array/functions/array-column.xml reference/array/functions/array-key-first.xml reference/array/functions/array-key-last.xml reference/array/functions/key-exists.xml

[email protected] (Nilgün Belma Bugüner) Mon, 15 Mar 2021 05:25:00 +0000
Newsgroups php.doc.tr
Message-ID <[email protected]>
Commit:    b67e38b421c980b162a1b8563cc3822c2a7e6249
Author:    Nilgün Belma Bugüner <[email protected]>         Mon, 15 Mar 2021 08:25:00 +0300
Parents:   8dd7445c3f83303556f5e9f507836eacacc1abc1
Branches:  master

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

Log:
new translation

Changed paths:
  A  reference/array/functions/array-column.xml
  A  reference/array/functions/array-key-first.xml
  A  reference/array/functions/array-key-last.xml
  A  reference/array/functions/key-exists.xml
diff_b67e38b421c980b162a1b8563cc3822c2a7e6249.txt (text/plain, 15.2 KB)
diff --git a/reference/array/functions/array-column.xml b/reference/array/functions/array-column.xml
new file mode 100644
index 00000000..6267ad16
--- /dev/null
+++ b/reference/array/functions/array-column.xml
@@ -0,0 +1,317 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 67268fc2685dbe8f8928571c1da4571ff4e1b6cb Maintainer: nilgun Status: ready -->
+<refentry xml:id="function.array-column" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>array_column</refname>
+  <refpurpose>Dizinin bir sütunundaki değerlerle döner</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>array_column</methodname>
+   <methodparam><type>array</type><parameter>dizi</parameter></methodparam>
+   <methodparam><type class="union"><type>int</type><type>string</type><type>null</type></type><parameter>sütun_anh</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>string</type><type>null</type></type><parameter>indis</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>array_column</function> işlevi <parameter>dizi</parameter>nin
+   <parameter>sütun_anh</parameter> ile belirtilen sütunundaki değerleri içeren
+   bir dizi ile döner. İsteğe bağlı olarak, döndürülen dizideki değerleri
+   indislemek için bir <parameter>indis</parameter> sağlanabilir.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>dizi</parameter></term>
+     <listitem>
+      <para>
+       Bir sütunundaki değerleri istenen çok noyutlu bir dizi veya nesne dizisi.
+       Bir nesne dizisi belirtilirse, public özellikler doğrudan döndürülebilir.
+       Protected veya private özelliklerin döndürülebilmesi için sınıf her
+       ikisinide <function>__get</function> ve <function>__isset</function>
+       sihirli yöntemleri ile gerçeklemelidir.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>sütun_anh</parameter></term>
+     <listitem>
+      <para>
+       Değerleri döndürülecek sütun. Bu değer döndürülecek sütunun sayısal
+       bir indisi olabileceği gibi ilişkisel bir dizi için sütunun ismi veya
+       nesne dizisi için bir özellik ismi olabilir. Dizilerin veya nesnelerin
+       tamamını döndürmek için &null; belirtmek de mümkündür (diziyi
+       belirtilen <parameter>indis</parameter> ile yeniden indislemek için
+       yararlı olabilir).
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>indis</parameter></term>
+     <listitem>
+      <para>
+       Döndürülecek sütun için kullanılacak sütun indisi veya anahtar.
+       Bu değer sütunun sayısal bir indisi veya dizgesel bir anahtar ismi
+       olabilir. PHP dizi anahtarlarına
+       <link linkend="language.types.array.key-casts">tür çarpıtması</link>
+       uygulayabilir (bununla birlikte, PHP 8.0.0'dan önce, dizgeye
+       dönüşümü destekleyen nesnelere de izin veriliyordu).
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Belirtilen dizinin tek bir sütunundaki değerleri içeren bir dizi ile 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>8.0.0</entry>
+       <entry>
+        Döndürülecek dizinin <parameter>indis</parameter> ile belirlenen
+        sütundaki nesneler artık dizgeye dönüştürülmüyor, bunun yerine bir
+        <classname>TypeError</classname> yavrulanıyor.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        <parameter>dizi</parameter> değiştirgesine artık bir nesne dizisi
+        belirtilebiliyor.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>- Bir ad/soyad kümesinden adları içeren sütunu döndürmek</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Bir veritabanından alınan olası bir kayıt kümesini temsil eden dizi
+$kayıtlar = array(
+    array(
+        'id' => 2135,
+        'ad' => 'John',
+        'soyad' => 'Doe',
+    ),
+    array(
+        'id' => 3245,
+        'ad' => 'Sally',
+        'soyad' => 'Smith',
+    ),
+    array(
+        'id' => 5342,
+        'ad' => 'Jane',
+        'soyad' => 'Jones',
+    ),
+    array(
+        'id' => 5623,
+        'ad' => 'Peter',
+        'soyad' => 'Doe',
+    )
+);
+
+$adlar = array_column($kayıtlar, 'ad');
+print_r($adlar);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => John
+    [1] => Sally
+    [2] => Jane
+    [3] => Peter
+)
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>-
+     Bir ad/soyad kümesinden soyadları içeren sütunu "id" sütunu ile
+     indisleyerek döndürmek</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Önceki örnekteki $kayıtlar dizisi kullanılıyor
+$soyadlar = array_column($kayıtlar, 'soyad', 'id');
+print_r($soyadlar);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [2135] => Doe
+    [3245] => Smith
+    [5342] => Jones
+    [5623] => Doe
+)
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>-
+     Bir nesnenin public "username" özelliğinden username'leri içeren
+     sütunu döndürmek
+    </title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+class User
+{
+    public $username;
+
+    public function __construct(string $username)
+    {
+        $this->username = $username;
+    }
+}
+
+$users = [
+    new User('user 1'),
+    new User('user 2'),
+    new User('user 3'),
+];
+
+print_r(array_column($users, 'username'));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => user 1
+    [1] => user 2
+    [2] => user 3
+)
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>-
+     Sihirli <function>__get</function> yöntemini kullanarak bir nesnenin
+     private "isim" özelliğindeki isimleri içeren sütunu döndürmek
+    </title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+class Person
+{
+    private $isim;
+
+    public function __construct(string $isim)
+    {
+        $this->isim = $isim;
+    }
+
+    public function __get($prop)
+    {
+        return $this->$prop;
+    }
+
+    public function __isset($prop) : bool
+    {
+        return isset($this->$prop);
+    }
+}
+
+$people = [
+    new Person('Fred'),
+    new Person('Jane'),
+    new Person('John'),
+];
+
+print_r(array_column($people, 'isim'));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => Fred
+    [1] => Jane
+    [2] => John
+)
+]]>
+    </screen>
+   </example>-
+    <function>__isset</function> kullanılmazsa boş bir dizi döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member>
+     <link xmlns:xlink="http://www.w3.org/1999/xlink"
+     xlink:href="&url.arraycolumn.compat;">5.5'tan küçük PHP için önerilen
+     userland gerçeklenimi</link>
+    </member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/array/functions/array-key-first.xml b/reference/array/functions/array-key-first.xml
new file mode 100644
index 00000000..e69f198f
--- /dev/null
+++ b/reference/array/functions/array-key-first.xml
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
+<refentry xml:id="function.array-key-first" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>array_key_first</refname>
+  <refpurpose>Dizinin ilk anahtarı ile döner</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>int</type><type>string</type><type>null</type></type><methodname>array_key_first</methodname>
+   <methodparam><type>array</type><parameter>dizi</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Dahili dizi göstericisini etkilemeden belirtilen
+   <parameter>dizi</parameter>nin ilk anahtarı ile döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>dizi</parameter></term>
+    <listitem>
+     <para>
+      İlk anahtarı istenen dizi.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Dizi boş değilse <parameter>dizi</parameter>nin ilk anahtarı ile döner;
+   aksi takdirde &null; döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example xml:id="array_key_first.example.basic">
+    <title>- <function>array_key_first</function> Temel Kullanım Örneği</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dizi = ['a' => 1, 'b' => 2, 'c' => 3];
+
+$ilkAnh = array_key_first($dizi);
+
+var_dump($ilkAnh);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+string(1) "a"
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <tip>
+    <simpara>
+     PHP 7.3.0'dan önceki sürümlerde bu işlevselliği sağlamanın çeşitli
+     yolları vardır. <function>array_keys</function> işlevi kullanılabilir
+     ama oldukça verimsiz olabilir. <function>reset</function> ve
+     <function>key</function> işlevleri ise dahili dizi göstericisini
+     değiştirebilir. Dahili dizi göstericisini değiştirmeyen aşağıdaki
+     örnek en verimli çözüm olabilir:
+    </simpara>
+   <informalexample>
+    <programlisting role="php">
+<![CDATA[
+<?php
+if (!function_exists('array_key_first')) {
+    function array_key_first(array $dizi) {
+        foreach($dizi as $key => $unused) {
+            return $key;
+        }
+        return NULL;
+    }
+}
+?>
+]]>
+    </programlisting>
+   </informalexample>
+  </tip>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>array_key_last</function></member>
+   <member><function>reset</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/array/functions/array-key-last.xml b/reference/array/functions/array-key-last.xml
new file mode 100644
index 00000000..c79116fa
--- /dev/null
+++ b/reference/array/functions/array-key-last.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: nilgun Status: ready -->
+<refentry xml:id="function.array-key-last" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>array_key_last</refname>
+  <refpurpose>Dizinin son anahtarı ile döner</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>int</type><type>string</type><type>null</type></type><methodname>array_key_last</methodname>
+   <methodparam><type>array</type><parameter>dizi</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Dahili dizi göstericisini etkilemeden belirtilen
+   <parameter>dizi</parameter>nin son anahtarı ile döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>dizi</parameter></term>
+    <listitem>
+     <para>
+      Son anahtarı istenen dizi.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Dizi boş değilse <parameter>dizi</parameter>nin son anahtarı ile döner;
+   aksi takdirde &null; döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>array_key_first</function></member>
+   <member><function>end</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/array/functions/key-exists.xml b/reference/array/functions/key-exists.xml
new file mode 100644
index 00000000..47d787f2
--- /dev/null
+++ b/reference/array/functions/key-exists.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 0bb9c60f64c0c9cfba7218e917fd4375790f59b4 Maintainer: nilgun Status: ready -->
+<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<refentry xml:id="function.key-exists" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>key_exists</refname>
+  <refpurpose>&Alias; <function>array_key_exists</function></refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <simpara>
+   &info.function.alias;
+   <function>array_key_exists</function>.
+  </simpara>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->