com doc/tr: update for sync with English docs.: appendices/debugger.xml language/control-structures/match.xml reference/pcre/pattern.posix.xml reference/xmlwriter/reference.xml

[email protected] (Nilgün Belma Bugüner) Sat, 09 Jan 2021 06:01:29 +0000
Newsgroups php.doc.tr
Message-ID <[email protected]>
Commit:    d933bf0df06677a9c63bfe58968c58b99b520b32
Author:    Nilgün Belma Bugüner <[email protected]>         Sat, 9 Jan 2021 09:01:29 +0300
Parents:   4c7624aec028de3f04c8e8bcfd81cba4fe527ef3
Branches:  master

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

Log:
update for sync with English docs.

Changed paths:
  M  appendices/debugger.xml
  A  language/control-structures/match.xml
  M  reference/pcre/pattern.posix.xml
  D  reference/xmlwriter/reference.xml
diff_d933bf0df06677a9c63bfe58968c58b99b520b32.txt (text/plain, 10.7 KB)
diff --git a/appendices/debugger.xml b/appendices/debugger.xml
index aea12036..b5c18576 100644
--- a/appendices/debugger.xml
+++ b/appendices/debugger.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision:  335796 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 027f187b3ed8cdec60db6f83baf8f62b536d1101 Maintainer: nilgun Status: ready -->
  <appendix xml:id="debugger" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>PHP'de Hata Ayıklama</title>
 
diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml
new file mode 100644
index 00000000..3bc1a2ac
--- /dev/null
+++ b/language/control-structures/match.xml
@@ -0,0 +1,278 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: d60cfe1bfdfc1b3c297b98153671d7a72fdf2a1f Maintainer: nilgun Status: ready -->
+<sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>match</title>
+ <?phpdoc print-version-for="match"?>
+ <para>
+  <literal>match</literal> (eşleşme) ifadesi, bir değerin özdeşlik denetimine
+  dayalı olarak değerlendirmesini dallara ayırır. Switch deyimine benzer
+  şekilde, bir <literal>match</literal> ifadesinin birden çok alternatifle
+  karşılaştırılan bir özne ifadesi vardır. <literal>switch</literal>'in
+  aksine, üçlü ifadeler gibi bir değere indirgeyecektir.
+  <literal>switch</literal> aksine, karşılaştırma zayıf bir eşitlik
+  denetiminden (==) ziyade bir özdeşlik denetimidir (===). Eşleşme ifadeleri
+  PHP 8.0.0'dan itibaren mevcuttur.
+ </para>
+
+ <example>
+  <title><literal>match</literal> ifadesinin yapısı</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+$dönüş değeri = match (özne_ifade) {
+    tekil_koşullu_ifade => dönüş_ifadesi,
+    koşullu_ifade1, koşullu_ifade2 => dönüş_ifadesi,
+};
+?>
+]]>
+  </programlisting>
+
+  <note>
+   <simpara>
+    <literal>match</literal> ifadesinin sonucunun kullanılmasına gerek yoktur.
+   </simpara>
+  </note>
+  <note>
+   <simpara>
+    <literal>match</literal> ifadesi <emphasis>mutlaka</emphasis> bir noktalı
+    virgül <literal>;</literal> ile sonlandırılmalıdır.
+   </simpara>
+  </note>
+ </example>
+
+ <para>
+  <literal>match</literal> ifadesi <literal>switch</literal> deyimine
+  benzemekle birlikte bazı önemli farklar vardır:
+
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     Bir <literal>match</literal> kolu değeri birebir (<code>===</code>)
+     değerlendirir, <literal>switch</literal> deyimin yaptığı gibi gevşekçe
+     değil.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <literal>match</literal> ifadesi bir değer döndürür.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <literal>match</literal> kolları <literal>switch</literal> deyimlerini
+     yaptığı gibi sonraki durumlarda başarısız olmaz.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <literal>match</literal> ifadesi kapsamlı olmalıdır.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </para>
+
+ <para>
+  <literal>switch</literal> deyimleri gibi, <literal>match</literal> ifadeleri
+  de eşleşmeleri sırayla değerlendirir. Başlangıçta hiçbir kod çalıştırılmaz.
+  Koşullu ifadeler yalnızca, tüm önceki koşullu ifadeler özne ifadeyle
+  eşleşmede başarısız olmuşlarsa değerlendirilir. Yalnızca eşleşen koşullu
+  ifadeye karşılık gelen dönüş ifadesi değerlendirilir. Örneğin:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$sonuç = match ($x) {
+    foo() => ...,
+    $this->bar() => ..., //  foo() === $x ise bar() çağrılmaz
+    $this->baz => beep(), // $x === $this->baz olmadıkça beep() çağrılmaz
+    // vb.
+};
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+
+ <para>
+  <literal>match</literal> ifadesinin kolları virgüllerle ayrılmış çok sayıda
+  ifade içerebilir.  Bu bir mantıksal VEYA olup, aynı sağ taraflı çok sayıda
+  eşleşme kolu için bir kısa yoldur.
+ </para>
+ <para>
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$sonuç = match ($x) {
+    // Bu eşleşme kolu:
+    $a, $b, $c => 5,
+    // Aşağıdaki üç eşleşme koluna eşdeğerdir:
+    $a => 5,
+    $b => 5,
+    $c => 5,
+};
+?>
+]]>
+   </programlisting>
+  </informalexample>
+ </para>
+ <para>
+  Özel bir durum <literal>default</literal> kalıbıdır.
+  Bu kalıp evvelce eşleşmemiş herşeyle eşleşir.
+  Örnek:
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$ifadeSonucu = match ($koşul) {
+    1, 2 => foo(),
+    3, 4 => bar(),
+    default => baz(),
+};
+?>
+]]>
+   </programlisting>
+  </informalexample>
+  <note>
+   <simpara>
+    Çok sayıda <literal>default</literal> kalıbı bir
+    <constant>E_FATAL_ERROR</constant> hatasına (ölümcül hataya) yol açar.
+   </simpara>
+  </note>
+ </para>
+
+ <para>
+  <literal>match</literal> ifadesi kapsamlı olmalıdır. Konu ifadesi herhangi
+  bir eşleşme kolu tarafından işlenmezse, bir
+  <classname>UnhandledMatchError</classname> (başarısız eşleşme hatası)
+  yavrulanır.
+ </para>
+
+ <example>
+  <title>- Başarısız eşleşme hatası örneği</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+$özne = 5;
+
+try {
+    match ($özne) {
+        1, 2 => foo(),
+        3, 4 => bar(),
+    };
+} catch (\UnhandledMatchError $e) {
+    var_dump($e);
+}
+?>
+]]>
+  </programlisting>
+  &example.outputs;
+  <screen>
+<![CDATA[
+object(UnhandledMatchError)#1 (7) {
+  ["message":protected]=>
+  string(33) "Unhandled match value of type int"
+  ["string":"Error":private]=>
+  string(0) ""
+  ["code":protected]=>
+  int(0)
+  ["file":protected]=>
+  string(9) "/in/ICgGK"
+  ["line":protected]=>
+  int(6)
+  ["trace":"Error":private]=>
+  array(0) {
+  }
+  ["previous":"Error":private]=>
+  NULL
+}
+]]>
+  </screen>
+ </example>
+
+ <sect2>
+  <title>- Başarısız eşleşmeleri işlemek için <literal>match</literal>
+   ifadelerin kullanımı</title>
+  <para>
+   Özne ifadesi olarak true kullanarak özdeş olmayan koşullu durumları ele almak
+   için bir <literal>match</literal> ifadesi kullanmak mümkündür.
+  </para>
+
+  <example>
+   <title>- Tamsayı aralıklarında dallanmak için genelleştirilmiş eşleşme
+    ifadelerinin kullanılması</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$yaş = 23;
+
+$result = match (true) {
+    $yaş >= 65 => 'yaşlı',
+    $yaş >= 25 => 'yetişkin',
+    $yaş >= 18 => 'genç',
+    default => 'çocuk',
+};
+
+var_dump($result);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+string(11) "genç"
+]]>
+   </screen>
+  </example>
+
+  <example>
+   <title>- Dize içeriklerde dallanmak için genelleştirilmiş eşleşme
+    ifadelerinin kullanılması</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$text = 'Bienvenue chez nous';
+
+$result = match (true) {
+    str_contains($text, 'Welcome') || str_contains($text, 'Hello') => 'en',
+    str_contains($text, 'Bienvenue') || str_contains($text, 'Bonjour') => 'fr',
+    // ...
+};
+
+var_dump($result);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+string(2) "fr"
+]]>
+   </screen>
+  </example>
+ </sect2>
+</sect1>
+
+<!-- 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/pcre/pattern.posix.xml b/reference/pcre/pattern.posix.xml
index c0205ee9..b26af8c0 100644
--- a/reference/pcre/pattern.posix.xml
+++ b/reference/pcre/pattern.posix.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297760 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 248f68c66417ce52bc70a3f268f53469735dae79 Maintainer: nilgun Status: ready -->
 <article xml:id="reference.pcre.pattern.posix" xmlns="http://docbook.org/ns/docbook">
  <title>POSIX regex'ten farklılıklar</title>
 
