com doc/tr: update for sync with English docs.: language/basic-syntax.xml reference/datetime/functions/gettimeofday.xml
reference/datetime/functions/gmdate.xml reference/datetime/functions/gmmktime.xml reference/datetime/functions/gmstrftime.xml
reference/datetime/functions/localtime.xml reference/datetime/functions/microtime.xml reference/datetime/functions/strptime.xml
reference/datetime/functions/time.xml reference/datetime/functions/timezone-
| From: | Nilgün Belma Bugüner | Date: | Fri, 26 Mar 2021 10:28:53 +0000 |
| Subject: | com doc/tr: update for sync with English docs.: language/basic-syntax.xml reference/datetime/functions/gettimeofday.xml reference/datetime/functions/gmdate.xml reference/datetime/functions/gmmktime.xml reference/datetime/functions/gmstrftime.xml reference/datetime/functions/localtime.xml reference/datetime/functions/microtime.xml reference/datetime/functions/strptime.xml reference/datetime/functions/time.xml reference/datetime/functions/timezone- |
||
| Groups: | php.doc.tr | ||
| Request: | Send a blank email to doc-tr+get-2629@lists.php.net to get a copy of this message | ||
Commit: da4dcbef8dc384f5699df5c11b9e000b47c82e6d
Author: Nilgün Belma Bugüner <nilgun@php.net> Fri, 26 Mar 2021 13:28:53 +0300
Parents: 1a28125bb1004ae0d2070090fba393f70f56c107
Branches: master
Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=da4dcbef8dc384f5699df5c11b9e000b47c82e6d
Log:
update for sync with English docs.
Changed paths:
M language/basic-syntax.xml
M reference/datetime/functions/gettimeofday.xml
M reference/datetime/functions/gmdate.xml
M reference/datetime/functions/gmmktime.xml
M reference/datetime/functions/gmstrftime.xml
M reference/datetime/functions/localtime.xml
M reference/datetime/functions/microtime.xml
M reference/datetime/functions/strptime.xml
M reference/datetime/functions/time.xml
M reference/datetime/functions/timezone-name-from-abbr.xml
M reference/dio/functions/dio-fcntl.xml
M reference/dio/functions/dio-open.xml
M reference/dir/functions/chroot.xml
M reference/dir/functions/getcwd.xml
M reference/dir/functions/opendir.xml
M reference/dir/functions/readdir.xml
M reference/dir/functions/rewinddir.xml
M reference/dir/functions/scandir.xml
diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml index 4a1e221c..c5ebb5b4 100644 --- a/language/basic-syntax.xml +++ b/language/basic-syntax.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: a71742330defbc0edfbc6822b4f947bf437b2f70 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: c63057033539758cb2e6ed4786c4d59b9ed059a5 Maintainer: nilgun Status: ready --> <!-- CREDITS: tpug, sezer --> <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook"> <title>Temel Sözdizimi</title> @@ -8,15 +8,15 @@ <title>PHP etiketleri</title> <para> PHP bir dosyayı çözümlerken, hangi bölümü yorumlayıp hangi bölümü - yorumlamadan geçeceğine karar vermek için <literal><?php</literal> ve - <literal>?></literal> açılış ve kapanış etiketlerine bakar. Bu şekilde - çözümleme PHP'nin her çeşit farklı belgeye gömülmesini sağlar, çünkü bir - çift açılış ve kapanış etiketinin dışındaki her şey PHP çözümleyicisi + yorumlamadan geçeceğine karar vermek için <literal><?php</literal> ve + <literal>?></literal> açılış ve kapanış etiketlerine bakar. Bu şekilde + çözümleme PHP'nin her çeşit farklı belgeye gömülmesini sağlar, çünkü bir + çift açılış ve kapanış etiketinin dışındaki her şey PHP çözümleyicisi tarafından gözardı edilir. </para> - + <para> - PHP daha açıklayıcı olan <code><?php echo</code> etiketine bir kısaltma olarak + PHP daha açıklayıcı olan <code><?php echo</code> etiketine bir kısaltma olarak <literal><?=</literal> kısa echo etiketini içerir. </para> @@ -40,26 +40,26 @@ <para> PHP ayrıca kısa başlangıç etiketine de <literal><?</literal> izin verir. - Bu sadece, PHP <option>--enable-short-tags</option> yapılandırma seçeneği ile - derlenerek veya &php.ini; yapılandırma dosyası yönergesi <link - linkend="ini.short-open-tag">short_open_tag</link> kullanılarak + Bu sadece, PHP <option>--enable-short-tags</option> yapılandırma seçeneği ile + derlenerek veya &php.ini; yapılandırma dosyası yönergesi <link + linkend="ini.short-open-tag">short_open_tag</link> kullanılarak etkinleştirilebilir. </para> - - <para> + + <para> <note> <para> - Kısa etiketler iptal edilebileceğinden uyumluluk adına sadece normal etiketlerin + Kısa etiketler iptal edilebileceğinden uyumluluk adına sadece normal etiketlerin (<code><?php ?></code> ve <code><?= ?></code>) kullanılması önerilir. </para> </note> </para> <para> - Bir dosya sadece PHP kodu içeriyorsa, dosyanın sonunda PHP kapanış etiketini koymamak - tercih edilir. Yazılımcıdan herhangi bir çıktı gönderme isteği gelmezse PHP - betiğin bu noktasında çıktı tamponlamasını başlatacağından kapama etiketinden - sonra istenmeyen etkilere neden olabilecek boşluk veya yeni satırların + Bir dosya sadece PHP kodu içeriyorsa, dosyanın sonunda PHP kapanış etiketini koymamak + tercih edilir. Yazılımcıdan herhangi bir çıktı gönderme isteği gelmezse PHP + betiğin bu noktasında çıktı tamponlamasını başlatacağından kapama etiketinden + sonra istenmeyen etkilere neden olabilecek boşluk veya yeni satırların yanlışlıkla eklenmesi böylece engellenmiş olur. <informalexample> <programlisting role="php"> @@ -77,13 +77,13 @@ echo "İletişimin sonu"; </informalexample> </para> </sect1> - + <sect1 xml:id="language.basic-syntax.phpmode"> <title>HTML'den Kaçmak</title> <para> Başlangıç ve bitiş etiketlerinin dışında kalan her şey PHP çözümleyicisi - tarafından gözardı edilerek PHP dosyalarının karışık içeriğe sahip olabilmesi - sağlanır. Çoğu zaman, bu örnekte olduğu gibi PHP'nin HTML içine gömülmüş + tarafından gözardı edilerek PHP dosyalarının karışık içeriğe sahip olabilmesi + sağlanır. Çoğu zaman, bu örnekte olduğu gibi PHP'nin HTML içine gömülmüş olduğunu göreceksiniz. <informalexample> <programlisting role="php"> @@ -94,12 +94,12 @@ echo "İletişimin sonu"; ]]> </programlisting> </informalexample> - Bu beklendiği gibi çalışır, çünkü PHP çözümleyicisi ?> kapanış etiketine - rastlayınca (hemen ardından bir satırsonu karakteri gelmesi durumu hariç - - bak: <link linkend="language.basic-syntax.instruction-separation">deyim - ayırma</link>) başka bir açılış etiketine rastlayıncaya kadar (etiketin koşullu - bir ifadenin ortasında olması durumu hariç - bu durumda çözümleyici neyin - atlanacağına karar vermek için ifadenin sonucun saptamaya çalışacaktır) herşeyi + Bu beklendiği gibi çalışır, çünkü PHP çözümleyicisi ?> kapanış etiketine + rastlayınca (hemen ardından bir satırsonu karakteri gelmesi durumu hariç - + bak: <link linkend="language.basic-syntax.instruction-separation">deyim + ayırma</link>) başka bir açılış etiketine rastlayıncaya kadar (etiketin koşullu + bir ifadenin ortasında olması durumu hariç - bu durumda çözümleyici neyin + atlanacağına karar vermek için ifadenin sonucun saptamaya çalışacaktır) herşeyi çıktılamaya başlar. Aşağıdaki örneğe bakınız: </para> <para> @@ -117,8 +117,8 @@ echo "İletişimin sonu"; ]]> </programlisting> </example> - Bu örnekte PHP, açılış/kapanış etiketlerinin dışında olsa bile koşulun - karşılanmadığı blokları atlayacaktır, çünkü PHP yorumlayıcısı koşulun + Bu örnekte PHP, açılış/kapanış etiketlerinin dışında olsa bile koşulun + karşılanmadığı blokları atlayacaktır, çünkü PHP yorumlayıcısı koşulun karşılanmadığı durumda koşulun içinde bulunan blokları atlar. </para> <para> @@ -147,7 +147,7 @@ echo "İletişimin sonu"; noktalı virgül koymak zorunda değilsiniz. Kapanış etiketi aynı zamanda satırsonu karakterini de kendisi ekleyecektir. </para> - + <para> <example> <title>- Sondaki satırsonu karakterini kapsayan kapanış etiketini gösteren örnek</title> @@ -166,9 +166,9 @@ Ama şimdi var </screen> </example> </para> - + <para> - PHP ayrıştırıcısına girme ve çıkma örnekleri: + PHP ayrıştırıcısına girme ve çıkma örnekleri: <informalexample> <programlisting role="php"> <![CDATA[ @@ -196,7 +196,7 @@ Ama şimdi var </note> </para> </sect1> - + <sect1 xml:id="language.basic-syntax.comments"> <title>Açıklamalar</title> <para> diff --git a/reference/datetime/functions/gettimeofday.xml b/reference/datetime/functions/gettimeofday.xml index 4d25ca7b..11dd34d5 100644 --- a/reference/datetime/functions/gettimeofday.xml +++ b/reference/datetime/functions/gettimeofday.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> <refentry xml:id="function.gettimeofday" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gettimeofday</refname> @@ -10,8 +10,8 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>gettimeofday</methodname> - <methodparam choice="opt"><type>bool</type><parameter>sayı_döndür</parameter></methodparam> + <type class="union"><type>array</type><type>float</type></type><methodname>gettimeofday</methodname> + <methodparam choice="opt"><type>bool</type><parameter>sayı_döndür</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> gettimeofday(2) işlevinin arayüzüdür. Sistem çağrısıdan @@ -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>5.1.0</entry> - <entry> - <parameter>sayı_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/datetime/functions/gmdate.xml b/reference/datetime/functions/gmdate.xml index 489520f4..e40a9531 100644 --- a/reference/datetime/functions/gmdate.xml +++ b/reference/datetime/functions/gmdate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.13 --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmdate</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>string</type><methodname>gmdate</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Zamanı, Greenwich Saatiyle (GMT) döndürmesi dışında tıpkı @@ -33,9 +33,7 @@ </para> </listitem> </varlistentry> - &date.timestamp.description; - </variablelist> </para> </refsect1> @@ -43,10 +41,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Biçimlendirilmiş tarih dizgesi döndürür. Eğer - <parameter>zaman_damgası</parameter> değiştirgesi için sayısal değer - kullanılmamışsa, &false; döndürür ve <constant>E_WARNING</constant> - seviyesinde bir hata çıktılar. + Biçimlendirilmiş tarih dizgesi döndürür. </para> </refsect1> @@ -63,22 +58,9 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> - <entry> - Zaman damgasının geçerlilik aralığı, genellikle Cum, 13 Ara 1901 - 20:45:54 GMT ile Per, 19 Oca 2038 03:14:07 GMT arasındadır. - (Bu tarih değerleri aynı zamanda en küçük ve en büyük 32 bitlik - işaretli tamsayıları temsil etmektedir.) Bununla birikte, PHP - 5.1.0'den önce bu aralık bazı sistemlerde (ör: Windows) 01-01-1970 ile - 19-01-2038 arasıyla sınırlıdır. - </entry> - </row> - <row> - <entry>5.1.1</entry> + <entry>8.0.0</entry> <entry> - <parameter>biçem</parameter> değiştirgesinde kullanılabilecek standart - tarih/zaman biçem <link linkend="datetime.constants">sabitleri</link> - kullanıma girdi. + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. </entry> </row> </tbody> diff --git a/reference/datetime/functions/gmmktime.xml b/reference/datetime/functions/gmmktime.xml index ee0c97fd..fbca0842 100644 --- a/reference/datetime/functions/gmmktime.xml +++ b/reference/datetime/functions/gmmktime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 9d45296587225c85e4dab73cc27865ca32e17d3c Maintainer: behzat Status: ready --> <refentry xml:id="function.gmmktime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmmktime</refname> @@ -10,14 +10,13 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>gmmktime</methodname> - <methodparam choice="opt"><type>int</type><parameter>saat</parameter><initializer>gmdate("H")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>dakika</parameter><initializer>gmdate("i")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>saniye</parameter><initializer>gmdate("s")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ay</parameter><initializer>gmdate("n")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>gün</parameter><initializer>gmdate("j")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>yıl</parameter><initializer>gmdate("Y")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ysu_var</parameter><initializer>-1</initializer></methodparam> + <type class="union"><type>int</type><type>false</type></type><methodname>gmmktime</methodname> + <methodparam><type>int</type><parameter>saat</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>dakika</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>saniye</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>ay</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>gün</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>yıl</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Aktarılan değiştirgelerin bir GMT tarihini belirtmesi dışında tıpkı @@ -40,7 +39,10 @@ <term><parameter>saat</parameter></term> <listitem> <para> - Saat + <parameter>ay</parameter>, <parameter>gün</parameter> ve + <parameter>yıl</parameter> tarafından saptanan günün başlangıcına + göreli saat sayısı. Negatif değerler, belirtilen günün geceyarısından + önceki saat sayısıdır. 23'ten büyük değerler ertesi güne sarkar. </para> </listitem> </varlistentry> @@ -48,7 +50,9 @@ <term><parameter>dakika</parameter></term> <listitem> <para> - Dakika + <parameter>saat</parameter>in başlangıcına göreli dakika sayısı. + Negatif dakikalar önceki saatle ilgilidir. 59'dan büyük değerler + sonraki saate sarkar. </para> </listitem> </varlistentry> @@ -56,28 +60,34 @@ <term><parameter>saniye</parameter></term> <listitem> <para> - Saniye- + <parameter>dakika</parameter>nın başlangıcına göreli saniye sayısı. + Negatif saniyeler önceki dakika ilgilidir. 59'dan büyük değerler + sonraki dakikaya sarkar. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Ay</parameter></term> + <term><parameter>ay</parameter></term> <listitem> <para> - Ay + Bir önceki yılın sonuna göre ay sayısı. 1 ila 12 arasındaki değerler, + söz konusu yılın normal takvim aylarına atıfta bulunur. 1'den küçük + değerler (negatif değerler dahil), önceki yıldaki ayları ters sırayla + gösterir, yani 0 Aralık, -1 Kasım, vb. 12'den büyük değerler, sonraki + yıl(lar)daki uygun ayı belirtir. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Gün</parameter></term> + <term><parameter>gün</parameter></term> <listitem> <para> - Gün + Önceki ayın sonuna göre gün sayısı. 1 ile 28, 29, 30 veya 31 arasındaki değerler (aya bağlı olarak) ilgili ayın normal günlerini ifade eder. 1'den küçük değerler (negatif değerler dahil) önceki ayın günlerine atıfta bulunur, bu nedenle 0, önceki ayın son günüdür, -1 ondan önceki gündür vb. İlgili ay referansındaki gün sayısından daha büyük değerler sonraki ay(lar)daki uygun günlere karşılıktır. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Yıl</parameter></term> + <term><parameter>yıl</parameter></term> <listitem> <para> Yıl @@ -91,6 +101,11 @@ Değiştirgeler daima GMT zamanını temsil eder. <parameter>ysu_var</parameter> değiştirgesinin sonuca etkisi yoktur. </para> + <note> + <para> + Bu değiştirge PHP 7.0.0 sürümünde kaldırıldı. + </para> + </note> </listitem> </varlistentry> </variablelist> @@ -100,7 +115,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <type>integer</type> türünden Unix zaman damgası döner. + Başarı durumunda <type>int</type> türünden Unix zaman + damgası,&return.falseforfailure;. </para> </refsect1> @@ -117,11 +133,17 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> + <entry>8.0.0</entry> <entry> - PHP 5.1.0 sürümünden beri, <parameter>ysu_var</parameter> - değiştirgesinin kullanılması önerilmemektedir. Sonuç olarak, yerine - yeni zaman dilimi özellikleri kullanılmalıdır. + <parameter>saat</parameter> artık seçimlik değil. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>dakika</parameter>, <parameter>saniye</parameter>, + <parameter>ay</parameter>, <parameter>gün</parameter> ve + <parameter>yıl</parameter> artık &null; olabiliyor. </entry> </row> </tbody> @@ -134,11 +156,12 @@ &reftitle.examples; <para> <example> - <title>- Windows üzerinde <function>gmmktime</function> işlevi</title> + <title>- <function>gmmktime</function> temel örneği</title> <programlisting role="php"> <![CDATA[ <?php -gmmktime(0, 0, 0, 1, 1, 1970); // GMT ve batıda geçerli, doğuda geçersiz +// Çıktısı: July 1, 2000 is on a Saturday +echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000)); ?> ]]> </programlisting> diff --git a/reference/datetime/functions/gmstrftime.xml b/reference/datetime/functions/gmstrftime.xml index 9d5c2bc9..e082cce4 100644 --- a/reference/datetime/functions/gmstrftime.xml +++ b/reference/datetime/functions/gmstrftime.xml @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmstrftime</refname> - <refpurpose>Yerel ayarlara göre tarih ve saati, GMT/UTC türüne çevirir + <refpurpose>Yerel ayarlara göre tarih ve saati, UTC türüne çevirir </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>gmstrftime</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> - Zamanı, Greenwich Saatiyle (GMT) döndürmesi dışında tıpkı - <function>strftime</function> işlevi gibi davranır. Örneğin, - Doğu Standart Zamanınında (GMT -0500) çalıştırıldığında, aşağıdaki örneğin - ilk satırı "Ara 31 1998 20:00:00" basarken ikinci satırı "Oca 01 1999 - 01:00:00" basar. + UTC zamanı döndürmesi dışında <function>strftime</function> işlevi gibi + davranır. Örneğin, Doğu Standart Zamanınında (UTC -0500) + çalıştırıldığında, aşağıdaki örneğin ilk satırı "Ara 31 1998 20:00:00" + basarken ikinci satırı "Oca 01 1999 01:00:00" basar. </para> </refsect1> @@ -46,9 +45,33 @@ <para> İstenilen biçime göre verilen <parameter>zaman_damgası</parameter> değiştirgesini ya da zaman damgası değiştirgesi kullanılmamışsa yerel - zamanı; biçimlendirilmiş dizge olarak döndürür. Ay ve hafta günlerinin - isimleri ve diğer dile bağımlı dizgelerle ilgili geçerli yereller - <function>setlocale</function> işlevi ile ayarlanabilir. + zamanı; biçimlendirilmiş dizge olarak döndürür,&return.falseforfailure;. + Ay ve hafta günlerinin isimleri ve diğer dile bağımlı dizgelerle ilgili + geçerli yereller <function>setlocale</function> işlevi ile ayarlanabilir. + </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> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> diff --git a/reference/datetime/functions/localtime.xml b/reference/datetime/functions/localtime.xml index de5c3aad..bec9a8cc 100644 --- a/reference/datetime/functions/localtime.xml +++ b/reference/datetime/functions/localtime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>localtime</refname> @@ -11,8 +11,8 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>localtime</methodname> - <methodparam choice="opt"><type>int</type><parameter>zamandamgası</parameter><initializer>time()</initializer></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>ilişkisel_mi</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>ilişkisel</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> <function>localtime</function> işlevi, standart C işlev çağrısı olan localtime tarafından döndürülen yapıya eşdeğer bir dizi döndürür. @@ -23,11 +23,9 @@ &reftitle.parameters; <para> <variablelist> - &date.timestamp.description; - <varlistentry> - <term><parameter>ilişkisel_mi</parameter></term> + <term><parameter>ilişkisel</parameter></term> <listitem> <para> Eğer değiştirge &false; olarak ayarlanmış ya da kullanılmamışsa, @@ -41,25 +39,22 @@ <itemizedlist> <listitem> <simpara> - "tm_sec" - saniye + "tm_sec" - saniye, <literal>0</literal> - <literal>59</literal> </simpara> </listitem> <listitem> <simpara> - "tm_min" - dakika + "tm_min" - dakika, <literal>0</literal> - <literal>59</literal> </simpara> </listitem> <listitem> <simpara> - "tm_hour" - saat + "tm_hour" - saat, <literal>0</literal> - <literal>23</literal> </simpara> </listitem> <listitem> <simpara> - "tm_mday" - ayın günleri - </simpara> - <simpara> - Aylar, 0'dan (Ocak) 11'e (Aralık) ve haftanın günleri 0'dan (Paz) 6'ya (Cmt). + "tm_mday" - ayın günleri, <literal>1</literal> - <literal>31</literal> </simpara> </listitem> <listitem> @@ -69,23 +64,27 @@ </listitem> <listitem> <simpara> - "tm_year" - Yıllar, başlangıç 1900 kabul edilir + "tm_year" - Yıllar,, <literal>0</literal> (Ocak) - <literal>11</literal> (Aralık) </simpara> </listitem> <listitem> <simpara> - "tm_wday" - Haftanın günleri + "tm_wday" - Haftanın günleri, <literal>0</literal> (Paz) - <literal>6</literal> (Cts) </simpara> </listitem> <listitem> <simpara> - "tm_yday" - Yılın günleri + "tm_yday" - Yılın günleri, <literal>0</literal> - <literal>365</literal> </simpara> </listitem> <listitem> <simpara> - "tm_isdst" - Yaz saati uygulaması bilgisi + "tm_isdst" - Yaz saati etkin mi? </simpara> + <simpara> + Evet ise pozitif, hayır ise <literal>0</literal>, bilinmiyorsa + negatiftir. + </simpara> </listitem> </itemizedlist> </para> @@ -97,9 +96,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -114,9 +111,12 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -171,6 +171,14 @@ Array </example> </para> </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>getdate</function></member> + </simplelist> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/datetime/functions/microtime.xml b/reference/datetime/functions/microtime.xml index a7406c9a..fd198a0f 100644 --- a/reference/datetime/functions/microtime.xml +++ b/reference/datetime/functions/microtime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> <refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>microtime</refname> @@ -11,14 +11,17 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>microtime</methodname> - <methodparam choice="opt"><type>bool</type><parameter>gerçek_sayı</parameter></methodparam> + <type class="union"><type>string</type><type>float</type></type><methodname>microtime</methodname> + <methodparam choice="opt"><type>bool</type><parameter>sayı_olsun</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> <function>microtime</function> işlevi geçerli Unix zaman damgasını mikrosaniye cinsinden döndürür. Bu işlev sadece gettimeofday() sistem çağrısını destekleyen işletim sistemlerinde geçerlidir. </para> + <para> + Başarımı ölçmek için <function>hrtime</function> önerilir. + </para> </refsect1> <refsect1 role="parameters"> @@ -26,15 +29,9 @@ <para> <variablelist> <varlistentry> - <term><parameter>gerçek_sayı</parameter></term> + <term><parameter>sayı_olsun</parameter></term> <listitem> <para> - İşlev, isteğe bağlı olarak değiştirgesiz çağırıldığında; "msan. san." - dizgesini döndürür. 'san.' geçerli zamanın Unix Zamam Başlangıcından (1 - Ocak 1970 0:00:00 GMT) itibaren hesaplanan saniyeyi ve 'msan.' ise - mikrosaniye kısmını belirtir. Dizgenin iki kısmı da saniye cinsindendir. - </para> - <para> İsteğe bağlı kullanılan bu değiştirgeyle &true; aktarıldığında, saniyeler <type>float</type> türünde döndürülür. </para> @@ -44,28 +41,20 @@ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>gerçek_sayı</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + İşlev, isteğe bağlı olarak değiştirgesiz çağırıldığında; "msan. san." + dizgesini döndürür. 'san.' geçerli zamanın Unix Zamam Başlangıcından (1 + Ocak 1970 0:00:00 GMT) itibaren hesaplanan saniyeyi ve 'msan.' ise + mikrosaniye kısmını belirtir. Dizgenin iki kısmı da saniye cinsindendir. </para> + <para> + <parameter>sayı_olsun</parameter> &true; ise, + <function>microtime</function> Unix Zamam Başlangıcından itibaren + en yakın mikrosaniyeye kadar doğrulukta saniye cinsinden geçerli + zamanı gösteren <type>float</type> türünde bir sayı döndürür. + </para> </refsect1> <refsect1 role="examples"> @@ -116,6 +105,23 @@ echo "Bekleme süresi: $sure saniye.\n"; ]]> </programlisting> </example> + <example> + <title><function>microtime</function> and <literal>REQUEST_TIME_FLOAT</literal> (as of PHP 5.4.0)</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Uyuma süresi için rasgele sayı üret +usleep(mt_rand(100, 10000)); + +// PHP 5.4.0 ve sonrasında, REQUEST_TIME_FLOAT $_SERVER süper küresel dizisinde bulunur. +// Mikrosaniyelik doğrulukta isteğin zaman damgasını içerir +$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"]; + +echo "$time saniyede hiçbir şey olmadı.\n"; +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -124,6 +130,7 @@ echo "Bekleme süresi: $sure saniye.\n"; <para> <simplelist> <member><function>time</function></member> + <member><function>hrtime</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml index caf201eb..02461b14 100644 --- a/reference/datetime/functions/strptime.xml +++ b/reference/datetime/functions/strptime.xml @@ -1,131 +1,130 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 74da59644d9fd77a45e5ab62ed30a689c13fff27 Maintainer: behzat Status: ready --> - <refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>strptime</refname> - <refpurpose> - <function>strftime</function> işleviyle üretilen zaman ve tarihleri - çözümler - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>strptime</methodname> - <methodparam><type>string</type><parameter>tarih</parameter></methodparam> - <methodparam><type>string</type><parameter>biçim</parameter></methodparam> - </methodsynopsis> - <para> - <function>strptime</function> işlevi çözümlenmiş - <parameter>tarih</parameter> değiştirgesini bir diziyle döndürür. Hata - durumlarındaysa &false; değeriyle döner. - </para> - <para> - Ay, gün isimleri ve yerel ayarlarıyla ilgili dile bağımlı diğer dizgeler - (<constant>LC_TIME</constant>), <function>setlocale</function> işleviyle - ayarlanır. - </para> - </refsect1> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> +<refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strptime</refname> + <refpurpose> + <function>strftime</function> işleviyle üretilen zaman ve tarihleri + çözümler + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname> + <methodparam><type>string</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam><type>string</type><parameter>biçim</parameter></methodparam> + </methodsynopsis> + <para> + <function>strptime</function> işlevi çözümlenmiş + <parameter>zaman_damgası</parameter> değiştirgesini bir diziyle döndürür. + Hata durumlarındaysa &false; değeriyle döner. + </para> + <para> + Ay, gün isimleri ve yerel ayarlarıyla ilgili dile bağımlı diğer dizgeler + (<constant>LC_TIME</constant>), <function>setlocale</function> işleviyle + ayarlanır. + </para> + </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>tarih</parameter></term> - <listitem> - <para> - Çözümlenen dizge (ör. <function>strftime</function> işlevinden dönen - değer) - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>biçim</parameter></term> - <listitem> - <para> - <parameter>tarih</parameter> değiştirgesinde kullanılan biçim - (ör. <function>strftime</function> işlevinde kullanılanla aynı). - </para> - <para> - Biçimlendirme seçenekleri hakkında daha fazla bilgi için + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>zaman_damgası</parameter> (<type>string</type>)</term> + <listitem> + <para> + Çözümlenecek dizge (ör. <function>strftime</function> işlevinden dönen + değer) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>biçim</parameter> (<type>string</type>)</term> + <listitem> + <para> + <parameter>zaman_damgası</parameter> değiştirgesinde kullanılan biçim + (ör. <function>strftime</function> işlevinde kullanılanla aynı). + <function>strftime</function> için mevcut olan bazı biçim seçeneklerinin <function>strptime</function> içinde herhangi bir etkisi olmayabileceğini unutmayın; Desteklenen tam alt küme, işletim sistemine ve kullanılan C kütüphanesine bağlı olarak değişecektir. + </para> + <para> + Biçimlendirme seçenekleri hakkında daha fazla bilgi için <function>strftime</function> sayfasını okuyun. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Dizi döndürür. Hata durumlarında &false; değeriyle döner. - </para> - - <para> - <table> - <title>Diziyle dönen değerler</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Değiştirge</entry> - <entry>Açıklama</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>"tm_sec"</literal></entry> - <entry>Saniye (0-61)</entry> - </row> - <row> - <entry><literal>"tm_min"</literal></entry> - <entry>Dakika (0-59)</entry> - </row> - <row> - <entry><literal>"tm_hour"</literal></entry> - <entry>Saat (0-23)</entry> - </row> - <row> - <entry><literal>"tm_mday"</literal></entry> - <entry>Gün (1-31)</entry> - </row> - <row> - <entry><literal>"tm_mon"</literal></entry> - <entry>Ay (0-11)</entry> - </row> - <row> - <entry><literal>"tm_year"</literal></entry> - <entry>1900'den itibaren yıllar</entry> - </row> - <row> - <entry><literal>"tm_wday"</literal></entry> - <entry>Pazar'dan itibaren hafta günleri (0-6)</entry> - </row> - <row> - <entry><literal>"tm_yday"</literal></entry> - <entry>Ocak 1'den itibaren günler (0-365)</entry> - </row> - <row> - <entry><literal>"unparsed"</literal></entry> - <entry><parameter>tarih</parameter> değiştirgesinin bilinmeyen - <parameter>biçim</parameter> değiştirgesi kullanımından dönen - değer</entry> - </row> - </tbody> - </tgroup> - </table> - </para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> - </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Dizi döndürür. Hata durumlarında &false; değeriyle döner. + </para> + <para> + <table> + <title>Diziyle dönen değerler</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Değiştirge</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"tm_sec"</literal></entry> + <entry>Saniye (0-61)</entry> + </row> + <row> + <entry><literal>"tm_min"</literal></entry> + <entry>Dakika (0-59)</entry> + </row> + <row> + <entry><literal>"tm_hour"</literal></entry> + <entry>Saat (0-23)</entry> + </row> + <row> + <entry><literal>"tm_mday"</literal></entry> + <entry>Gün (1-31)</entry> + </row> + <row> + <entry><literal>"tm_mon"</literal></entry> + <entry>Ay (0-11)</entry> + </row> + <row> + <entry><literal>"tm_year"</literal></entry> + <entry>1900'den itibaren yıllar</entry> + </row> + <row> + <entry><literal>"tm_wday"</literal></entry> + <entry>Pazar'dan itibaren hafta günleri (0-6)</entry> + </row> + <row> + <entry><literal>"tm_yday"</literal></entry> + <entry>Ocak 1'den itibaren günler (0-365)</entry> + </row> + <row> + <entry><literal>"unparsed"</literal></entry> + <entry><parameter>tarih</parameter> değiştirgesinin bilinmeyen + <parameter>biçim</parameter> değiştirgesi kullanımından dönen + değer</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>- <function>strptime</function> örneği</title> - <programlisting role="php"> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>strptime</function> örneği</title> + <programlisting role="php"> <![CDATA[ <?php $biçim = '%d/%m/%Y %H:%M:%S'; @@ -136,9 +135,9 @@ echo "$strf\n"; print_r(strptime($strf, $biçim)); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ 03/10/2004 15:54:19 @@ -155,33 +154,52 @@ Array [unparsed] => ) ]]> - </screen> - </example> - </para> - </refsect1> + </screen> + </example> + </para> + </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - ¬e.no-windows; - <note> - <para> - <literal>"tm_sec"</literal> "artık saniyeleri" de içerir (yılda 2 - saniyeye kadar). Artık saniyeler hakkında bilgi edinmek için <link - xlink:href="http://tr.wikipedia.org/wiki/Artık_saniye">Wikipedia artık - saniyeler makalesine</link> bakınız. - </para> - </note> - </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.no-windows; + <note> + <para> + Dahili olarak, bu işlev sistemin C kütüphanesi tarafından sağlanan + <literal>strptime()</literal> işlevini çağırır. Bu işlev, farklı işletim + sistemlerinde fark edilir ölçüde farklı davranışlar sergileyebilir. Bu + sorunlardan etkilenmeyen <function>date_parse_from_format</function> + işlevinin PHP 5.3.0 ve sonrasında kullanılması önerilir + </para> + </note> + <note> + <para> + <literal>"tm_sec"</literal> "artık saniyeleri" de içerir (yılda 2 + saniyeye kadar). Artık saniyeler hakkında bilgi edinmek için <link + xlink:href="http://tr.wikipedia.org/wiki/Artık_saniye">Wikipedia artık + saniyeler makalesine</link> bakınız. + </para> + </note> + <note> + <para> + PHP 5.2.0 öncesinde, bu işlev tanımsız davranışlar döndürebiliyordu. + Özellikle <literal>"tm_sec"</literal>, <literal>"tm_min"</literal> ve + <literal>"tm_hour"</literal> girdileri tanımsız değerler döndürürdü. + </para> + </note> + </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>strftime</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>checkdate</function></member> + <member><function>strftime</function></member> + <member><function>date_parse_from_format</function></member> + <member><function>DateTime::createFromFormat</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: diff --git a/reference/datetime/functions/time.xml b/reference/datetime/functions/time.xml index e92817cc..5058c696 100644 --- a/reference/datetime/functions/time.xml +++ b/reference/datetime/functions/time.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 9edaff269c660085fd710bea5ee099e284c025e4 Maintainer: behzat Status: ready --> <refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>time</refname> diff --git a/reference/datetime/functions/timezone-name-from-abbr.xml b/reference/datetime/functions/timezone-name-from-abbr.xml index d0caa8ef..99ed9fae 100644 --- a/reference/datetime/functions/timezone-name-from-abbr.xml +++ b/reference/datetime/functions/timezone-name-from-abbr.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: behzat Status: ready --> <refentry xml:id="function.timezone-name-from-abbr" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>timezone_name_from_abbr</refname> @@ -9,10 +9,10 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>timezone_name_from_abbr</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>timezone_name_from_abbr</methodname> <methodparam><type>string</type><parameter>kısaltma</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>gmt_farkı</parameter><initializer>-1</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ysu_var</parameter><initializer>-1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>utc_farkı</parameter><initializer>-1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>gys_var</parameter><initializer>-1</initializer></methodparam> </methodsynopsis> </refsect1> @@ -29,10 +29,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> - Yerel saatin GMT'ye göre saniye cinsinden farkı. Varsayılan değer, + Yerel saatin UTC'ye göre saniye cinsinden farkı. Varsayılan değer, <parameter>kısaltma</parameter> değiştirgesinin karşılığı olarak bulunan ilk zaman diliminin döndürüleceği anlamına gelen -1'dir. Yoksa, farka uyan zaman dilimi aranır ve bulunamadığı durumlarda fark @@ -41,13 +41,18 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>ysu_var</parameter></term> + <term><parameter>gys_var</parameter></term> <listitem> <para> - Yaz saati uygulaması belirteci. Eğer <parameter>kısaltma</parameter> - değiştirgesi yoksa zaman dilimi yalnızca - <parameter>gmt_farkı</parameter> ve <parameter>ysu_var</parameter> - değiştirgelerine göre aranacaktır. + Gün ışığından yararlanma saati göstergesi. Öntanımlı değer -1 olup + arama sırasında zaman diliminin gün ışığından yararlanma özelliğinin + olup olmadığının dikkate alınmadığı anlamına gelir. Bu 1 olarak + ayarlanırsa, <parameter>utc_farkı</parameter>'nın etkin gün ışığından + yararlanma farkını içerdiği varsayılır; 0 ise, + <parameter>utc_farkı</parameter> gün ışığından yararlanma farkını + içermiyor demektir. <parameter>kısaltma</parameter> yoksa, zaman + dilimi yalnızca <parameter>utc_farkı</parameter> ve + <parameter>gys_var</parameter> değiştirgelerine göre aranacaktır. </para> </listitem> </varlistentry> @@ -58,7 +63,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda zaman dilimini adını, başarısız olduğunda &false; döndürür. + Başarılı olduğunda zaman diliminin adını, başarısız olduğunda &false; döndürür. </para> </refsect1> diff --git a/reference/dio/functions/dio-fcntl.xml b/reference/dio/functions/dio-fcntl.xml index 46811fbe..0101eb0d 100644 --- a/reference/dio/functions/dio-fcntl.xml +++ b/reference/dio/functions/dio-fcntl.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 094906da54e6b9296c52505026c0f6a3fe68f6a6 Maintainer: nilgun Status: ready --> <refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dio_fcntl</refname> @@ -56,7 +56,7 @@ <listitem> <para> <constant>F_GETLK</constant> - Birileri kilidin tutulmasını - engelliyorsa <function>dio_fcntl</function> işlevi (yukarıda + engelliyorsa <function>dio_fcntl</function> işlevi (aşağıda açıklandığı gibi) bir ilişkisel dizi ile döner. Hiçbir engelleme anahtarı yoksa "tür" olarak <constant>F_UNLCK</constant> atanır. </para> @@ -92,25 +92,26 @@ <itemizedlist> <listitem> <para> - "start" - kilidin başlangıç konumu + <literal>start</literal> - kilidin başlangıç konumu </para> </listitem> <listitem> <para> - "length" - kilitli alanın boyu; sıfır, dosyanın sonuna kadar + <literal>length</literal> - kilitli alanın boyu; sıfır, dosyanın sonuna kadar demektir. </para> </listitem> <listitem> <para> - "wenth" - l_start'ın göreli olduğu yer: + <literal>whence</literal> - l_start'ın göreli olduğu yer: <constant>SEEK_SET</constant>, <constant>SEEK_END</constant> ve <constant>SEEK_CUR</constant> olabilir. </para> </listitem> <listitem> <para> - "type" - kilit türü: <constant>F_RDLCK</constant> (okuma kilidi), + <literal>type</literal> - kilit türü: + <constant>F_RDLCK</constant> (okuma kilidi), <constant>F_WRLCK</constant> (yazma kilidi) veya <constant>F_UNLCK</constant> (kilidi aç) olabilir. </para> diff --git a/reference/dio/functions/dio-open.xml b/reference/dio/functions/dio-open.xml index 83b5cfa1..9cd3deab 100644 --- a/reference/dio/functions/dio-open.xml +++ b/reference/dio/functions/dio-open.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.dio-open" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dio_open</refname> @@ -104,13 +104,13 @@ <para> <parameter>seçenekler</parameter> değiştirgesine <constant>O_CREAT</constant> atanmışsa dosya kipi (oluşturma izinleri) - <parameter>kip</parameter> değiştirgesinde belirtildiği gibi ayarlanır. - <parameter>kip</parameter> olarak <constant>O_CREAT</constant> - belirtilmişse <parameter>kip</parameter> doğru işlem için gereklidir, - yoksa yok sayılır. + <parameter>kip</parameter> değiştirgesinde belirtildiği gibi + ayarlanır. <parameter>seçenekler</parameter> değiştirgesine + <constant>O_CREAT</constant> belirtilmişse <parameter>kip</parameter> + doğru işlem için gereklidir, yoksa yok sayılır. </para> <para> - Oluşturlacak dosyaya atanacak asıl izinler, normal olarak sürecin + Oluşturulacak dosyaya atanacak asıl izinler, normal olarak sürecin <emphasis>umask</emphasis> değerinden etkilenir. </para> </listitem> diff --git a/reference/dir/functions/chroot.xml b/reference/dir/functions/chroot.xml index b58adb3a..1686f4f6 100644 --- a/reference/dir/functions/chroot.xml +++ b/reference/dir/functions/chroot.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 27ca68ce995137de25ff8c53b28d382477ade597 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.11 --> <refentry xml:id="function.chroot" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -15,12 +15,13 @@ <methodparam><type>string</type><parameter>dizin</parameter></methodparam> </methodsynopsis> <para> - Geçerli sürecin kök dizinini <parameter>dizin</parameter> yapar. + Geçerli sürecin kök dizinini <parameter>dizin</parameter>, geçerli çalışma + dizinini "/" yapar. </para> <para> - Bu işlev sadece sisteminiz kendisini destekliyorsa ve CLI, CGI veya gömülü + Bu işlev sadece GNU ve BSD sistemlerinde ve sadece CLI, CGI veya gömülü SAPI kullanıyorsanız kullanılabilir. Ayrıca, bu işlevin kullanılabilmesi - için sürecin root aidiyetinde çalışması gerekir. + için sürecin root yetkileriyle çalışması gerekir. </para> </refsect1> @@ -32,7 +33,7 @@ <term><parameter>dizin</parameter></term> <listitem> <para> - Yeni kök dizin. + Kök dizin haline getirilecek dizin. </para> </listitem> </varlistentry> @@ -47,9 +48,32 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example><title>- <function>chroot</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +chroot("/burası/kök/dizin/olacak/"); +echo getcwd(); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +/ +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.no-windows; + ¬e.no-zts; </refsect1> </refentry> diff --git a/reference/dir/functions/getcwd.xml b/reference/dir/functions/getcwd.xml index 04aa4063..5a25d533 100644 --- a/reference/dir/functions/getcwd.xml +++ b/reference/dir/functions/getcwd.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 6f540a4bf2b3c2e2271022d0a31efa1a3036677c Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 --> <refentry xml:id="function.getcwd" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>getcwd</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>getcwd</methodname> <void/> </methodsynopsis> <para> @@ -27,11 +27,24 @@ <para> Bazı Unix türevlerinde, üst dizinlere erişim izni yoksa <function>getcwd</function> işlevi &false; döndürür. Erişim izinleri ve - kipler hakkında daha ayrıntılı bilgi için <function>chmod</function> işlevine - bakınız. + kipler hakkında daha ayrıntılı bilgi için <function>chmod</function> + işlevine bakınız. </para> </refsect1> + <refsect1 role="notes"> + <caution> + <para> + PHP yorumlayıcısı ZTS (Zend Güvenilir Evreleri) etkinken derlenmişse, + <function>getcwd</function> tarafından döndürülen geçerli çalışma dizini, + işletim sistemi arayüzleri tarafından döndürülen dizinden farklı + olabilir. Geçerli çalışma dizinine bağımlı olan harici kütüphaneler + (<link linkend="book.ffi">FFI</link> aracılığıyla çağrılan) bundan + etkilenecektir. + </para> + </caution> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/dir/functions/opendir.xml b/reference/dir/functions/opendir.xml index 8b7c7fe9..f722941d 100644 --- a/reference/dir/functions/opendir.xml +++ b/reference/dir/functions/opendir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 53b6f116ed5f8649ca540c38dfe0ce30619d0dd9 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.opendir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>resource</type><methodname>opendir</methodname> + <type class="union"><type>resource</type><type>false</type></type><methodname>opendir</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter></methodparam> </methodsynopsis> @@ -51,50 +51,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda dizin tanıtıcısı ile aksi takdirde &false; değeriyle - döner. - </para> - <para> - Eğer belirtilen <parameter>dizin</parameter> bir dizin değilse veya erişim - izinlerinin yetersizliğinden dolayı dizin açılamamışsa ya da bir dosya - sistemi hatası oluşmuşsa işlev &false; ile döner ve - <link linkend="errorfunc.constants">E_WARNING</link> seviyesinde bir - hata üretilir. Hata iletisinin çıktılanmasını işlev isminin başına bir - '<link linkend="language.operators.errorcontrol">@</link>' karakteri - ekleyerek engelleyebilirsiniz. + Başarılı olduğunda dizin tanıtıcısı,&return.falseforfailure;. </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>dizin</parameter> değiştirgesinde <literal>ftp://</literal> - sarmalayıcısı da kabul edilmeye başlandı. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - <parameter>dizin</parameter> değiştirgesinde dizin listelemeyi - destekleyen URL'ler belirtilebilir oldu. Ancak, PHP 4 sadece - <literal>file://</literal> sarmalayıcısını desteklemektedir. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + <parameter>dizin</parameter> geçerli bir dizin değilse, dizin yetki + yetersizliğinden ya da dosya sistemi hatalarından dolayı açılamıyorsa, + bu olur. </para> </refsect1> diff --git a/reference/dir/functions/readdir.xml b/reference/dir/functions/readdir.xml index 1e7d96f3..6679043d 100644 --- a/reference/dir/functions/readdir.xml +++ b/reference/dir/functions/readdir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: f658721332c6080e237ed6a1c29517225237b639 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.readdir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,11 +11,11 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>readdir</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>readdir</methodname> <methodparam choice="opt"><type>resource</type><parameter>dizin_tanıtıcısı</parameter></methodparam> </methodsynopsis> <para> - Dizindeki sonraki dosyanın ismi ile döner. Dosya isimleri dosya sisteminde + Dizindeki sonraki girdinin ismi ile döner. Girdiler dosya sisteminde saklandıkları sıra ile döndürülür. </para> </refsect1> @@ -41,7 +41,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda dosya ismi ile aksi takdirde &false; değeriyle döner. + Başarılı olduğunda dosya ismi ile,&return.falseforfailure;.. </para> &return.falseproblem; </refsect1> @@ -62,20 +62,18 @@ <programlisting role="php"> <![CDATA[ <?php -// 4.0.0-RC2 sürümüne kadar !== işlecinin kullanılamadığına dikkat edin - if ($dizin = opendir('/bir/dizin/dosyalar')) { echo "Dizin tanıtıcısı: $dizin\n"; echo "Dizin içeriği:\n"; /* Dizin içeriğini taramak için doğru yöntem. */ - while (false !== ($dosya = readdir($dizin))) { - echo "$dosya\n"; + while (false !== ($girdi = readdir($dizin))) { + echo "$girdi\n"; } /* Dizin içeriğini taramak için YANLIŞ yöntem. */ - while ($dosya = readdir($dizin)) { - echo "$dosya\n"; + while ($girdi = readdir($dizin)) { + echo "$girdi\n"; } closedir($dizin); @@ -93,9 +91,9 @@ if ($dizin = opendir('/bir/dizin/dosyalar')) { <![CDATA[ <?php if ($dizin = opendir('.')) { - while (false !== ($dosya= readdir($dizin))) { - if ($dosya != "." && $dosya != "..") { - echo "$dosya\n"; + while (false !== ($girdi = readdir($dizin))) { + if ($girdi != "." && $girdi != "..") { + echo "$girdi\n"; } } closedir($dizin); diff --git a/reference/dir/functions/rewinddir.xml b/reference/dir/functions/rewinddir.xml index 9abd3997..a0971b95 100644 --- a/reference/dir/functions/rewinddir.xml +++ b/reference/dir/functions/rewinddir.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 --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.rewinddir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -38,6 +38,14 @@ </variablelist> </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.nullorfalse; + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/dir/functions/scandir.xml b/reference/dir/functions/scandir.xml index d4f7cd6b..9633bc67 100644 --- a/reference/dir/functions/scandir.xml +++ b/reference/dir/functions/scandir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: nilgun Status: ready --> <refentry xml:id="function.scandir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>scandir</refname> @@ -13,7 +13,7 @@ <methodsynopsis> <type>array</type><methodname>scandir</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>sıralama_türü</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sıralama_türü</parameter><initializer>SCANDIR_SORT_ASCENDING</initializer></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter></methodparam> </methodsynopsis> <para> @@ -40,8 +40,9 @@ <listitem> <para> Abecesel olarak küçükten büyüğe sıralama öntanımlıdır. Bu değiştirgeye - sıfırdan farklı bir değer atarsanız sıralama büyükten küçüğe doğru - yapılır. + <constant>SCANDIR_SORT_DESCENDING</constant> atarsanız sıralama + büyükten küçüğe doğru yapılır. <constant>SCANDIR_SORT_NONE</constant> + atanırsa sonuç sıralanmaz. </para> </listitem> </varlistentry> @@ -108,52 +109,6 @@ Array </screen> </example> </para> - <para> - <example> - <title>- PHP 4 için <function>scandir</function> örneği</title> - <programlisting role="php"> -<![CDATA[ -<?php -$dir = "/tmp"; -$dh = opendir($dir); -while (false !== ($filename = readdir($dh))) { - $files[] = $filename; -} - -sort($files); - -print_r($files); - -rsort($files); - -print_r($files); - -?> -]]> - </programlisting> - &example.outputs.similar; - <screen> -<![CDATA[ -Array -( - [0] => . - [1] => .. - [2] => bar.php - [3] => foo.txt - [4] => somedir -) -Array -( - [0] => somedir - [1] => foo.txt - [2] => bar.php - [3] => .. - [4] => . -) -]]> - </screen> - </example> - </para> </refsect1> <refsect1 role="notes">
diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml index 4a1e221c..c5ebb5b4 100644 --- a/language/basic-syntax.xml +++ b/language/basic-syntax.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: a71742330defbc0edfbc6822b4f947bf437b2f70 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: c63057033539758cb2e6ed4786c4d59b9ed059a5 Maintainer: nilgun Status: ready --> <!-- CREDITS: tpug, sezer --> <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook"> <title>Temel Sözdizimi</title> @@ -8,15 +8,15 @@ <title>PHP etiketleri</title> <para> PHP bir dosyayı çözümlerken, hangi bölümü yorumlayıp hangi bölümü - yorumlamadan geçeceğine karar vermek için <literal><?php</literal> ve - <literal>?></literal> açılış ve kapanış etiketlerine bakar. Bu şekilde - çözümleme PHP'nin her çeşit farklı belgeye gömülmesini sağlar, çünkü bir - çift açılış ve kapanış etiketinin dışındaki her şey PHP çözümleyicisi + yorumlamadan geçeceğine karar vermek için <literal><?php</literal> ve + <literal>?></literal> açılış ve kapanış etiketlerine bakar. Bu şekilde + çözümleme PHP'nin her çeşit farklı belgeye gömülmesini sağlar, çünkü bir + çift açılış ve kapanış etiketinin dışındaki her şey PHP çözümleyicisi tarafından gözardı edilir. </para> - + <para> - PHP daha açıklayıcı olan <code><?php echo</code> etiketine bir kısaltma olarak + PHP daha açıklayıcı olan <code><?php echo</code> etiketine bir kısaltma olarak <literal><?=</literal> kısa echo etiketini içerir. </para> @@ -40,26 +40,26 @@ <para> PHP ayrıca kısa başlangıç etiketine de <literal><?</literal> izin verir. - Bu sadece, PHP <option>--enable-short-tags</option> yapılandırma seçeneği ile - derlenerek veya &php.ini; yapılandırma dosyası yönergesi <link - linkend="ini.short-open-tag">short_open_tag</link> kullanılarak + Bu sadece, PHP <option>--enable-short-tags</option> yapılandırma seçeneği ile + derlenerek veya &php.ini; yapılandırma dosyası yönergesi <link + linkend="ini.short-open-tag">short_open_tag</link> kullanılarak etkinleştirilebilir. </para> - - <para> + + <para> <note> <para> - Kısa etiketler iptal edilebileceğinden uyumluluk adına sadece normal etiketlerin + Kısa etiketler iptal edilebileceğinden uyumluluk adına sadece normal etiketlerin (<code><?php ?></code> ve <code><?= ?></code>) kullanılması önerilir. </para> </note> </para> <para> - Bir dosya sadece PHP kodu içeriyorsa, dosyanın sonunda PHP kapanış etiketini koymamak - tercih edilir. Yazılımcıdan herhangi bir çıktı gönderme isteği gelmezse PHP - betiğin bu noktasında çıktı tamponlamasını başlatacağından kapama etiketinden - sonra istenmeyen etkilere neden olabilecek boşluk veya yeni satırların + Bir dosya sadece PHP kodu içeriyorsa, dosyanın sonunda PHP kapanış etiketini koymamak + tercih edilir. Yazılımcıdan herhangi bir çıktı gönderme isteği gelmezse PHP + betiğin bu noktasında çıktı tamponlamasını başlatacağından kapama etiketinden + sonra istenmeyen etkilere neden olabilecek boşluk veya yeni satırların yanlışlıkla eklenmesi böylece engellenmiş olur. <informalexample> <programlisting role="php"> @@ -77,13 +77,13 @@ echo "İletişimin sonu"; </informalexample> </para> </sect1> - + <sect1 xml:id="language.basic-syntax.phpmode"> <title>HTML'den Kaçmak</title> <para> Başlangıç ve bitiş etiketlerinin dışında kalan her şey PHP çözümleyicisi - tarafından gözardı edilerek PHP dosyalarının karışık içeriğe sahip olabilmesi - sağlanır. Çoğu zaman, bu örnekte olduğu gibi PHP'nin HTML içine gömülmüş + tarafından gözardı edilerek PHP dosyalarının karışık içeriğe sahip olabilmesi + sağlanır. Çoğu zaman, bu örnekte olduğu gibi PHP'nin HTML içine gömülmüş olduğunu göreceksiniz. <informalexample> <programlisting role="php"> @@ -94,12 +94,12 @@ echo "İletişimin sonu"; ]]> </programlisting> </informalexample> - Bu beklendiği gibi çalışır, çünkü PHP çözümleyicisi ?> kapanış etiketine - rastlayınca (hemen ardından bir satırsonu karakteri gelmesi durumu hariç - - bak: <link linkend="language.basic-syntax.instruction-separation">deyim - ayırma</link>) başka bir açılış etiketine rastlayıncaya kadar (etiketin koşullu - bir ifadenin ortasında olması durumu hariç - bu durumda çözümleyici neyin - atlanacağına karar vermek için ifadenin sonucun saptamaya çalışacaktır) herşeyi + Bu beklendiği gibi çalışır, çünkü PHP çözümleyicisi ?> kapanış etiketine + rastlayınca (hemen ardından bir satırsonu karakteri gelmesi durumu hariç - + bak: <link linkend="language.basic-syntax.instruction-separation">deyim + ayırma</link>) başka bir açılış etiketine rastlayıncaya kadar (etiketin koşullu + bir ifadenin ortasında olması durumu hariç - bu durumda çözümleyici neyin + atlanacağına karar vermek için ifadenin sonucun saptamaya çalışacaktır) herşeyi çıktılamaya başlar. Aşağıdaki örneğe bakınız: </para> <para> @@ -117,8 +117,8 @@ echo "İletişimin sonu"; ]]> </programlisting> </example> - Bu örnekte PHP, açılış/kapanış etiketlerinin dışında olsa bile koşulun - karşılanmadığı blokları atlayacaktır, çünkü PHP yorumlayıcısı koşulun + Bu örnekte PHP, açılış/kapanış etiketlerinin dışında olsa bile koşulun + karşılanmadığı blokları atlayacaktır, çünkü PHP yorumlayıcısı koşulun karşılanmadığı durumda koşulun içinde bulunan blokları atlar. </para> <para> @@ -147,7 +147,7 @@ echo "İletişimin sonu"; noktalı virgül koymak zorunda değilsiniz. Kapanış etiketi aynı zamanda satırsonu karakterini de kendisi ekleyecektir. </para> - + <para> <example> <title>- Sondaki satırsonu karakterini kapsayan kapanış etiketini gösteren örnek</title> @@ -166,9 +166,9 @@ Ama şimdi var </screen> </example> </para> - + <para> - PHP ayrıştırıcısına girme ve çıkma örnekleri: + PHP ayrıştırıcısına girme ve çıkma örnekleri: <informalexample> <programlisting role="php"> <![CDATA[ @@ -196,7 +196,7 @@ Ama şimdi var </note> </para> </sect1> - + <sect1 xml:id="language.basic-syntax.comments"> <title>Açıklamalar</title> <para> diff --git a/reference/datetime/functions/gettimeofday.xml b/reference/datetime/functions/gettimeofday.xml index 4d25ca7b..11dd34d5 100644 --- a/reference/datetime/functions/gettimeofday.xml +++ b/reference/datetime/functions/gettimeofday.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> <refentry xml:id="function.gettimeofday" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gettimeofday</refname> @@ -10,8 +10,8 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>gettimeofday</methodname> - <methodparam choice="opt"><type>bool</type><parameter>sayı_döndür</parameter></methodparam> + <type class="union"><type>array</type><type>float</type></type><methodname>gettimeofday</methodname> + <methodparam choice="opt"><type>bool</type><parameter>sayı_döndür</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> gettimeofday(2) işlevinin arayüzüdür. Sistem çağrısıdan @@ -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>5.1.0</entry> - <entry> - <parameter>sayı_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/datetime/functions/gmdate.xml b/reference/datetime/functions/gmdate.xml index 489520f4..e40a9531 100644 --- a/reference/datetime/functions/gmdate.xml +++ b/reference/datetime/functions/gmdate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.13 --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmdate</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>string</type><methodname>gmdate</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Zamanı, Greenwich Saatiyle (GMT) döndürmesi dışında tıpkı @@ -33,9 +33,7 @@ </para> </listitem> </varlistentry> - &date.timestamp.description; - </variablelist> </para> </refsect1> @@ -43,10 +41,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Biçimlendirilmiş tarih dizgesi döndürür. Eğer - <parameter>zaman_damgası</parameter> değiştirgesi için sayısal değer - kullanılmamışsa, &false; döndürür ve <constant>E_WARNING</constant> - seviyesinde bir hata çıktılar. + Biçimlendirilmiş tarih dizgesi döndürür. </para> </refsect1> @@ -63,22 +58,9 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> - <entry> - Zaman damgasının geçerlilik aralığı, genellikle Cum, 13 Ara 1901 - 20:45:54 GMT ile Per, 19 Oca 2038 03:14:07 GMT arasındadır. - (Bu tarih değerleri aynı zamanda en küçük ve en büyük 32 bitlik - işaretli tamsayıları temsil etmektedir.) Bununla birikte, PHP - 5.1.0'den önce bu aralık bazı sistemlerde (ör: Windows) 01-01-1970 ile - 19-01-2038 arasıyla sınırlıdır. - </entry> - </row> - <row> - <entry>5.1.1</entry> + <entry>8.0.0</entry> <entry> - <parameter>biçem</parameter> değiştirgesinde kullanılabilecek standart - tarih/zaman biçem <link linkend="datetime.constants">sabitleri</link> - kullanıma girdi. + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. </entry> </row> </tbody> diff --git a/reference/datetime/functions/gmmktime.xml b/reference/datetime/functions/gmmktime.xml index ee0c97fd..fbca0842 100644 --- a/reference/datetime/functions/gmmktime.xml +++ b/reference/datetime/functions/gmmktime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 9d45296587225c85e4dab73cc27865ca32e17d3c Maintainer: behzat Status: ready --> <refentry xml:id="function.gmmktime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmmktime</refname> @@ -10,14 +10,13 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>gmmktime</methodname> - <methodparam choice="opt"><type>int</type><parameter>saat</parameter><initializer>gmdate("H")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>dakika</parameter><initializer>gmdate("i")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>saniye</parameter><initializer>gmdate("s")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ay</parameter><initializer>gmdate("n")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>gün</parameter><initializer>gmdate("j")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>yıl</parameter><initializer>gmdate("Y")</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ysu_var</parameter><initializer>-1</initializer></methodparam> + <type class="union"><type>int</type><type>false</type></type><methodname>gmmktime</methodname> + <methodparam><type>int</type><parameter>saat</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>dakika</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>saniye</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>ay</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>gün</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>yıl</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Aktarılan değiştirgelerin bir GMT tarihini belirtmesi dışında tıpkı @@ -40,7 +39,10 @@ <term><parameter>saat</parameter></term> <listitem> <para> - Saat + <parameter>ay</parameter>, <parameter>gün</parameter> ve + <parameter>yıl</parameter> tarafından saptanan günün başlangıcına + göreli saat sayısı. Negatif değerler, belirtilen günün geceyarısından + önceki saat sayısıdır. 23'ten büyük değerler ertesi güne sarkar. </para> </listitem> </varlistentry> @@ -48,7 +50,9 @@ <term><parameter>dakika</parameter></term> <listitem> <para> - Dakika + <parameter>saat</parameter>in başlangıcına göreli dakika sayısı. + Negatif dakikalar önceki saatle ilgilidir. 59'dan büyük değerler + sonraki saate sarkar. </para> </listitem> </varlistentry> @@ -56,28 +60,34 @@ <term><parameter>saniye</parameter></term> <listitem> <para> - Saniye- + <parameter>dakika</parameter>nın başlangıcına göreli saniye sayısı. + Negatif saniyeler önceki dakika ilgilidir. 59'dan büyük değerler + sonraki dakikaya sarkar. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Ay</parameter></term> + <term><parameter>ay</parameter></term> <listitem> <para> - Ay + Bir önceki yılın sonuna göre ay sayısı. 1 ila 12 arasındaki değerler, + söz konusu yılın normal takvim aylarına atıfta bulunur. 1'den küçük + değerler (negatif değerler dahil), önceki yıldaki ayları ters sırayla + gösterir, yani 0 Aralık, -1 Kasım, vb. 12'den büyük değerler, sonraki + yıl(lar)daki uygun ayı belirtir. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Gün</parameter></term> + <term><parameter>gün</parameter></term> <listitem> <para> - Gün + Önceki ayın sonuna göre gün sayısı. 1 ile 28, 29, 30 veya 31 arasındaki değerler (aya bağlı olarak) ilgili ayın normal günlerini ifade eder. 1'den küçük değerler (negatif değerler dahil) önceki ayın günlerine atıfta bulunur, bu nedenle 0, önceki ayın son günüdür, -1 ondan önceki gündür vb. İlgili ay referansındaki gün sayısından daha büyük değerler sonraki ay(lar)daki uygun günlere karşılıktır. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>Yıl</parameter></term> + <term><parameter>yıl</parameter></term> <listitem> <para> Yıl @@ -91,6 +101,11 @@ Değiştirgeler daima GMT zamanını temsil eder. <parameter>ysu_var</parameter> değiştirgesinin sonuca etkisi yoktur. </para> + <note> + <para> + Bu değiştirge PHP 7.0.0 sürümünde kaldırıldı. + </para> + </note> </listitem> </varlistentry> </variablelist> @@ -100,7 +115,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <type>integer</type> türünden Unix zaman damgası döner. + Başarı durumunda <type>int</type> türünden Unix zaman + damgası,&return.falseforfailure;. </para> </refsect1> @@ -117,11 +133,17 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> + <entry>8.0.0</entry> <entry> - PHP 5.1.0 sürümünden beri, <parameter>ysu_var</parameter> - değiştirgesinin kullanılması önerilmemektedir. Sonuç olarak, yerine - yeni zaman dilimi özellikleri kullanılmalıdır. + <parameter>saat</parameter> artık seçimlik değil. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>dakika</parameter>, <parameter>saniye</parameter>, + <parameter>ay</parameter>, <parameter>gün</parameter> ve + <parameter>yıl</parameter> artık &null; olabiliyor. </entry> </row> </tbody> @@ -134,11 +156,12 @@ &reftitle.examples; <para> <example> - <title>- Windows üzerinde <function>gmmktime</function> işlevi</title> + <title>- <function>gmmktime</function> temel örneği</title> <programlisting role="php"> <![CDATA[ <?php -gmmktime(0, 0, 0, 1, 1, 1970); // GMT ve batıda geçerli, doğuda geçersiz +// Çıktısı: July 1, 2000 is on a Saturday +echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000)); ?> ]]> </programlisting> diff --git a/reference/datetime/functions/gmstrftime.xml b/reference/datetime/functions/gmstrftime.xml index 9d5c2bc9..e082cce4 100644 --- a/reference/datetime/functions/gmstrftime.xml +++ b/reference/datetime/functions/gmstrftime.xml @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>gmstrftime</refname> - <refpurpose>Yerel ayarlara göre tarih ve saati, GMT/UTC türüne çevirir + <refpurpose>Yerel ayarlara göre tarih ve saati, UTC türüne çevirir </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>gmstrftime</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> - Zamanı, Greenwich Saatiyle (GMT) döndürmesi dışında tıpkı - <function>strftime</function> işlevi gibi davranır. Örneğin, - Doğu Standart Zamanınında (GMT -0500) çalıştırıldığında, aşağıdaki örneğin - ilk satırı "Ara 31 1998 20:00:00" basarken ikinci satırı "Oca 01 1999 - 01:00:00" basar. + UTC zamanı döndürmesi dışında <function>strftime</function> işlevi gibi + davranır. Örneğin, Doğu Standart Zamanınında (UTC -0500) + çalıştırıldığında, aşağıdaki örneğin ilk satırı "Ara 31 1998 20:00:00" + basarken ikinci satırı "Oca 01 1999 01:00:00" basar. </para> </refsect1> @@ -46,9 +45,33 @@ <para> İstenilen biçime göre verilen <parameter>zaman_damgası</parameter> değiştirgesini ya da zaman damgası değiştirgesi kullanılmamışsa yerel - zamanı; biçimlendirilmiş dizge olarak döndürür. Ay ve hafta günlerinin - isimleri ve diğer dile bağımlı dizgelerle ilgili geçerli yereller - <function>setlocale</function> işlevi ile ayarlanabilir. + zamanı; biçimlendirilmiş dizge olarak döndürür,&return.falseforfailure;. + Ay ve hafta günlerinin isimleri ve diğer dile bağımlı dizgelerle ilgili + geçerli yereller <function>setlocale</function> işlevi ile ayarlanabilir. + </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> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> diff --git a/reference/datetime/functions/localtime.xml b/reference/datetime/functions/localtime.xml index de5c3aad..bec9a8cc 100644 --- a/reference/datetime/functions/localtime.xml +++ b/reference/datetime/functions/localtime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>localtime</refname> @@ -11,8 +11,8 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>localtime</methodname> - <methodparam choice="opt"><type>int</type><parameter>zamandamgası</parameter><initializer>time()</initializer></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>ilişkisel_mi</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>ilişkisel</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> <function>localtime</function> işlevi, standart C işlev çağrısı olan localtime tarafından döndürülen yapıya eşdeğer bir dizi döndürür. @@ -23,11 +23,9 @@ &reftitle.parameters; <para> <variablelist> - &date.timestamp.description; - <varlistentry> - <term><parameter>ilişkisel_mi</parameter></term> + <term><parameter>ilişkisel</parameter></term> <listitem> <para> Eğer değiştirge &false; olarak ayarlanmış ya da kullanılmamışsa, @@ -41,25 +39,22 @@ <itemizedlist> <listitem> <simpara> - "tm_sec" - saniye + "tm_sec" - saniye, <literal>0</literal> - <literal>59</literal> </simpara> </listitem> <listitem> <simpara> - "tm_min" - dakika + "tm_min" - dakika, <literal>0</literal> - <literal>59</literal> </simpara> </listitem> <listitem> <simpara> - "tm_hour" - saat + "tm_hour" - saat, <literal>0</literal> - <literal>23</literal> </simpara> </listitem> <listitem> <simpara> - "tm_mday" - ayın günleri - </simpara> - <simpara> - Aylar, 0'dan (Ocak) 11'e (Aralık) ve haftanın günleri 0'dan (Paz) 6'ya (Cmt). + "tm_mday" - ayın günleri, <literal>1</literal> - <literal>31</literal> </simpara> </listitem> <listitem> @@ -69,23 +64,27 @@ </listitem> <listitem> <simpara> - "tm_year" - Yıllar, başlangıç 1900 kabul edilir + "tm_year" - Yıllar,, <literal>0</literal> (Ocak) - <literal>11</literal> (Aralık) </simpara> </listitem> <listitem> <simpara> - "tm_wday" - Haftanın günleri + "tm_wday" - Haftanın günleri, <literal>0</literal> (Paz) - <literal>6</literal> (Cts) </simpara> </listitem> <listitem> <simpara> - "tm_yday" - Yılın günleri + "tm_yday" - Yılın günleri, <literal>0</literal> - <literal>365</literal> </simpara> </listitem> <listitem> <simpara> - "tm_isdst" - Yaz saati uygulaması bilgisi + "tm_isdst" - Yaz saati etkin mi? </simpara> + <simpara> + Evet ise pozitif, hayır ise <literal>0</literal>, bilinmiyorsa + negatiftir. + </simpara> </listitem> </itemizedlist> </para> @@ -97,9 +96,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -114,9 +111,12 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -171,6 +171,14 @@ Array </example> </para> </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>getdate</function></member> + </simplelist> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/datetime/functions/microtime.xml b/reference/datetime/functions/microtime.xml index a7406c9a..fd198a0f 100644 --- a/reference/datetime/functions/microtime.xml +++ b/reference/datetime/functions/microtime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> <refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>microtime</refname> @@ -11,14 +11,17 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>microtime</methodname> - <methodparam choice="opt"><type>bool</type><parameter>gerçek_sayı</parameter></methodparam> + <type class="union"><type>string</type><type>float</type></type><methodname>microtime</methodname> + <methodparam choice="opt"><type>bool</type><parameter>sayı_olsun</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> <function>microtime</function> işlevi geçerli Unix zaman damgasını mikrosaniye cinsinden döndürür. Bu işlev sadece gettimeofday() sistem çağrısını destekleyen işletim sistemlerinde geçerlidir. </para> + <para> + Başarımı ölçmek için <function>hrtime</function> önerilir. + </para> </refsect1> <refsect1 role="parameters"> @@ -26,15 +29,9 @@ <para> <variablelist> <varlistentry> - <term><parameter>gerçek_sayı</parameter></term> + <term><parameter>sayı_olsun</parameter></term> <listitem> <para> - İşlev, isteğe bağlı olarak değiştirgesiz çağırıldığında; "msan. san." - dizgesini döndürür. 'san.' geçerli zamanın Unix Zamam Başlangıcından (1 - Ocak 1970 0:00:00 GMT) itibaren hesaplanan saniyeyi ve 'msan.' ise - mikrosaniye kısmını belirtir. Dizgenin iki kısmı da saniye cinsindendir. - </para> - <para> İsteğe bağlı kullanılan bu değiştirgeyle &true; aktarıldığında, saniyeler <type>float</type> türünde döndürülür. </para> @@ -44,28 +41,20 @@ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>gerçek_sayı</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + İşlev, isteğe bağlı olarak değiştirgesiz çağırıldığında; "msan. san." + dizgesini döndürür. 'san.' geçerli zamanın Unix Zamam Başlangıcından (1 + Ocak 1970 0:00:00 GMT) itibaren hesaplanan saniyeyi ve 'msan.' ise + mikrosaniye kısmını belirtir. Dizgenin iki kısmı da saniye cinsindendir. </para> + <para> + <parameter>sayı_olsun</parameter> &true; ise, + <function>microtime</function> Unix Zamam Başlangıcından itibaren + en yakın mikrosaniyeye kadar doğrulukta saniye cinsinden geçerli + zamanı gösteren <type>float</type> türünde bir sayı döndürür. + </para> </refsect1> <refsect1 role="examples"> @@ -116,6 +105,23 @@ echo "Bekleme süresi: $sure saniye.\n"; ]]> </programlisting> </example> + <example> + <title><function>microtime</function> and <literal>REQUEST_TIME_FLOAT</literal> (as of PHP 5.4.0)</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Uyuma süresi için rasgele sayı üret +usleep(mt_rand(100, 10000)); + +// PHP 5.4.0 ve sonrasında, REQUEST_TIME_FLOAT $_SERVER süper küresel dizisinde bulunur. +// Mikrosaniyelik doğrulukta isteğin zaman damgasını içerir +$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"]; + +echo "$time saniyede hiçbir şey olmadı.\n"; +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -124,6 +130,7 @@ echo "Bekleme süresi: $sure saniye.\n"; <para> <simplelist> <member><function>time</function></member> + <member><function>hrtime</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml index caf201eb..02461b14 100644 --- a/reference/datetime/functions/strptime.xml +++ b/reference/datetime/functions/strptime.xml @@ -1,131 +1,130 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 74da59644d9fd77a45e5ab62ed30a689c13fff27 Maintainer: behzat Status: ready --> - <refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>strptime</refname> - <refpurpose> - <function>strftime</function> işleviyle üretilen zaman ve tarihleri - çözümler - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>strptime</methodname> - <methodparam><type>string</type><parameter>tarih</parameter></methodparam> - <methodparam><type>string</type><parameter>biçim</parameter></methodparam> - </methodsynopsis> - <para> - <function>strptime</function> işlevi çözümlenmiş - <parameter>tarih</parameter> değiştirgesini bir diziyle döndürür. Hata - durumlarındaysa &false; değeriyle döner. - </para> - <para> - Ay, gün isimleri ve yerel ayarlarıyla ilgili dile bağımlı diğer dizgeler - (<constant>LC_TIME</constant>), <function>setlocale</function> işleviyle - ayarlanır. - </para> - </refsect1> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: behzat Status: ready --> +<refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strptime</refname> + <refpurpose> + <function>strftime</function> işleviyle üretilen zaman ve tarihleri + çözümler + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname> + <methodparam><type>string</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam><type>string</type><parameter>biçim</parameter></methodparam> + </methodsynopsis> + <para> + <function>strptime</function> işlevi çözümlenmiş + <parameter>zaman_damgası</parameter> değiştirgesini bir diziyle döndürür. + Hata durumlarındaysa &false; değeriyle döner. + </para> + <para> + Ay, gün isimleri ve yerel ayarlarıyla ilgili dile bağımlı diğer dizgeler + (<constant>LC_TIME</constant>), <function>setlocale</function> işleviyle + ayarlanır. + </para> + </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>tarih</parameter></term> - <listitem> - <para> - Çözümlenen dizge (ör. <function>strftime</function> işlevinden dönen - değer) - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>biçim</parameter></term> - <listitem> - <para> - <parameter>tarih</parameter> değiştirgesinde kullanılan biçim - (ör. <function>strftime</function> işlevinde kullanılanla aynı). - </para> - <para> - Biçimlendirme seçenekleri hakkında daha fazla bilgi için + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>zaman_damgası</parameter> (<type>string</type>)</term> + <listitem> + <para> + Çözümlenecek dizge (ör. <function>strftime</function> işlevinden dönen + değer) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>biçim</parameter> (<type>string</type>)</term> + <listitem> + <para> + <parameter>zaman_damgası</parameter> değiştirgesinde kullanılan biçim + (ör. <function>strftime</function> işlevinde kullanılanla aynı). + <function>strftime</function> için mevcut olan bazı biçim seçeneklerinin <function>strptime</function> içinde herhangi bir etkisi olmayabileceğini unutmayın; Desteklenen tam alt küme, işletim sistemine ve kullanılan C kütüphanesine bağlı olarak değişecektir. + </para> + <para> + Biçimlendirme seçenekleri hakkında daha fazla bilgi için <function>strftime</function> sayfasını okuyun. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Dizi döndürür. Hata durumlarında &false; değeriyle döner. - </para> - - <para> - <table> - <title>Diziyle dönen değerler</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Değiştirge</entry> - <entry>Açıklama</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>"tm_sec"</literal></entry> - <entry>Saniye (0-61)</entry> - </row> - <row> - <entry><literal>"tm_min"</literal></entry> - <entry>Dakika (0-59)</entry> - </row> - <row> - <entry><literal>"tm_hour"</literal></entry> - <entry>Saat (0-23)</entry> - </row> - <row> - <entry><literal>"tm_mday"</literal></entry> - <entry>Gün (1-31)</entry> - </row> - <row> - <entry><literal>"tm_mon"</literal></entry> - <entry>Ay (0-11)</entry> - </row> - <row> - <entry><literal>"tm_year"</literal></entry> - <entry>1900'den itibaren yıllar</entry> - </row> - <row> - <entry><literal>"tm_wday"</literal></entry> - <entry>Pazar'dan itibaren hafta günleri (0-6)</entry> - </row> - <row> - <entry><literal>"tm_yday"</literal></entry> - <entry>Ocak 1'den itibaren günler (0-365)</entry> - </row> - <row> - <entry><literal>"unparsed"</literal></entry> - <entry><parameter>tarih</parameter> değiştirgesinin bilinmeyen - <parameter>biçim</parameter> değiştirgesi kullanımından dönen - değer</entry> - </row> - </tbody> - </tgroup> - </table> - </para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> - </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Dizi döndürür. Hata durumlarında &false; değeriyle döner. + </para> + <para> + <table> + <title>Diziyle dönen değerler</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Değiştirge</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"tm_sec"</literal></entry> + <entry>Saniye (0-61)</entry> + </row> + <row> + <entry><literal>"tm_min"</literal></entry> + <entry>Dakika (0-59)</entry> + </row> + <row> + <entry><literal>"tm_hour"</literal></entry> + <entry>Saat (0-23)</entry> + </row> + <row> + <entry><literal>"tm_mday"</literal></entry> + <entry>Gün (1-31)</entry> + </row> + <row> + <entry><literal>"tm_mon"</literal></entry> + <entry>Ay (0-11)</entry> + </row> + <row> + <entry><literal>"tm_year"</literal></entry> + <entry>1900'den itibaren yıllar</entry> + </row> + <row> + <entry><literal>"tm_wday"</literal></entry> + <entry>Pazar'dan itibaren hafta günleri (0-6)</entry> + </row> + <row> + <entry><literal>"tm_yday"</literal></entry> + <entry>Ocak 1'den itibaren günler (0-365)</entry> + </row> + <row> + <entry><literal>"unparsed"</literal></entry> + <entry><parameter>tarih</parameter> değiştirgesinin bilinmeyen + <parameter>biçim</parameter> değiştirgesi kullanımından dönen + değer</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>- <function>strptime</function> örneği</title> - <programlisting role="php"> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>strptime</function> örneği</title> + <programlisting role="php"> <![CDATA[ <?php $biçim = '%d/%m/%Y %H:%M:%S'; @@ -136,9 +135,9 @@ echo "$strf\n"; print_r(strptime($strf, $biçim)); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ 03/10/2004 15:54:19 @@ -155,33 +154,52 @@ Array [unparsed] => ) ]]> - </screen> - </example> - </para> - </refsect1> + </screen> + </example> + </para> + </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - ¬e.no-windows; - <note> - <para> - <literal>"tm_sec"</literal> "artık saniyeleri" de içerir (yılda 2 - saniyeye kadar). Artık saniyeler hakkında bilgi edinmek için <link - xlink:href="http://tr.wikipedia.org/wiki/Artık_saniye">Wikipedia artık - saniyeler makalesine</link> bakınız. - </para> - </note> - </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + ¬e.no-windows; + <note> + <para> + Dahili olarak, bu işlev sistemin C kütüphanesi tarafından sağlanan + <literal>strptime()</literal> işlevini çağırır. Bu işlev, farklı işletim + sistemlerinde fark edilir ölçüde farklı davranışlar sergileyebilir. Bu + sorunlardan etkilenmeyen <function>date_parse_from_format</function> + işlevinin PHP 5.3.0 ve sonrasında kullanılması önerilir + </para> + </note> + <note> + <para> + <literal>"tm_sec"</literal> "artık saniyeleri" de içerir (yılda 2 + saniyeye kadar). Artık saniyeler hakkında bilgi edinmek için <link + xlink:href="http://tr.wikipedia.org/wiki/Artık_saniye">Wikipedia artık + saniyeler makalesine</link> bakınız. + </para> + </note> + <note> + <para> + PHP 5.2.0 öncesinde, bu işlev tanımsız davranışlar döndürebiliyordu. + Özellikle <literal>"tm_sec"</literal>, <literal>"tm_min"</literal> ve + <literal>"tm_hour"</literal> girdileri tanımsız değerler döndürürdü. + </para> + </note> + </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>strftime</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>checkdate</function></member> + <member><function>strftime</function></member> + <member><function>date_parse_from_format</function></member> + <member><function>DateTime::createFromFormat</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: diff --git a/reference/datetime/functions/time.xml b/reference/datetime/functions/time.xml index e92817cc..5058c696 100644 --- a/reference/datetime/functions/time.xml +++ b/reference/datetime/functions/time.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 9edaff269c660085fd710bea5ee099e284c025e4 Maintainer: behzat Status: ready --> <refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>time</refname> diff --git a/reference/datetime/functions/timezone-name-from-abbr.xml b/reference/datetime/functions/timezone-name-from-abbr.xml index d0caa8ef..99ed9fae 100644 --- a/reference/datetime/functions/timezone-name-from-abbr.xml +++ b/reference/datetime/functions/timezone-name-from-abbr.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: behzat Status: ready --> <refentry xml:id="function.timezone-name-from-abbr" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>timezone_name_from_abbr</refname> @@ -9,10 +9,10 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>timezone_name_from_abbr</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>timezone_name_from_abbr</methodname> <methodparam><type>string</type><parameter>kısaltma</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>gmt_farkı</parameter><initializer>-1</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>ysu_var</parameter><initializer>-1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>utc_farkı</parameter><initializer>-1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>gys_var</parameter><initializer>-1</initializer></methodparam> </methodsynopsis> </refsect1> @@ -29,10 +29,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> - Yerel saatin GMT'ye göre saniye cinsinden farkı. Varsayılan değer, + Yerel saatin UTC'ye göre saniye cinsinden farkı. Varsayılan değer, <parameter>kısaltma</parameter> değiştirgesinin karşılığı olarak bulunan ilk zaman diliminin döndürüleceği anlamına gelen -1'dir. Yoksa, farka uyan zaman dilimi aranır ve bulunamadığı durumlarda fark @@ -41,13 +41,18 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>ysu_var</parameter></term> + <term><parameter>gys_var</parameter></term> <listitem> <para> - Yaz saati uygulaması belirteci. Eğer <parameter>kısaltma</parameter> - değiştirgesi yoksa zaman dilimi yalnızca - <parameter>gmt_farkı</parameter> ve <parameter>ysu_var</parameter> - değiştirgelerine göre aranacaktır. + Gün ışığından yararlanma saati göstergesi. Öntanımlı değer -1 olup + arama sırasında zaman diliminin gün ışığından yararlanma özelliğinin + olup olmadığının dikkate alınmadığı anlamına gelir. Bu 1 olarak + ayarlanırsa, <parameter>utc_farkı</parameter>'nın etkin gün ışığından + yararlanma farkını içerdiği varsayılır; 0 ise, + <parameter>utc_farkı</parameter> gün ışığından yararlanma farkını + içermiyor demektir. <parameter>kısaltma</parameter> yoksa, zaman + dilimi yalnızca <parameter>utc_farkı</parameter> ve + <parameter>gys_var</parameter> değiştirgelerine göre aranacaktır. </para> </listitem> </varlistentry> @@ -58,7 +63,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda zaman dilimini adını, başarısız olduğunda &false; döndürür. + Başarılı olduğunda zaman diliminin adını, başarısız olduğunda &false; döndürür. </para> </refsect1> diff --git a/reference/dio/functions/dio-fcntl.xml b/reference/dio/functions/dio-fcntl.xml index 46811fbe..0101eb0d 100644 --- a/reference/dio/functions/dio-fcntl.xml +++ b/reference/dio/functions/dio-fcntl.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 094906da54e6b9296c52505026c0f6a3fe68f6a6 Maintainer: nilgun Status: ready --> <refentry xml:id="function.dio-fcntl" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dio_fcntl</refname> @@ -56,7 +56,7 @@ <listitem> <para> <constant>F_GETLK</constant> - Birileri kilidin tutulmasını - engelliyorsa <function>dio_fcntl</function> işlevi (yukarıda + engelliyorsa <function>dio_fcntl</function> işlevi (aşağıda açıklandığı gibi) bir ilişkisel dizi ile döner. Hiçbir engelleme anahtarı yoksa "tür" olarak <constant>F_UNLCK</constant> atanır. </para> @@ -92,25 +92,26 @@ <itemizedlist> <listitem> <para> - "start" - kilidin başlangıç konumu + <literal>start</literal> - kilidin başlangıç konumu </para> </listitem> <listitem> <para> - "length" - kilitli alanın boyu; sıfır, dosyanın sonuna kadar + <literal>length</literal> - kilitli alanın boyu; sıfır, dosyanın sonuna kadar demektir. </para> </listitem> <listitem> <para> - "wenth" - l_start'ın göreli olduğu yer: + <literal>whence</literal> - l_start'ın göreli olduğu yer: <constant>SEEK_SET</constant>, <constant>SEEK_END</constant> ve <constant>SEEK_CUR</constant> olabilir. </para> </listitem> <listitem> <para> - "type" - kilit türü: <constant>F_RDLCK</constant> (okuma kilidi), + <literal>type</literal> - kilit türü: + <constant>F_RDLCK</constant> (okuma kilidi), <constant>F_WRLCK</constant> (yazma kilidi) veya <constant>F_UNLCK</constant> (kilidi aç) olabilir. </para> diff --git a/reference/dio/functions/dio-open.xml b/reference/dio/functions/dio-open.xml index 83b5cfa1..9cd3deab 100644 --- a/reference/dio/functions/dio-open.xml +++ b/reference/dio/functions/dio-open.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.dio-open" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>dio_open</refname> @@ -104,13 +104,13 @@ <para> <parameter>seçenekler</parameter> değiştirgesine <constant>O_CREAT</constant> atanmışsa dosya kipi (oluşturma izinleri) - <parameter>kip</parameter> değiştirgesinde belirtildiği gibi ayarlanır. - <parameter>kip</parameter> olarak <constant>O_CREAT</constant> - belirtilmişse <parameter>kip</parameter> doğru işlem için gereklidir, - yoksa yok sayılır. + <parameter>kip</parameter> değiştirgesinde belirtildiği gibi + ayarlanır. <parameter>seçenekler</parameter> değiştirgesine + <constant>O_CREAT</constant> belirtilmişse <parameter>kip</parameter> + doğru işlem için gereklidir, yoksa yok sayılır. </para> <para> - Oluşturlacak dosyaya atanacak asıl izinler, normal olarak sürecin + Oluşturulacak dosyaya atanacak asıl izinler, normal olarak sürecin <emphasis>umask</emphasis> değerinden etkilenir. </para> </listitem> diff --git a/reference/dir/functions/chroot.xml b/reference/dir/functions/chroot.xml index b58adb3a..1686f4f6 100644 --- a/reference/dir/functions/chroot.xml +++ b/reference/dir/functions/chroot.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 27ca68ce995137de25ff8c53b28d382477ade597 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.11 --> <refentry xml:id="function.chroot" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -15,12 +15,13 @@ <methodparam><type>string</type><parameter>dizin</parameter></methodparam> </methodsynopsis> <para> - Geçerli sürecin kök dizinini <parameter>dizin</parameter> yapar. + Geçerli sürecin kök dizinini <parameter>dizin</parameter>, geçerli çalışma + dizinini "/" yapar. </para> <para> - Bu işlev sadece sisteminiz kendisini destekliyorsa ve CLI, CGI veya gömülü + Bu işlev sadece GNU ve BSD sistemlerinde ve sadece CLI, CGI veya gömülü SAPI kullanıyorsanız kullanılabilir. Ayrıca, bu işlevin kullanılabilmesi - için sürecin root aidiyetinde çalışması gerekir. + için sürecin root yetkileriyle çalışması gerekir. </para> </refsect1> @@ -32,7 +33,7 @@ <term><parameter>dizin</parameter></term> <listitem> <para> - Yeni kök dizin. + Kök dizin haline getirilecek dizin. </para> </listitem> </varlistentry> @@ -47,9 +48,32 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example><title>- <function>chroot</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +chroot("/burası/kök/dizin/olacak/"); +echo getcwd(); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +/ +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; ¬e.no-windows; + ¬e.no-zts; </refsect1> </refentry> diff --git a/reference/dir/functions/getcwd.xml b/reference/dir/functions/getcwd.xml index 04aa4063..5a25d533 100644 --- a/reference/dir/functions/getcwd.xml +++ b/reference/dir/functions/getcwd.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 6f540a4bf2b3c2e2271022d0a31efa1a3036677c Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 --> <refentry xml:id="function.getcwd" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>getcwd</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>getcwd</methodname> <void/> </methodsynopsis> <para> @@ -27,11 +27,24 @@ <para> Bazı Unix türevlerinde, üst dizinlere erişim izni yoksa <function>getcwd</function> işlevi &false; döndürür. Erişim izinleri ve - kipler hakkında daha ayrıntılı bilgi için <function>chmod</function> işlevine - bakınız. + kipler hakkında daha ayrıntılı bilgi için <function>chmod</function> + işlevine bakınız. </para> </refsect1> + <refsect1 role="notes"> + <caution> + <para> + PHP yorumlayıcısı ZTS (Zend Güvenilir Evreleri) etkinken derlenmişse, + <function>getcwd</function> tarafından döndürülen geçerli çalışma dizini, + işletim sistemi arayüzleri tarafından döndürülen dizinden farklı + olabilir. Geçerli çalışma dizinine bağımlı olan harici kütüphaneler + (<link linkend="book.ffi">FFI</link> aracılığıyla çağrılan) bundan + etkilenecektir. + </para> + </caution> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/dir/functions/opendir.xml b/reference/dir/functions/opendir.xml index 8b7c7fe9..f722941d 100644 --- a/reference/dir/functions/opendir.xml +++ b/reference/dir/functions/opendir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 53b6f116ed5f8649ca540c38dfe0ce30619d0dd9 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.opendir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>resource</type><methodname>opendir</methodname> + <type class="union"><type>resource</type><type>false</type></type><methodname>opendir</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter></methodparam> </methodsynopsis> @@ -51,50 +51,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda dizin tanıtıcısı ile aksi takdirde &false; değeriyle - döner. - </para> - <para> - Eğer belirtilen <parameter>dizin</parameter> bir dizin değilse veya erişim - izinlerinin yetersizliğinden dolayı dizin açılamamışsa ya da bir dosya - sistemi hatası oluşmuşsa işlev &false; ile döner ve - <link linkend="errorfunc.constants">E_WARNING</link> seviyesinde bir - hata üretilir. Hata iletisinin çıktılanmasını işlev isminin başına bir - '<link linkend="language.operators.errorcontrol">@</link>' karakteri - ekleyerek engelleyebilirsiniz. + Başarılı olduğunda dizin tanıtıcısı,&return.falseforfailure;. </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>dizin</parameter> değiştirgesinde <literal>ftp://</literal> - sarmalayıcısı da kabul edilmeye başlandı. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - <parameter>dizin</parameter> değiştirgesinde dizin listelemeyi - destekleyen URL'ler belirtilebilir oldu. Ancak, PHP 4 sadece - <literal>file://</literal> sarmalayıcısını desteklemektedir. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + <parameter>dizin</parameter> geçerli bir dizin değilse, dizin yetki + yetersizliğinden ya da dosya sistemi hatalarından dolayı açılamıyorsa, + bu olur. </para> </refsect1> diff --git a/reference/dir/functions/readdir.xml b/reference/dir/functions/readdir.xml index 1e7d96f3..6679043d 100644 --- a/reference/dir/functions/readdir.xml +++ b/reference/dir/functions/readdir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: f658721332c6080e237ed6a1c29517225237b639 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.readdir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,11 +11,11 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>readdir</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>readdir</methodname> <methodparam choice="opt"><type>resource</type><parameter>dizin_tanıtıcısı</parameter></methodparam> </methodsynopsis> <para> - Dizindeki sonraki dosyanın ismi ile döner. Dosya isimleri dosya sisteminde + Dizindeki sonraki girdinin ismi ile döner. Girdiler dosya sisteminde saklandıkları sıra ile döndürülür. </para> </refsect1> @@ -41,7 +41,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda dosya ismi ile aksi takdirde &false; değeriyle döner. + Başarılı olduğunda dosya ismi ile,&return.falseforfailure;.. </para> &return.falseproblem; </refsect1> @@ -62,20 +62,18 @@ <programlisting role="php"> <![CDATA[ <?php -// 4.0.0-RC2 sürümüne kadar !== işlecinin kullanılamadığına dikkat edin - if ($dizin = opendir('/bir/dizin/dosyalar')) { echo "Dizin tanıtıcısı: $dizin\n"; echo "Dizin içeriği:\n"; /* Dizin içeriğini taramak için doğru yöntem. */ - while (false !== ($dosya = readdir($dizin))) { - echo "$dosya\n"; + while (false !== ($girdi = readdir($dizin))) { + echo "$girdi\n"; } /* Dizin içeriğini taramak için YANLIŞ yöntem. */ - while ($dosya = readdir($dizin)) { - echo "$dosya\n"; + while ($girdi = readdir($dizin)) { + echo "$girdi\n"; } closedir($dizin); @@ -93,9 +91,9 @@ if ($dizin = opendir('/bir/dizin/dosyalar')) { <![CDATA[ <?php if ($dizin = opendir('.')) { - while (false !== ($dosya= readdir($dizin))) { - if ($dosya != "." && $dosya != "..") { - echo "$dosya\n"; + while (false !== ($girdi = readdir($dizin))) { + if ($girdi != "." && $girdi != "..") { + echo "$girdi\n"; } } closedir($dizin); diff --git a/reference/dir/functions/rewinddir.xml b/reference/dir/functions/rewinddir.xml index 9abd3997..a0971b95 100644 --- a/reference/dir/functions/rewinddir.xml +++ b/reference/dir/functions/rewinddir.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 --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry xml:id="function.rewinddir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -38,6 +38,14 @@ </variablelist> </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.nullorfalse; + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/dir/functions/scandir.xml b/reference/dir/functions/scandir.xml index d4f7cd6b..9633bc67 100644 --- a/reference/dir/functions/scandir.xml +++ b/reference/dir/functions/scandir.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: nilgun Status: ready --> <refentry xml:id="function.scandir" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>scandir</refname> @@ -13,7 +13,7 @@ <methodsynopsis> <type>array</type><methodname>scandir</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>sıralama_türü</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sıralama_türü</parameter><initializer>SCANDIR_SORT_ASCENDING</initializer></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter></methodparam> </methodsynopsis> <para> @@ -40,8 +40,9 @@ <listitem> <para> Abecesel olarak küçükten büyüğe sıralama öntanımlıdır. Bu değiştirgeye - sıfırdan farklı bir değer atarsanız sıralama büyükten küçüğe doğru - yapılır. + <constant>SCANDIR_SORT_DESCENDING</constant> atarsanız sıralama + büyükten küçüğe doğru yapılır. <constant>SCANDIR_SORT_NONE</constant> + atanırsa sonuç sıralanmaz. </para> </listitem> </varlistentry> @@ -108,52 +109,6 @@ Array </screen> </example> </para> - <para> - <example> - <title>- PHP 4 için <function>scandir</function> örneği</title> - <programlisting role="php"> -<![CDATA[ -<?php -$dir = "/tmp"; -$dh = opendir($dir); -while (false !== ($filename = readdir($dh))) { - $files[] = $filename; -} - -sort($files); - -print_r($files); - -rsort($files); - -print_r($files); - -?> -]]> - </programlisting> - &example.outputs.similar; - <screen> -<![CDATA[ -Array -( - [0] => . - [1] => .. - [2] => bar.php - [3] => foo.txt - [4] => somedir -) -Array -( - [0] => somedir - [1] => foo.txt - [2] => bar.php - [3] => .. - [4] => . -) -]]> - </screen> - </example> - </para> </refsect1> <refsect1 role="notes">