com doc/tr: update for sync with English docs.: reference/curl/constants.xml reference/misc/functions/constant.xml reference/misc/functions/define.xml
reference/misc/functions/die.xml reference/misc/functions/eval.xml reference/misc/functions/exit.xml reference/misc/functions/get-browser.xml
reference/misc/functions/highlight-string.xml reference/misc/functions/ignore-user-abort.xml reference/misc/functions/pack.xml
reference/misc/functions/php-s

From: Date: Tue, 16 Mar 2021 11:52:19 +0000
Subject: com doc/tr: update for sync with English docs.: reference/curl/constants.xml reference/misc/functions/constant.xml reference/misc/functions/define.xml
reference/misc/functions/die.xml reference/misc/functions/eval.xml reference/misc/functions/exit.xml reference/misc/functions/get-browser.xml
reference/misc/functions/highlight-string.xml reference/misc/functions/ignore-user-abort.xml reference/misc/functions/pack.xml
reference/misc/functions/php-s
Groups: php.doc.tr 
Request: Send a blank email to doc-tr+get-2606@lists.php.net to get a copy of this message
Commit: 722fac170d8cdd18f4f34c0a86324d6d2cabd01c Author: Nilgün Belma Bugüner <nilgun@php.net> Tue, 16 Mar 2021 14:52:19 +0300 Parents: 172a3d026429485a53ac9542b33bde65f6e694e5 Branches: master Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=722fac170d8cdd18f4f34c0a86324d6d2cabd01c Log: update for sync with English docs. Changed paths: M reference/curl/constants.xml M reference/misc/functions/constant.xml M reference/misc/functions/define.xml M reference/misc/functions/die.xml M reference/misc/functions/eval.xml M reference/misc/functions/exit.xml M reference/misc/functions/get-browser.xml M reference/misc/functions/highlight-string.xml M reference/misc/functions/ignore-user-abort.xml M reference/misc/functions/pack.xml M reference/misc/functions/php-strip-whitespace.xml M reference/misc/functions/sleep.xml M reference/misc/functions/sys-getloadavg.xml M reference/misc/functions/time-nanosleep.xml M reference/misc/functions/time-sleep-until.xml M reference/misc/functions/uniqid.xml M reference/misc/functions/unpack.xml M reference/misc/functions/usleep.xml

diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml index 5c061fb8..f35d62e7 100644 --- a/reference/curl/constants.xml +++ b/reference/curl/constants.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 3b792d800d248236a0ff0698c74dfeab75cffc92 Maintainer: nilgun Status: ready --> <appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; @@ -1916,6 +1916,7 @@ </term> <listitem> <simpara> + Eşzamansız DNS çözümler. PHP 7.3.0 ve cURL 7.10.7 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -1938,6 +1939,7 @@ </term> <listitem> <simpara> + Karakter dönüşümleri desteklenir. PHP 7.3.0 ve cURL 7.15.4 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -1949,6 +1951,7 @@ </term> <listitem> <simpara> + Hata ayıklama bellek takibi desteklenir. PHP 7.3.6 ve cURL 7.19.6 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -1960,6 +1963,7 @@ </term> <listitem> <simpara> + Hata ayıklama yetenekleriyle derlenmiş sürüm. PHP 7.3.0 ve cURL 7.10.6 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -1971,6 +1975,7 @@ </term> <listitem> <simpara> + GSS-API kütüphanesiyle destekli sürüm. PHP 7.3.0 ve cURL 7.38.0 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -1982,6 +1987,7 @@ </term> <listitem> <simpara> + Görüşme kimlik doğrulaması desteklenir. PHP 7.3.0 ve cURL 7.10.6 sürümünden itibaren kullanılabilir. (7.38.0'dan itibaren kullanımdan kaldırıldı) </simpara> @@ -1994,6 +2000,7 @@ </term> <listitem> <simpara> + Uluslararası alan adları desteklenir. PHP 7.3.0 ve cURL 7.12.0 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2016,6 +2023,7 @@ </term> <listitem> <simpara> + NTLM kimlik doğrulaması desteklenir. PHP 7.3.0 ve cURL 7.10.6 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2027,6 +2035,7 @@ </term> <listitem> <simpara> + Winbind yardımcısına NTLM yetkisi desteklenir. PHP 7.3.0 ve cURL 7.22.0 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2038,7 +2047,7 @@ </term> <listitem> <simpara> - + IPV6 etkin olur. </simpara> </listitem> </varlistentry> @@ -2049,7 +2058,7 @@ </term> <listitem> <simpara> - + Kerberos V4 kimlik doğrulaması desteklenir. </simpara> </listitem> </varlistentry> @@ -2071,7 +2080,20 @@ </term> <listitem> <simpara> - PHP 5.5.24 and 5.6.8 ve cURL 7.33.0'dan beri kullanılabilmektedir. + Yerleşik HTTP2 desteği. + PHP 5.5.24, 5.6.8 ve cURL 7.33.0'dan beri kullanılabilmektedir. + </simpara> + </listitem> + </varlistentry> + <varlistentry xml:id="constant.curl-version-largefile"> + <term> + <constant>CURL_VERSION_LARGEFILE</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + 2GB'dan büyük dosyalar desteklenir. + PHP 5.5.24, 5.6.8 ve cURL 7.33.0'dan beri kullanılabilmektedir. </simpara> </listitem> </varlistentry> @@ -2082,6 +2104,7 @@ </term> <listitem> <simpara> + Mozilla'nın Genel Sonek Listesi çerez alan doğrulaması için kullanılır. PHP 7.3.6 ve cURL 7.47.0'dan beri kullanılabilmektedir. </simpara> </listitem> @@ -2093,6 +2116,7 @@ </term> <listitem> <simpara> + SPNEGO kimlik doğrulaması desteklenir. PHP 7.3.0 ve cURL 7.10.8 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2104,6 +2128,7 @@ </term> <listitem> <simpara> + Windows SSPI desteğiyle derlenmiş sürüm. PHP 7.3.0 ve cURL 7.13.2 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2115,7 +2140,7 @@ </term> <listitem> <simpara> - + SSL seçenekleri kullanılabilir. </simpara> </listitem> </varlistentry> @@ -2126,6 +2151,7 @@ </term> <listitem> <simpara> + TLS_SRP kimlik doğrulaması desteklenir. PHP 7.3.0 ve cURL 7.21.4 sürümünden itibaren kullanılabilir. </simpara> </listitem> @@ -2137,6 +2163,7 @@ </term> <listitem> <simpara> + Unix alanı soketleri desteklenir. PHP 7.0.7 ve cURL 7.40.0'dan beri kullanılabilmektedir. </simpara> </listitem> @@ -2148,7 +2175,7 @@ </term> <listitem> <simpara> - + libz özellikleri kullanılabilir. </simpara> </listitem> </varlistentry> diff --git a/reference/misc/functions/constant.xml b/reference/misc/functions/constant.xml index 1a8d03c8..46bba3ce 100644 --- a/reference/misc/functions/constant.xml +++ b/reference/misc/functions/constant.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 8669246db504c414a0c0224c359929435ea922be Maintainer: nilgun Status: ready --> <refentry xml:id="function.constant" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>constant</refname> @@ -50,6 +50,14 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <para> + Sabit tanımlı değilse <constant>E_WARNING</constant> seviyesinde bir hata + üretilir. + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/misc/functions/define.xml b/reference/misc/functions/define.xml index d4b51217..f54ee3ea 100644 --- a/reference/misc/functions/define.xml +++ b/reference/misc/functions/define.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: nilgun Status: ready --> <refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>define</refname> @@ -13,7 +13,7 @@ <type>bool</type><methodname>define</methodname> <methodparam><type>string</type><parameter>isim</parameter></methodparam> <methodparam><type>mixed</type><parameter>değer</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>harf_büyüklüğüne_duyarsız</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>harf_büyüklüğüne_duyarsız</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> Çalışma sırasında bir isimli sabit tanımlamaya yarar. @@ -30,18 +30,30 @@ <para> Sabitin ismi. </para> + <note> + <para> + Ayrılmış ve hatta geçersiz adlarla sabit tanımlamak mümkündür. + Bunların değeri (yalnızca) <function>constant</function> ile alınabilir. + Ancak bunu yapmanız önerilmez. + </para> + </note> </listitem> </varlistentry> <varlistentry> <term><parameter>değer</parameter></term> <listitem> <para> - Sabitin değeri. Sadece sayıl ve <type>null</type> değerlere izin - verilir. Sayıl değerler, <type>integer</type>, <type>float</type>, - <type>string</type> veya <type>boolean</type> türünde değerlerdir. - <type>resource</type> türünde sabitler tanımlamak mümkün ise de - beklenmedik davranışlara yol açacağından bu önerilmez. + Sabitin değeri. PHP 5'te <type>integer</type>, <type>float</type>, + <type>string</type>, <type>boolean</type> veya &null; türünde değerler + kabul edilirken PHP 7'de bunlara <type>array</type> türünde değerler de + eklenmiştir. </para> + <warning> + <para> + <type>resource</type> türünde sabitler tanımlamak mümkün ise de + beklenmedik davranışlara yol açacağından bu önerilmez. + </para> + </warning> </listitem> </varlistentry> <varlistentry> @@ -53,6 +65,17 @@ <literal>SABiT</literal> ve <literal>Sabit</literal> farklı sabitler olarak ele alınır. </para> + <warning> + <simpara> + PHP 7.3.0 ve sonrasında harf büyüklüğüne duyarsız sabitlerin kullanımı + önerilmemektedir. + </simpara> + </warning> + <note> + <para> + Harf büyüklüğüne duyarsız sabitler küçük harfli saklanır. + </para> + </note> </listitem> </varlistentry> </variablelist> @@ -66,6 +89,37 @@ </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> + <parameter>harf_büyüklüğüne_duyarsız</parameter> değiştirgesinin + kullanımı önerilmemektedir. PHP 8.0.0 sürümünde kaldırılmıştır. + </entry> + </row> + <row> + <entry>7.0.0</entry> + <entry> + <type>array</type> türünde değerlere izin verilmektedir. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -82,11 +136,50 @@ define("GREETING", "Hello you.", true); echo GREETING; // çıktısı: "Hello you." echo Greeting; // çıktısı: "Hello you." +// PHP 7 ve sonrasında çalışır +define('ANIMALS', array( + 'dog', + 'cat', + 'bird' +)); +echo ANIMALS[1]; // çıktısı: "cat" + ?> ]]> </programlisting> </example> </para> + <para> + <example> + <title>- Ayrılmış isimli sabitler</title> + <para> + Bu örnek, bir + <link linkend="language.constants.predefined">sihirli sabit</link> ile + aynı ada sahip bir sabiti tanımlama durumundaki davranışı göstermektedir. + Ortaya çıkan davranış açıkça kafa karıştırıcı olduğundan, pratikte bunu + yapmanız önerilmez. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(defined('__LINE__')); +var_dump(define('__LINE__', 'test')); +var_dump(constant('__LINE__')); +var_dump(__LINE__); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +bool(true) +string(4) "test" +int(5) +]]> + </screen> + </example> + </para> </refsect1> <refsect1 role="seealso"> diff --git a/reference/misc/functions/die.xml b/reference/misc/functions/die.xml index cfa236f5..ef37dd4e 100644 --- a/reference/misc/functions/die.xml +++ b/reference/misc/functions/die.xml @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 84b8fca68fc762fefe85acde180a38b2e77a28b9 Maintainer: nilgun Status: ready --> <refentry xml:id="function.die" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>die</refname> - <refpurpose><function>exit</function> işlevinin eşdeğeri</refpurpose> + <refpurpose><literal>exit</literal> işlevinin eşdeğeri</refpurpose> </refnamediv> <refsect1 role="description"> diff --git a/reference/misc/functions/eval.xml b/reference/misc/functions/eval.xml index 2b270161..2b55e47b 100644 --- a/reference/misc/functions/eval.xml +++ b/reference/misc/functions/eval.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: a0a0165e07a83d74a66c316d52b04c1f4bf52aeb Maintainer: nilgun Status: ready --> <refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eval</refname> @@ -15,24 +15,17 @@ </methodsynopsis> <para> <parameter>kod_dizgesi</parameter> ile belirtilen dizgeyi bir PHP kodu - olarak yorumlar. Kodları diğer her şeyin yanında, veritabanının bir metin - alanında tutmak ve bu kodları gerektiğinde çalıştırmak için çok - kullanışlıdır. - </para> - <para> - <function>eval</function> işlevini kullanırken hatırda tutulması gereken - bazı durumlar vardır: Aktarılan dizgenin PHP kodu olarak geçerli olması - gerekir; deyimleri sonlandıran noktalı virgüller bu dahildir, yoksa - <function>eval</function> işlevinden sonraki satırda yorumlayıcı devreden - çıkmaz. Ayrıca, <parameter>kod_dizgesi</parameter> içindeki öncelemlerin - düzgün bir biçimde yapılmış olması gerekir. HTML ve PHP kodlarını karışık - kullanmak isterseniz PHP kipinden çıkmak için PHP'nin kapama etiketini - kullanabilirsiniz. - </para> - <para> - Ayrıca, <function>eval</function> altında kullanılan değişkenlerin - değerleriyle birlikte ana betikte geçerli kalacağını aklınızdan çıkarmayın. + olarak yorumlar. </para> + <caution> + <para> + <function>eval</function> dil yapısı çok tehlikelidir çünkü keyfi PHP kodunun + çalıştırılmasına izin verir. Bu nedenle kullanımı önerilmez. Bu yapıyı + kullanmaktan başka bir seçeneğin olmadığına dikkatlice karar verilirse, + önceden düzgün bir şekilde doğrulamadan kullanıcı tarafından sağlanan + herhangi bir veriyi bu işleve aktarmamaya özellikle dikkat edilmelidir. + </para> + </caution> </refsect1> <refsect1 role="parameters"> @@ -44,14 +37,38 @@ <listitem> <para> Yorumlanacak PHP kodlarını içeren dizge. - <parameter>kod_dizgesi</parameter> <link - linkend="language.basic-syntax.phpmode">PHP açılış etiketlerini</link> - içermemelidir. </para> <para> Dizge içindeki bir <literal>return</literal> deyimi dizgenin yorumlanmasını, anında durdurur. </para> + <para> + Kod, PHP açılış ve kapanış + <link linkend="language.basic-syntax.phpmode">PHP etiketleri</link> ile + sarmalanmaMAlıdır, yani + <literal>'&lt;?php echo "Merhaba!"; ?&gt;'</literal> dizgesi yerine + <literal>'echo "Merhaba!";'</literal> dizgesi aktarılmalıdır. Uygun PHP + etiketlerini kullanarak PHP kipinden çıkmak ve yeniden girmek hala + mümkündür, örn. <literal>'echo "PHP kipindeyiz!"; ?&gt;HTML kipindeyiz! + &lt;?php echo "Tekrar PHP kipindeyiz!";'</literal>. + </para> + <para> + Bunun dışında aktarılan kod geçerli PHP kodu olmalıdır. Bu, tüm + ifadelerin noktalı virgül kullanılarak uygun şekilde sonlandırılması + gerektiği anlamına gelir. Örneğin <literal>'echo "Merhaba!"'</literal> + bir ayrıştırma hatasına sebep olurken, + <literal>'echo "Merhaba!";'</literal> çalışacaktır. + </para> + <para> + Bir <literal>return</literal> deyimi kodun yorumlanmasını derhal + sonlandıracaktır. + </para> + <para> + Kod, <function>eval</function> işlevini çağıran kodun etki alanında + çalıştırılacaktır. Bu nedenle <function>eval</function> çağrısında + tanımlanan veya değiştirilen tüm değişkenler, işlev sonlandırıldıktan + sonra görünür kalacaktır. + </para> </listitem> </varlistentry> </variablelist> @@ -64,10 +81,12 @@ Kod dizgesi içinde bir <literal>return</literal> bulunmadıkça <function>eval</function> daima &null; döndürür. <literal>return</literal> ile bir değer döndürülmesi durumunda bu değeri döndürür. Belirtilen dizgede - bir çözümleme hatası saptanırsa <function>eval</function> &false; döndürür - ve çalışma dosyadaki sonraki deyimden normal olarak devam eder. - <function>eval</function> işlevinin yorumladığı kodlardaki bir hatayı - <function>set_error_handler</function> kullanarak döndürmek mümkün değildir. + bir çözümleme hatası saptanırsa <function>eval</function> PHP 7 öncesinde + &false; döndürüp çalışma dosyadaki sonraki deyimden normal olarak devam + eder; PHP 7 ve sonrasında ise <classname>ParseError</classname> istisnası + yavrulanır. <function>eval</function> işlevinin yorumladığı kodlardaki bir + hatayı <function>set_error_handler</function> kullanarak döndürmek mümkün + değildir. </para> </refsect1> diff --git a/reference/misc/functions/exit.xml b/reference/misc/functions/exit.xml index 3fcbd3af..b0da44df 100644 --- a/reference/misc/functions/exit.xml +++ b/reference/misc/functions/exit.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: nilgun Status: ready --> <refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>exit</refname> @@ -19,7 +19,14 @@ <methodparam><type>int</type><parameter>durum</parameter></methodparam> </methodsynopsis> <para> - Betiğin çalışmasını bitirir. + Betiğin çalışmasını sonlandırır. <literal>exit</literal> çağrılsa bile + <link linkend="function.register-shutdown-function">kapanma işlevleri</link> + ve <link linkend="language.oop5.decon.destructor">nesne yıkıcılar</link> + daima çalıştırılır. + </para> + <para> + <literal>exit</literal> bir dil oluşumu olup değiştirgesiz kullanımda + (<parameter>durum</parameter> belirtilmezse) parantezsiz çağrılabilir. </para> </refsect1> @@ -35,17 +42,12 @@ önce bu dizgeyi basar. </para> <para> - <parameter>status</parameter> bir tamsayı ise bu değer çıkış durumu - olarak kullanılır. Çıkış durumları 0..254 arasında olmalıdır. Çıkış - durumu 255 PHP'nin kendi kullanımına ayrılmış olup kullanılmamalıdır. + <parameter>durum</parameter> bir <type>int</type> türünde bir değer + ise bu değer çıkış durumu olarak kullanılır ve basılmaz. + Çıkış durumları 0..254 arasında olmalıdır. Çıkış durumu 255 PHP'nin + kendi kullanımına ayrılmış olup kullanılmamalıdır. Durum 0, betiğin işini başarıyla yerine getirdiği anlamına gelir. </para> - <note> - <simpara> - PHP &gt;= 4.2.0 sürümlerinde <parameter>durum</parameter> tamsayı ise - bu sayı basılmaz. - </simpara> - </note> </listitem> </varlistentry> </variablelist> @@ -63,7 +65,7 @@ &reftitle.examples; <para> <example> - <title>- <function>exit</function> örneği</title> + <title>- <literal>exit</literal> örneği</title> <programlisting role="php"> <![CDATA[ <?php @@ -79,7 +81,7 @@ $file = fopen($filename, 'r') </para> <para> <example> - <title>- Çıkış durumu örneği</title> + <title>- <literal>exit</literal> durum örneği</title> <programlisting role="php"> <![CDATA[ <?php @@ -98,6 +100,42 @@ exit(0376); // sekizlik </programlisting> </example> </para> + <para> + <example> + <title>- Kapanma işlevleri ve yıkıcıların koşulsuz çalışması</title> + <programlisting role="php"> +<![CDATA[ +<?php +class Foo +{ + public function __destruct() + { + echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL; + } +} + +function shutdown() +{ + echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL; +} + +$foo = new Foo(); +register_shutdown_function('shutdown'); + +exit(); +echo 'This will not be output.'; +?> +]]> + </programlisting> + &example.outputs; + <screen> + <![CDATA[ + Shutdown: shutdown() + Destruct: Foo::__destruct() + ]]> + </screen> + </example> + </para> </refsect1> <refsect1 role="notes"> diff --git a/reference/misc/functions/get-browser.xml b/reference/misc/functions/get-browser.xml index 3b16a4bf..6f4160ce 100644 --- a/reference/misc/functions/get-browser.xml +++ b/reference/misc/functions/get-browser.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: nilgun Status: ready --> <refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>get_browser</refname> @@ -13,7 +13,7 @@ <methodsynopsis> <type>mixed</type><methodname>get_browser</methodname> <methodparam choice="opt"><type>string</type><parameter>tarayıcı</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>dizi_döndür</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>dizi_döndür</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> Kullanıcının tarayıcısının neler yapabildiğini, tarayıcılar için bilgi @@ -68,30 +68,6 @@ </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.3.2</entry> - <entry> - İsteğe bağlı <parameter>dizi_döndür</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/misc/functions/highlight-string.xml b/reference/misc/functions/highlight-string.xml index b663e2a0..25dbe9c7 100644 --- a/reference/misc/functions/highlight-string.xml +++ b/reference/misc/functions/highlight-string.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: nilgun Status: ready --> <refentry xml:id="function.highlight-string" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>highlight_string</refname> @@ -12,12 +12,12 @@ <methodsynopsis> <type>mixed</type><methodname>highlight_string</methodname> <methodparam><type>string</type><parameter>dizge</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>döndür</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>döndür</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <simpara> - PHP'nin yerleşik söz dizimi vurgulayıcısında tanımlanmış renkler - kullanılarak belirtilen PHP koduna söz dizimi vurgulaması yapılıp sonuç ya - döndürülür ya da basılır. + PHP'nin yerleşik sözdizimi vurgulayıcısında tanımlanmış renkler + kullanılarak belirtilen PHP koduna sözdizimi vurgulaması yapılıp sonuç ya + html dilinde döndürülür ya da basılır. </simpara> </refsect1> @@ -56,30 +56,6 @@ </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>döndür</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -92,22 +68,7 @@ highlight_string('<?php phpinfo(); ?>'); ?> ]]> </programlisting> - <para> - Örneğin PHP 4'teki çıktısı: - </para> - <screen> -<![CDATA[ -<code><font color="#000000"> -<font color="#0000BB">&lt;?php phpinfo</font> -<font color="#007700">();</font> -<font color="#0000BB">?&gt;</font> -</font> -</code> -]]> - </screen> - <para> - Örneğin PHP 5'teki çıktısı: - </para> + &example.outputs; <screen> <![CDATA[ <code><span style="color: #000000"> @@ -125,6 +86,9 @@ highlight_string('<?php phpinfo(); ?>'); <refsect1 role="notes"> &reftitle.notes; &note.uses-ob; + <para> + HTML çıktı üretimi değişikliğe uğrayabilir. + </para> </refsect1> <refsect1 role="seealso"> @@ -132,6 +96,8 @@ highlight_string('<?php phpinfo(); ?>'); <para> <simplelist> <member><function>highlight_file</function></member> + <member><link linkend="ini.syntax-highlighting">INI yönergelerinin + renklendirilmesi</link></member> </simplelist> </para> </refsect1> diff --git a/reference/misc/functions/ignore-user-abort.xml b/reference/misc/functions/ignore-user-abort.xml index 841ef1fb..d7bdb665 100644 --- a/reference/misc/functions/ignore-user-abort.xml +++ b/reference/misc/functions/ignore-user-abort.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id="function.ignore-user-abort" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>ignore_user_abort</refname> @@ -12,7 +12,7 @@ &reftitle.description; <methodsynopsis> <type>int</type><methodname>ignore_user_abort</methodname> - <methodparam choice="opt"><type>string</type><parameter>değer</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>değer</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Bir istemci bağlantıyı terkettiğinde betiğin sonlandırılıp @@ -28,7 +28,7 @@ <term><parameter>değer</parameter></term> <listitem> <para> - Bu değiştirge belirtilmişse değiştirge değeri + Bu değiştirge belirtilmişse ve &null; değilse, değiştirge değeri <link linkend="ini.ignore-user-abort">ignore_user_abort</link> yönergesinin değeri olarak kullanılır. Değiştirge belirtilmemişse, işlev sadece önceki değeri (değiştirmeden) döndürür. @@ -46,6 +46,28 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>değer</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -65,14 +87,14 @@ echo 'PHP'de bağlantı varlığı sınanıyor'; // veya tarayıcının "dur" düğmesine tıklanmasını bekleyelim while(1) { - // Bağlantı kesilmişse döngüden çık - if(connection_status() != CONNECTION_NORMAL) - { - break; - } + // Bağlantı kesilmişse döngüden çık + if(connection_status() != CONNECTION_NORMAL) + { + break; + } - // 10 saniye bekle - sleep(10); + // 10 saniye bekle + sleep(10); } // Buraya gelinmişse döngü içindeyken bir düğmeye tıklanmış demektir. diff --git a/reference/misc/functions/pack.xml b/reference/misc/functions/pack.xml index 1c1db0b0..dd1538cd 100644 --- a/reference/misc/functions/pack.xml +++ b/reference/misc/functions/pack.xml @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id="function.pack" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>pack</refname> - <refpurpose>Veriyi bir ikil dizge halinde paketler</refpurpose> + <refpurpose>Veriyi ikil bir dizge halinde paketler</refpurpose> </refnamediv> <refsect1 role="description"> @@ -12,11 +12,10 @@ <methodsynopsis> <type>string</type><methodname>pack</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>değiştirgeler</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + <methodparam rep="repeat"><type>mixed</type><parameter>değerler</parameter></methodparam> </methodsynopsis> <para> - Belirtilen değiştirgeleri belirtilen <parameter>biçem</parameter> biçeminde + Belirtilen değerleri belirtilen <parameter>biçem</parameter> biçeminde bir ikil bir dizge olarak paketler. </para> <para> @@ -25,16 +24,10 @@ yoktur. </para> <para> - Şuna dikkat edin: İşaretli ve işaretsiz değerler arasındaki ayrım sadece + Şuna dikkat: İşaretli ve işaretsiz değerler arasındaki ayrım sadece <function>unpack</function> işlevini etkiler. <function>pack</function> işlevi her ikisi için de aynı sonuçları üretir. </para> - <para> - Ayrıca, şuna da dikkat edin: PHP, işaretli değerleri makineye bağımlı - tamsayı değerler olarak saklar. Eğer <type>float</type> türünde tam - hassasiyetle saklanamayacak kadar büyük bir işaretsiz tamsayı verirseniz - istenmeyen sonuçlar alabilirsiniz. - </para> </refsect1> <refsect1 role="parameters"> @@ -98,12 +91,12 @@ </row> <row> <entry>n</entry> - <entry>İşaretsiz kısa tamsayı (daima 16 bit olup, en kıymetli bayt + <entry>İşaretsiz kısa tamsayı (daima 16 bit olup, en değerli bayt baştadır)</entry> </row> <row> <entry>v</entry> - <entry>İşaretsiz kısa tamsayı (daima 16 bit olup, en kıymetsiz bayt + <entry>İşaretsiz kısa tamsayı (daima 16 bit olup, en değersiz bayt baştadır)</entry> </row> <row> @@ -128,12 +121,32 @@ </row> <row> <entry>N</entry> - <entry>İşaretsiz uzun tamsayı (daima 32 bit olup, en kıymetli bayt + <entry>İşaretsiz uzun tamsayı (daima 32 bit olup, en değerli bayt baştadır)</entry> </row> <row> <entry>V</entry> - <entry>İşaretsiz uzun tamsayı (daima 32 bit olup, en kıymetsiz bayt + <entry>İşaretsiz uzun tamsayı (daima 32 bit olup, en değersiz bayt + baştadır)</entry> + </row> + <row> + <entry>q</entry> + <entry>İşaretli çok uzun tamsayı (daima 64 bit olup, makine bayt + sıralamasındadır)</entry> + </row> + <row> + <entry>Q</entry> + <entry>İşaretsiz çok uzun tamsayı (daima 64 bit olup, makine bayt + sıralamasındadır)</entry> + </row> + <row> + <entry>J</entry> + <entry>İşaretsiz çok uzun tamsayı (daima 64 bit olup, en değerli bayt + baştadır)</entry> + </row> + <row> + <entry>P</entry> + <entry>unsigned long long (daima 64 bit olup, en değersiz bayt baştadır)</entry> </row> <row> @@ -142,11 +155,31 @@ makineye bağlıdır)</entry> </row> <row> + <entry>g</entry> + <entry>Tek hassasiyetli gerçek sayı (boyut makineye bağlı, en değersiz + bayt baştadır)</entry> + </row> + <row> + <entry>G</entry> + <entry>Tek hassasiyetli gerçek sayı (boyut makineye bağlı, en değerli + bayt baştadır)</entry> + </row> + <row> <entry>d</entry> <entry>Çift hassasiyetli gerçek sayı - double (boyut ve gösterim makineye bağlıdır)</entry> </row> <row> + <entry>e</entry> + <entry>Çift hassasiyetli gerçek sayı (boyut makineye bağlı, en + değersiz bayt baştadır)</entry> + </row> + <row> + <entry>E</entry> + <entry>Çift hassasiyetli gerçek sayı (boyut makineye bağlı, en değerli + bayt baştadır)</entry> + </row> + <row> <entry>x</entry> <entry>NUL bayt (0. karakter)</entry> </row> @@ -155,6 +188,10 @@ <entry>Bir baytlık yedek</entry> </row> <row> + <entry>Z</entry> + <entry>NUL dolgulu dizge (PHP 5.5'te yeni)</entry> + </row> + <row> <entry>@</entry> <entry>Bir mutlak konuma kadar NUL dolgu</entry> </row> @@ -165,7 +202,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>değiştirgeler</parameter></term> + <term><parameter>değerler</parameter></term> <listitem> <para> </para> @@ -178,10 +215,62 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Veriyi içeren bir ikil dizge döner. + Başarı durumunda veriyi içeren ikil bir dizge, &return.falseforfailure; </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> + Başarısızlık durumunda artık &false; dönmüyor. + </entry> + </row> + <row> + <entry>7.2.0</entry> + <entry> + <type>float</type> ve <type>double</type> türlerin ikisininde değerli + baytları başta ve sonda olabiliyor. + </entry> + </row> + <row> + <entry>7.0.15,7.1.1</entry> + <entry> + <type>float</type> ve <type>double</type> türler için bayt sıralaması + desteğini sağlayan "e", "E", "g" ve "G" kodları eklendi. + </entry> + </row> + <row> + <entry>5.6.3</entry> + <entry> + 64 bitlik sayılarla çalışmayı sağlamak için "q", "Q", "J" ve "P" + kodları eklendi. + </entry> + </row> + <row> + <entry>5.5.0</entry> + <entry> + Perl "a" koduna eşdeğer işlevselliği sağlamak için uyumluluk adına + "Z" kodu eklendi + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1><!-- }}} --> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -202,6 +291,33 @@ $ikilveri = pack("nvc*", 0x1234, 0x5678, 65, 66); </para> </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <caution> + <para> + PHP'nin dahili olarak <type>int</type> değerlerini, boyutu makineye bağlı + işaretli değerler(C türü: <literal>long</literal>) olarak sakladığını unutmayın. <type>int</type> türünün sınırları dışında sayılar veren + tamsayı değişmezleri ve işlemleri <type>float</type> olarak saklanır. Bu + kayan noktalı sayılar, tamsayı olarak paketlenirken önce tamsayı türüne + dönüştürülür. Bu, her zaman istenen bayt gösterimiyle sonuçlanmayabilir. + </para> + <para> + En alakalı durum, işaretsiz <type>int</type> türüyle temsil edilebilecek + işaretsiz sayıların paketlenmesidir. <type>int</type> türünün 32 bit + boyuta sahip olduğu sistemlerde, dönüştürme genellikle işaretsiz + <type>int</type> bayt gösterimiyle sonuçlanır (bu, C standardına göre + gerçeklenimle tanımlı işaretsizden işaretliye dönüşüm işlemlerine dayanır). + <type>int</type> türünün 64 bit olduğu sistemlerde, <type>float</type> + türü bu değerleri büyük olasılıkla hassasiyet kaybı olmadan tutacak kadar + büyük bir mantise sahip değildir. Bu sistemlerde yerel 64 bitlik C + <type>int</type> türü varsa (çoğu UNIX benzeri sistemde yoktur), üst + aralıkta <literal>I</literal> pack biçemini kullanmanın tek yolu, istenen + işaretsiz değer olarak, aynı bayt gösterimine sahip negatif + <type>int</type> değerler oluşturmaktır. + </para> + </caution> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/misc/functions/php-strip-whitespace.xml b/reference/misc/functions/php-strip-whitespace.xml index f57bb1e2..2f6f7dab 100644 --- a/reference/misc/functions/php-strip-whitespace.xml +++ b/reference/misc/functions/php-strip-whitespace.xml @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='utf-8'?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 2f0b3704890ca8e7d533677700699b422fbfa5b9 Maintainer: nilgun Status: ready --> <refentry xml:id="function.php-strip-whitespace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>php_strip_whitespace</refname> @@ -47,7 +47,13 @@ </para> <note> <para> - Bu işlev PHP 5.0.1'de açıklandığı gibi çalışır. Evvelce sadece boş bir + Bu işlev <link linkend="ini.short-open-tag">short_open_tag</link> + ini yönergesinin değerine göre işlem yapar. + </para> + </note> + <note> + <para> + Bu işlev PHP 5.0.1'de burada açıklandığı gibi çalışır. Evvelce sadece boş bir dizge döndürürdü. Bu hatayla ilgili daha fazla bilgi edinmek ve evvelki davranışını öğrenmek için <link xlink:href="&url.php.bugs;29606"> #29606</link> numaralı hata raporuna bakınız. diff --git a/reference/misc/functions/sleep.xml b/reference/misc/functions/sleep.xml index f32f339f..2dbff2f3 100644 --- a/reference/misc/functions/sleep.xml +++ b/reference/misc/functions/sleep.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: nilgun Status: ready --> <refentry xml:id="function.sleep" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>sleep</refname> @@ -37,9 +37,14 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarı durumunda <literal>0</literal> (sıfır), hata durumunda &false; - döner. Eğer çağrı bir sinyal ile kesilirse <function>sleep</function> kalan - süreyi döndürür. + Başarı durumunda <literal>0</literal> (sıfır),&return.falseforfailure; + </para> + <para> + Çağrı bir sinyalle kesilirse, <function>sleep</function> sıfırdan farklı + bir değerle döner. Windows'ta, bu değer daima <literal>192</literal> olur + (Windows API içindeki <constant>WAIT_IO_COMPLETION</constant> sabitinin + değeri). Diğer sistemlerde, dönüş değeri uykudan kalan saniye sayısı + olacaktır. </para> </refsect1> diff --git a/reference/misc/functions/sys-getloadavg.xml b/reference/misc/functions/sys-getloadavg.xml index c622b672..80c1a1db 100644 --- a/reference/misc/functions/sys-getloadavg.xml +++ b/reference/misc/functions/sys-getloadavg.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id="function.sys-getloadavg" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>sys_getloadavg</refname> @@ -9,7 +9,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>array</type><methodname>sys_getloadavg</methodname> + <type class="union"><type>array</type><type>false</type></type><methodname>sys_getloadavg</methodname> <void/> </methodsynopsis> <para> @@ -21,7 +21,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Son 1., 5. ve 15. dakikada alınan örnekleri içeren bir dizi döndürür. + Son 1., 5. ve 15. dakikada alınan örnekleri içeren bir + dizi,&return.falseforfailure; </para> </refsect1> @@ -34,7 +35,7 @@ <![CDATA[ <?php $load = sys_getloadavg(); -if ($load[0] > 80) { +if ($load[0] > 0.80) { header('HTTP/1.1 503 Too busy, try again later'); die('Sunucu çok meşgul. Lütfen daha sonra tekrar deneyin.'); } diff --git a/reference/misc/functions/time-nanosleep.xml b/reference/misc/functions/time-nanosleep.xml index d498fd01..34b8d937 100644 --- a/reference/misc/functions/time-nanosleep.xml +++ b/reference/misc/functions/time-nanosleep.xml @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='utf-8'?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id="function.time-nanosleep" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>time_nanosleep</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>time_nanosleep</methodname> + <type class="union"><type>array</type><type>bool</type></type><methodname>time_nanosleep</methodname> <methodparam><type>int</type><parameter>süre</parameter></methodparam> <methodparam><type>int</type><parameter>nanosüre</parameter></methodparam> </methodsynopsis> @@ -28,7 +28,7 @@ <term><parameter>süre</parameter></term> <listitem> <para> - Beklenecek saniye sayısını belirten bir pozitif tamsayı. + Beklenecek saniye sayısını belirten negatif olmayan bir tamsayı. </para> </listitem> </varlistentry> @@ -36,8 +36,14 @@ <term><parameter>nanosüre</parameter></term> <listitem> <para> - Saniyenin milyarda birlerini belirten bir pozitif tamsayı. + Saniyenin milyarda birlerini belirten negatif olmayan bir tamsayı. </para> + <note> + <simpara> + Windows'ta, donanıma bağlı olarak betik belirtilenden daha uzun süre + bekleyebilir. + </simpara> + </note> </listitem> </varlistentry> </variablelist> @@ -67,30 +73,6 @@ </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>5.3.0</entry> - <entry> - Bu işlev artık Windows sistemler üzerinde de çalışıyor. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1><!-- }}} --> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/misc/functions/time-sleep-until.xml b/reference/misc/functions/time-sleep-until.xml index f0ae275e..e997040b 100644 --- a/reference/misc/functions/time-sleep-until.xml +++ b/reference/misc/functions/time-sleep-until.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: nilgun Status: ready --> <refentry xml:id="function.time-sleep-until" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>time_sleep_until</refname> @@ -42,30 +42,6 @@ </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>5.3.0</entry> - <entry> - Bu işlev artık Windows sistemler üzerinde de çalışıyor. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1><!-- }}} --> - <refsect1 role="errors"> &reftitle.errors; <para> diff --git a/reference/misc/functions/uniqid.xml b/reference/misc/functions/uniqid.xml index 406880a0..e34c544d 100644 --- a/reference/misc/functions/uniqid.xml +++ b/reference/misc/functions/uniqid.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: nilgun Status: ready --> <refentry xml:id="function.uniqid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>uniqid</refname> @@ -12,12 +12,22 @@ <methodsynopsis> <type>string</type><methodname>uniqid</methodname> <methodparam choice="opt"><type>string</type><parameter>önek</parameter><initializer>""</initializer></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>döküntü_üret</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>döküntü_üret</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> Mikrosaniye cinsinden geçerli zamana dayalı olarak belirtilen <parameter>önek</parameter> ile eşsiz bir kimlik dizgesi üretir. </para> + &caution.cryptographically-insecure; + <warning> + <para> + Bu işlev, dönüş değerinin benzersizliğini garanti etmez. Çoğu sistemde + sistem saati NTP veya benzeriyle ayarlandığından, sistem zamanı sürekli + olarak değiştirilir. Bu nedenle, bu işlevin süreç/evre için benzersiz + bir kimlik döndürmemesi mümkündür. Benzersiz olma olasılığını artırmak + için <parameter>döküntü_üret</parameter> değiştirgesini kullanın. + </para> + </warning> </refsect1> <refsect1 role="parameters"> @@ -43,8 +53,8 @@ <term><parameter>döküntü_üret</parameter></term> <listitem> <para> - &true; belirtildiği takdirde elde edilen dizgenin daha da eşsiz - olmasını sağlamak üzere dizgenin sonuna (birleşik doğrusal benzeşimsel + &true; belirtildiği takdirde elde edilen dizgenin daha benzersiz olma + olasılığını artırmak için dizgenin sonuna (birleşik doğrusal benzeşimsel üreteç kullanılarak) rasgele üretilmiş karakterler eklenir. </para> </listitem> @@ -56,30 +66,39 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Eşsiz bir kimlik dizgesi döner. + Sistem zamanına dayalı benzersiz bir kimlik dizgesi döner. </para> + <warning> + <para> + Bu işlev benzersiz bir kimlik üretmeye çalışır fakat dönen değerin %100 + benzersiz olacağını garanti etmez. + </para> + </warning> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - Ağ üzerindeki bir kullanıcıya vermek için eşsiz bir dizgeye ihtiyacınız - olursa (oturum çerezleri gibi) bunu şu şekilde üretmenizi öneririz: - </para> - <para> - Bu örnek, tahmin edilmesi oldukça güçleştirilmiş 32 karakterlik (128 bitlik - bir onaltılık sayı) bir kimlik dizgesi üretir. <example> <title>- <function>uniqid</function> örneği</title> <programlisting role="php"> <![CDATA[ <?php -// önek yok. -// Sadece PHP 5 ve sonraki sürümlerde çalışır $token = md5(uniqid()); +/* 4b3403665fea6 benzeri bir kimlik */ +printf("uniqid(): %s\r\n", uniqid()); -// daha iyisi; tahmini güçleştirelim -$better_token = md5(uniqid(mt_rand(), true)); +/* Bir önek belirtilebilir, ikisi de geçerli: + * + * $uniqid = $önek . uniqid(); + * $uniqid = uniqid($önek); + */ +printf("uniqid('php_'): %s\r\n", uniqid('php_')); +/* Cygwin gibi bazı sistemlerde gerektiği + * takdirde döküntü_üret'ilebilir. + * sonuç şöyle olabilir: 4b340550242239.64159797 + */ +printf("uniqid('', true): %s\r\n", uniqid('', true)); ?> ]]> </programlisting> @@ -87,37 +106,6 @@ $better_token = md5(uniqid(mt_rand(), true)); </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>5.0.0</entry> - <entry> - <parameter>önek</parameter> seçimlik oldu. - </entry> - </row> - <row> - <entry>4.3.1</entry> - <entry> - 114 karakterlik sınırla <parameter>önek</parameter> değiştirgesi - devreye girdi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="notes"> &reftitle.notes; <note> @@ -126,7 +114,8 @@ $better_token = md5(uniqid(mt_rand(), true)); <parameter>döküntü_üret</parameter> &true; olmalıdır. </para> </note> - </refsect1> +</refsect1> + </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/misc/functions/unpack.xml b/reference/misc/functions/unpack.xml index 217c2f5e..05626942 100644 --- a/reference/misc/functions/unpack.xml +++ b/reference/misc/functions/unpack.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id="function.unpack" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>unpack</refname> @@ -10,18 +10,20 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>array</type><methodname>unpack</methodname> + <type class="union"><type>array</type><type>false</type></type><methodname>unpack</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> <methodparam><type>string</type><parameter>veri</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>başlangıç</parameter><initializer>0</initializer></methodparam> </methodsynopsis> <para> Paketlenmiş bir ikil dizgeden veriyi belirtilen - <parameter>biçem</parameter> dizgesine göre bir diziye çıkarır. + <parameter>biçem</parameter> dizgesine göre ilişkisel bir diziye çıkarır. </para> <para> - <function>unpack</function> çıkardığı veriyi bir ilişkisel dizide saklaması - bakımından Perl'dekinden biraz faklı çalışır. Bunu sağlamak için biçem - kodları farklı isimlendirilir ve bir bölü çizgisi / ile ayrılırlar. + <function>unpack</function> çıkardığı veriyi bir ilişkisel dizide saklar. + Bunu sağlamak için biçem kodları farklı isimlendirilir ve bir bölü çizgisi / + ile ayrılırlar. Yineleyici bir değer belirtilirse dizi anahtarları, belirtilen + ismin ardına eklenmiş sıra numaraları içerecektir. </para> </refsect1> @@ -46,6 +48,14 @@ </para> </listitem> </varlistentry> + <varlistentry> + <term><parameter>başlangıç</parameter></term> + <listitem> + <para> + Verininin çıkarılmaya başlanacağı başlangıç yeri. + </para> + </listitem> + </varlistentry> </variablelist> </para> </refsect1> @@ -53,10 +63,61 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - İkil dizgeden ayrıştırılan verileri içeren bir ilişkisel dizi döner. + İkil dizgeden ayrıştırılan verileri içeren bir ilişkisel + dizi,&return.falseforfailure; </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.2.0</entry> + <entry> + <type>float</type> ve <type>double</type> türlerin ikisininde değerli + baytları başta ve sonda olabiliyor. + </entry> + </row> + <row> + <entry>7.1.0</entry> + <entry> + Seçimlik <parameter>başlangıç</parameter> değiştirgesi eklendi. + </entry> + </row> + <row> + <entry>5.5.0</entry> + <entry> + <para> + Perl uyumu için aşağıdaki değişiklikler uygulandı: + </para> + <para> + "a" kodu artık sondaki NULL baytları tutuyor. + </para> + <para> + "A" kodu artık tüm ASCII boşluklarını (boşluklar, sekmeler, + satırsonları, satır başları ve NULL baytlar) ayırıyor. + </para> + <para> + NULL ile doldurulmuş dizeler için "Z" kodu eklendi; sondaki NULL + baytları kaldırıyor. + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1><!-- }}} --> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -65,15 +126,49 @@ <programlisting role="php"> <![CDATA[ <?php -$array = unpack("c2chars/nint", $binarydata); +$binarydata = "\x04\x00\xa0\x00"; +$array = unpack("cchars/nint", $binarydata); +print_r($array); ?> ]]> </programlisting> - <para> - Elde edilen dizi "chars1", "chars2" and "int" elemanlarını içerir. - </para> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [chars] => 4 + [int] => 160 +) +]]> + </screen> </example> </para> + <para> + <example> + <title>- <function>unpack</function> ve bir yineleyici</title> + <programlisting role="php"> +<![CDATA[ +<?php +$binarydata = "\x04\x00\xa0\x00"; +$array = unpack("c2chars/nint", $binarydata); +print_r($array); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [chars1] => 4 + [chars2] => 0 + [int] => 40960 +) +]]> + </screen> + </example> + </para> </refsect1> <refsect1 role="notes"> @@ -86,6 +181,44 @@ $array = unpack("c2chars/nint", $binarydata); işaretsiz olduğunu belirtseniz bile, negatif bir sayı olacaktır. </para> </caution> + <caution> + <para> + Bir öğenin ismi yoksa <literal>1</literal>'den başlayan sayısal indisler + kullanılır. Birden fazla isimsiz öğenin bulunmamasına dikkat etmek + gerekir, yoksa <literal>1</literal>'den "yeniden" başlayan sayısal + indisler eskilerini geçersiz kılar. + </para> + <para> + <example> + <title>- <function>unpack</function> ve isimsiz anahtarlar</title> + <programlisting role="php"> +<![CDATA[ +<?php +$binarydata = "\x32\x42\x00\xa0"; +$array = unpack("c2/n", $binarydata); +var_dump($array); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +array(2) { + [1]=> + int(160) + [2]=> + int(66) +} +]]> + </screen> + <para> + <literal>c</literal> belirtecindeki ilk değer + <literal>n</literal> belirtecindeki ilk değer tarafınan geçersiz + kılınmaktadır. + </para> + </example> + </para> + </caution> </refsect1> <refsect1 role="seealso"> diff --git a/reference/misc/functions/usleep.xml b/reference/misc/functions/usleep.xml index 7dc3d891..0a919ce3 100644 --- a/reference/misc/functions/usleep.xml +++ b/reference/misc/functions/usleep.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 95bc76b545a00d436239af6d5516f75ff890df56 Maintainer: nilgun Status: ready --> <refentry xml:id="function.usleep" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>usleep</refname> @@ -26,9 +26,22 @@ <term><parameter>süre</parameter></term> <listitem> <para> - İşlemsiz geçecek mikrosaniye cinsinden süre. 1 mikro saniye saniyenin + İşlemsiz geçecek mikrosaniye cinsinden süre. 1 mikrosaniye saniyenin milyonda biridir. </para> + <note> + <simpara> + <literal>1000000</literal>'dan büyük değerler (yani 1 saniyeden uzun) + işletim sistemi tarafınfan desteklenmeyebilir. Bu durumda + <function>sleep</function> işlevi kullanılabilir. + </simpara> + </note> + <note> + <simpara> + Windows'ta, donanıma bağlı olarak betik belirtilenden daha uzun süre + uyuyabilir. + </simpara> + </note> </listitem> </varlistentry> </variablelist> @@ -42,30 +55,6 @@ </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>5.0.0</entry> - <entry> - Bu işlev artık Windows sistemler üzerinde de çalışıyor. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para>
« previous php.doc.tr (#2606) next »