@@ -23,7 +23,8 @@
    <listitem>
     <simpara>
      POSIX'in tersine, PCRE eklentisi harf büyüklüğüne duyarsız eşleşmeye
-     adanmış işlevlere sahip değildir. Bunun yerine /i
+     adanmış işlevlere sahip değildir. Bunun yerine <emphasis>i</emphasis>
+     (<literal>PCRE_CASELESS</literal>)
      <link linkend="reference.pcre.pattern.modifiers">şablon
      değiştiricisi</link>. kullanılır. Eşleşme stratejisini değiştirmek için
      kullanılabilecek başka değiştiriciler de vardır.
@@ -47,6 +48,21 @@
      gerektirir.
     </simpara>
    </listitem>
+   <listitem>
+    <simpara>
+     Bir "karakter sınıfının" POSIX tanımı, PCRE'ninkinden farklıdır. Bir dizi
+     belirgin karakterle eşleşecek basit parantez ifadeleri, PCRE <link
+     linkend="regexp.reference.character-classes">karakter sınıfları</link>
+     biçiminde desteklenir, ancak POSIX harmanlama öğeleri, karakter sınıfları
+     ve karakter eşdeğerleri desteklenmez.
+    </simpara>
+    <simpara>
+     PRE'ye <literal>:, .</literal> veya <literal>=</literal> karakterleri
+     ile başlayıp biten bir karakter sınıfına sahip bir ifade sağlamak, bu
+     desteklenmeyen özelliklerden birini kullanma girişimi olarak yorumlanır
+     ve bir derleme hatasına neden olur.
+    </simpara>
+   </listitem>
   </orderedlist>
  </para>
 
diff --git a/reference/xmlwriter/reference.xml b/reference/xmlwriter/reference.xml
deleted file mode 100644
index f02db6c1..00000000
--- a/reference/xmlwriter/reference.xml
+++ /dev/null
@@ -1,30 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready -->
-<reference xml:id="ref.xmlwriter" xmlns="http://docbook.org/ns/docbook">
- <title>XMLWriter &Functions;</title>
-
- <!-- FIXME: More classess needing markup upgrade -->
- &reference.xmlwriter.entities.functions;
-</reference>
-
-<!-- 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
--->