cvs: phpdoc-ru /reference/dir/functions class.dir.xml closedir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml scandir.xml
| From: | Ivan Kovalenko | Date: | Mon, 18 Aug 2003 13:36:25 +0000 |
| Subject: | cvs: phpdoc-ru /reference/dir/functions class.dir.xml closedir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml scandir.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-118@lists.php.net to get a copy of this message | ||
tronic Mon Aug 18 09:36:25 2003 EDT
Added files:
/phpdoc-ru/reference/dir/functions class.dir.xml closedir.xml
getcwd.xml opendir.xml
readdir.xml rewinddir.xml
scandir.xml
Log:
Translation complete.
Index: phpdoc-ru/reference/dir/functions/class.dir.xml +++ phpdoc-ru/reference/dir/functions/class.dir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="class.dir"> <refnamediv> <refname>dir</refname> <refpurpose>Êëàññ directory</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> <methodname>dir</methodname> <methodparam><type>ñòðîêà</type><parameter>êàòàëîã</parameter></methodparam> </constructorsynopsis> <fieldsynopsis> <type>ñòðîêà</type><varname>path</varname> </fieldsynopsis> <fieldsynopsis> <type>ðåñóðñ</type><varname>handle</varname> </fieldsynopsis> <methodsynopsis><type>ñòðîêà</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>ïóñòîé</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>ïóñòîé</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> <para> Ïñåâäî-îáåêòíî-îðèåíòèðîâàííûé ìåõàíèçì äëÿ ÷òåíèÿ êàòàëîãà, ïåðåäàííîãî â ïàðàìåòðå <parameter>êàòàëîã</parameter>. Ñ ìîìåíòà îòêðûòèÿ êàòàëîãà ñòàíîâÿòñÿ äîñòóïíûìè äâà ñâîéñòâà êëàññà. Ñâîéñòâî "handle" ìîæåò áûòü èñïîëüçîâàíî ñ äðóãèìè ôóíêöèÿìè äëÿ ðàáîòû ñ êàòàëîãàìè, íàïðèìåð, ñ ôóíêöèÿìè <function>readdir</function>, <function>rewinddir</function> è <function>closedir</function>. Ñâîéñòâî "path" ñîäåðæèò ïóòü ê îòêðûòîìó êàòàëîãó. Äîñòóïíû òðè ìåòîäà: read, rewind and close. </para> <para> Ïîæàëóéñòà, îáðàòèòå âíèìàíèå íà ñïîñîá, êîòîðûì îñóùåñòâëÿåòñÿ ïðîâåðêà çíà÷åíèÿ, âîçâðàùàåìîãî ìåòîäàìè êëàññà <function>dir</function> â ïðèìåðå, ïðèâåäåííîì íèæå.  ýòîì ïðèìåðå ïðîâîäèòñÿ ïðîâåðêà çíà÷åíèÿ íà èäåíòè÷íîñòü (âûðàæåíèÿ èäåíòè÷íû, êîãäà îíè ðàâíû è ÿâëÿþòñÿ îäíîãî òèïà - çà áîëåå ïîäðîáíîé èíôîðìàöèåé îáðàòèòåñü ê ãëàâå <link linkend="language.operators.comparison"> Îïåðàòîðû ñðàâíåíèÿ</link>) çíà÷åíèþ &false;, ïîñêîëüêó â èíîì ñëó÷àå, ëþáîé ýëåìåíò êàòàëîãà, ÷üå èìÿ ìîæåò áûòü âûðàæåíî êàê &false;, îñòàíîâèò öèêë. <example> <title>Ïðèìåð èñïîëüçîâàíèÿ êëàññà <function>dir</function></title> <programlisting role="php"> <![CDATA[ <?php $d = dir("/etc"); echo "Äåñêðèïòîð: ".$d->handle."<br>\n"; echo "Ïóòü: ".$d->path."<br>\n"; while (false !== ($entry = $d->read())) { echo $entry."<br>\n"; } $d->close(); ?> ]]> </programlisting> </example> </para> <note> <para> Ïîðÿäîê, â êîòîðîì ìåòîä "read" âîçâðàùàåò ýëåìåíòû êàòàëîãà, çàâèñèò îò îïåðàöèîííîé ñèñòåìû. </para> </note> <note> <para> Òàêæå, PHP àâòîìàòè÷åñêè îïðåäåëÿåò âíóòðåííèé êëàññ <classname>Directory</classname>, ÷òî îçíà÷àåò, ÷òî âû íå ñìîæåòå îïðåäåëÿòü ñîáñòâåííûå êëàññû ñ òàêèì æå èìåíåì. Çà ïîëíûì ñïèñêîì ïðåäîïðåäåëåííûõ êëàññîâ îáðàòèòåñü ê ãëàâå <link linkend="reserved.classes">Ïðåäîïðåäåëåííûå êëàññû</link>. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/closedir.xml +++ phpdoc-ru/reference/dir/functions/closedir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.closedir"> <refnamediv> <refname>closedir</refname> <refpurpose>Îñâîáîäèòü äåñêðèïòîð êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ïóñòîé</type><methodname>closedir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Çàêðûâàåò ïîòîê, ñâÿçàííûé ñ êàòàëîãîì è ïåðåäàííûé â êà÷åñòâå ïàðàìåòðà <parameter>äåñêðèïòîð_êàòàëîãà</parameter>. Ïåðåä èñïîëüçîâàíèåì äàííîé ôóíêöèè, ïîòîê äîëæåí áûòü îòêðûò ñ ïîìîùüþ ôóíêöèè <function>opendir</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/getcwd.xml +++ phpdoc-ru/reference/dir/functions/getcwd.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 --> <refentry id="function.getcwd"> <refnamediv> <refname>getcwd</refname> <refpurpose>Ïîëó÷èòü èìÿ òåêóùåãî ðàáî÷åãî êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ñòðîêà</type><methodname>getcwd</methodname> <void/> </methodsynopsis> <para> Âîçâðàùàåò èìÿ òåêóùåãî ðàáî÷åãî êàòàëîãà. </para> <para> Ñì.òàêæå îïèñàíèå ôóíêöèè <function>chdir</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/opendir.xml +++ phpdoc-ru/reference/dir/functions/opendir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.opendir"> <refnamediv> <refname>opendir</refname> <refpurpose>Îòêðûòü êàòàëîã</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ðåñóðñ</type><methodname>opendir</methodname> <methodparam><type>ñòðîêà</type><parameter>ïóòü</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò äåñêðèïòîð êàòàëîãà äëÿ ïîñëåäóþùåãî èñïîëüçîâàíèÿ ñ ôóíêöèÿìè <function>closedir</function>, <function>readdir</function> è <function>rewinddir</function>. </para> <para> Åñëè <parameter>ïóòü</parameter> íå ñóùåñòâóåò èëè êàòàëîã, ðàñïîëîæåííûé ïî óêàçàííîìó ïóòè, íå ìîæåò áûòü îòêðûò âñëåäñòâèå ïðàâîâûõ îãðàíè÷åíèé èëè îøèáîê ôàéëîâîé ñèñòåìû, ôóíêöèÿ <function>opendir</function> âîçâðàùàåò çíà÷åíèå &false; è ãåíåðèðóåò ñîîáùåíèå PHP îá îøèáêå óðîâíÿ <link linkend="errorfunc.constants">E_WARNING</link>. Âû ìîæåòå çàïðåòèòü âûâîä ñîîáùåíèÿ îá îøèáêå, ïðåäâàðèâ èìÿ ôóíêöèè <function>opendir</function> ñèìâîëîì '<link linkend="language.operators.errorcontrol">@</link>'. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>opendir</function></title> <programlisting role="php"> <![CDATA[ <?php $dir = "/tmp/"; // Îòêðûòü çàâåäîìî ñóùåñòâóþùèé êàòàëîã è íà÷àòü ñ÷èòûâàòü åãî ñîäåðæèìîå if (is_dir($dir)) { if ($dh = opendir($dir)) { while (($file = readdir($dh)) !== false) { print "Ôàéë: $file : òèï: " . filetype($dir . $file) . "\n"; } closedir($dh); } } ?> ]]> </programlisting> </example> </para> <para> Íà÷èíàÿ ñ âåðñèè <literal>PHP 4.3.0</literal>, ïàðàìåòð <parameter>ïóòü</parameter> ìîæåò òàêæå ÿâëÿòüñÿ ëþáûì URL'îì, îáðàùåíèå ê êîòîðîìó ïðèâîäèò ê ïîëó÷åíèþ ñïèñêà åãî ôàéëîâ è êàòàëîãîâ. Îäíàêî, äàííûé ñïîñîá ðàáîòàåò òîëüêî ïðè èñïîëüçîâàíèè url-óïàêîâùèêà <literal>file://</literal>.  âåðñèè <literal>PHP 5.0.0</literal> áûëà äîáàâëåíà ïîääåðæêà url-óïàêîâùèêà <literal>ftp://</literal>. </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>is_dir</function>, <function>readdir</function> è êëàññà <link linkend="class.dir">Dir</link> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/readdir.xml +++ phpdoc-ru/reference/dir/functions/readdir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.readdir"> <refnamediv> <refname>readdir</refname> <refpurpose>Ïîëó÷èòü ýëåìåíò êàòàëîãà ïî åãî äåñêðèïòîðó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ñòðîêà</type><methodname>readdir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò èìÿ ñëåäóþùåãî ïî ïîðÿäêó ýëåìåíòà êàòàëîãà. Èìåíà ýëåìåíòîâ âîçâðàùàþòñÿ â ïîðÿäêå, çàâèñÿùåì îò ôàéëîâîé ñèñòåìû. </para> <para> Îáðàòèòå âíèìàíèå íà ñïîñîá ïðîâåðêè çíà÷åíèÿ, âîçâðàùàåìîãî ôóíêöèåé <function>readdir</function> â ïðèâåäåííîì íèæå ïðèìåðå.  ýòîì ïðèìåðå îñóùåñòâëÿåòñÿ ïðîâåðêà çíà÷åíèÿ íà èäåíòè÷íîñòü (âûðàæåíèÿ èäåíòè÷íû, êîãäà îíè ðàâíû è ÿâëÿþòñÿ çíà÷åíèÿìè îäíîãî òèïà - çà áîëåå ïîäðîáíîé èíôîðìàöèåé îáðàòèòåñü ê ãëàâå <link linkend="language.operators.comparison"> Îïåðàòîðû ñðàâíåíèÿ</link>) çíà÷åíèþ &false;, ïîñêîëüêó â èíîì ñëó÷àå, ëþáîé ýëåìåíò êàòàëîãà, ÷üå èìÿ ìîæåò áûòü âûðàæåíî êàê &false;, îñòàíîâèò öèêë (íàïðèìåð, ýëåìåíò ñ èìåíåì "0"). </para> <para> <example> <title>Âûâåñòè ñïèñîê âñåõ ôàéëîâ â êàòàëîãå</title> <programlisting role="php"> <![CDATA[ <?php // Îáðàòèòå âíèìàíèå, ÷òî îïåðàòîð !== íå ñóùåñòâîâàë äî âåðñèè 4.0.0-RC2 if ($handle = opendir('/path/to/files')) { echo "Äåñêðèïòîð êàòàëîãà: $handle\n"; echo "Ôàéëû:\n"; /* Èìåííî ýòîò ñïîñîá ÷òåíèÿ ýëåìåíòîâ êàòàëîãà ÿâëÿåòñÿ ïðàâèëüíûì. */ while (false !== ($file = readdir($handle))) { echo "$file\n"; } /* Ýòîò ñïîñîá ÍÅÂÅÐÅÍ. */ while ($file = readdir($handle)) { echo "$file\n"; } closedir($handle); } ?> ]]> </programlisting> </example> </para> <para> Îáðàòèòå âíèìàíèå, ÷òî ôóíêöèÿ <function>readdir</function> òàêæå âîçâðàùàåò ýëåìåíòû ñ èìåíàìè <literal>.</literal> è <literal>..</literal>. Åñëè âû íå õîòèòå ïîëó÷àòü ýòè çíà÷åíèÿ, ïðîñòî îòáðàñûâàéòå èõ: <example> <title> Ïîëó÷èòü ñïèñîê ôàéëîâ â òåêóùåì êàòàëîãå è îòáðîñèòü ýëåìåíòû ñ èìåíàìè <literal>.</literal> è <literal>..</literal> </title> <programlisting role="php"> <![CDATA[ <?php if ($handle = opendir('.')) { while (false !== ($file = readdir($handle))) { if ($file != "." && $file != "..") { echo "$file\n"; } } closedir($handle); } ?> ]]> </programlisting> </example> </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>is_dir</function> è <function>glob</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/rewinddir.xml +++ phpdoc-ru/reference/dir/functions/rewinddir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> <refpurpose>Ñáðîñèòü äåñêðèïòîð êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ïóñòîå</type><methodname>rewinddir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Ñáðàñûâàåò ïîòîê êàòàëîãà, ïåðåäàííûé â ïàðàìåòðå <parameter>äåñêðèïòîð_êàòàëîãà</parameter> òàêèì îáðàçîì, ÷òîáû òîò óêàçûâàë íà íà÷àëî êàòàëîãà. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/scandir.xml +++ phpdoc-ru/reference/dir/functions/scandir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.1 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.scandir"> <refnamediv> <refname>scandir</refname> <refpurpose> Ïîëó÷èòü ñïèñîê ôàéëîâ è êàòàëîãîâ, ðàñïîëîæåííûõ ïî óêàçàííîìó ïóòè </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>scandir</methodname> <methodparam><type>ñòðîêà</type><parameter>êàòàëîã</parameter></methodparam> <methodparam choice="opt"><type>öåëîå</type><parameter>ïîðÿäîê_ñîðòèðîâêè</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò <type>ìàññèâ</type>, ñîäåðæàùèé èìåíà ôàéëîâ è êàòàëîãîâ, ðàñïîëîæåííûõ ïî ïóòè, ïåðåäàííîì â ïàðàìåòðå <parameter>êàòàëîã</parameter>. Åñëè <parameter>êàòàëîã</parameter> íå ÿâëÿåòñÿ òàêîâûì, ôóíêöèÿ âîçâðàùàåò ëîãè÷åñêîå çíà÷åíèå &false; è ãåíåðèðóåò ñîîáùåíèå îá îøèáêå óðîâíÿ <constant>E_WARNING</constant>. </para> <para> Ïî óìîë÷àíèþ, ñîðòèðîâêà ïðîèçâîäèòñÿ â àëôàâèòíîì ïîðÿäêå ïî âîçðàñòàíèþ. Åñëè óêàçàí íåîáÿçàòåëüíûé ïàðàìåòð <parameter>ïîðÿäîê_ñîðòèðîâêè</parameter> (ðàâåí 1), ñîðòèðîâêà ïðîèçâîäèòñÿ â àëôàâèòíîì ïîðÿäêå ïî óáûâàíèþ. </para> <para> <example> <title>Ïðîñòîé ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>scandir</function></title> <programlisting role="php"> <![CDATA[ <?php $dir = '/tmp'; $files1 = scandir($dir); $files2 = scandir($dir, 1); print_r($files1); print_r($files2); /* Ðåçóëüòàòîì áóäåò íå÷òî âðîäå: Array ( [0] => . [1] => .. [2] => bar.php [3] => foo.txt [4] => somedir ) Array ( [0] => somedir [1] => foo.txt [2] => bar.php [3] => .. [4] => . ) */ ?> ]]> </programlisting> </example> </para> <para> <example> <title>Àëüòåðíàòèâíûé âàðèàíò ôóíêöèè <function>scandir</function> äëÿ PHP 4</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); /* Ðåçóëüòàò áóäåò ïðèìåðíî òàêèì: Array ( [0] => . [1] => .. [2] => bar.php [3] => foo.txt [4] => somedir ) Array ( [0] => somedir [1] => foo.txt [2] => bar.php [3] => .. [4] => . ) */ ?> ]]> </programlisting> </example> </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>opendir</function>, <function>readdir</function>, <function>glob</function>, <function>is_dir</function> è <function>sort</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-ru/reference/dir/functions/class.dir.xml +++ phpdoc-ru/reference/dir/functions/class.dir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="class.dir"> <refnamediv> <refname>dir</refname> <refpurpose>Êëàññ directory</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> <methodname>dir</methodname> <methodparam><type>ñòðîêà</type><parameter>êàòàëîã</parameter></methodparam> </constructorsynopsis> <fieldsynopsis> <type>ñòðîêà</type><varname>path</varname> </fieldsynopsis> <fieldsynopsis> <type>ðåñóðñ</type><varname>handle</varname> </fieldsynopsis> <methodsynopsis><type>ñòðîêà</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>ïóñòîé</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>ïóñòîé</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> <para> Ïñåâäî-îáåêòíî-îðèåíòèðîâàííûé ìåõàíèçì äëÿ ÷òåíèÿ êàòàëîãà, ïåðåäàííîãî â ïàðàìåòðå <parameter>êàòàëîã</parameter>. Ñ ìîìåíòà îòêðûòèÿ êàòàëîãà ñòàíîâÿòñÿ äîñòóïíûìè äâà ñâîéñòâà êëàññà. Ñâîéñòâî "handle" ìîæåò áûòü èñïîëüçîâàíî ñ äðóãèìè ôóíêöèÿìè äëÿ ðàáîòû ñ êàòàëîãàìè, íàïðèìåð, ñ ôóíêöèÿìè <function>readdir</function>, <function>rewinddir</function> è <function>closedir</function>. Ñâîéñòâî "path" ñîäåðæèò ïóòü ê îòêðûòîìó êàòàëîãó. Äîñòóïíû òðè ìåòîäà: read, rewind and close. </para> <para> Ïîæàëóéñòà, îáðàòèòå âíèìàíèå íà ñïîñîá, êîòîðûì îñóùåñòâëÿåòñÿ ïðîâåðêà çíà÷åíèÿ, âîçâðàùàåìîãî ìåòîäàìè êëàññà <function>dir</function> â ïðèìåðå, ïðèâåäåííîì íèæå.  ýòîì ïðèìåðå ïðîâîäèòñÿ ïðîâåðêà çíà÷åíèÿ íà èäåíòè÷íîñòü (âûðàæåíèÿ èäåíòè÷íû, êîãäà îíè ðàâíû è ÿâëÿþòñÿ îäíîãî òèïà - çà áîëåå ïîäðîáíîé èíôîðìàöèåé îáðàòèòåñü ê ãëàâå <link linkend="language.operators.comparison"> Îïåðàòîðû ñðàâíåíèÿ</link>) çíà÷åíèþ &false;, ïîñêîëüêó â èíîì ñëó÷àå, ëþáîé ýëåìåíò êàòàëîãà, ÷üå èìÿ ìîæåò áûòü âûðàæåíî êàê &false;, îñòàíîâèò öèêë. <example> <title>Ïðèìåð èñïîëüçîâàíèÿ êëàññà <function>dir</function></title> <programlisting role="php"> <![CDATA[ <?php $d = dir("/etc"); echo "Äåñêðèïòîð: ".$d->handle."<br>\n"; echo "Ïóòü: ".$d->path."<br>\n"; while (false !== ($entry = $d->read())) { echo $entry."<br>\n"; } $d->close(); ?> ]]> </programlisting> </example> </para> <note> <para> Ïîðÿäîê, â êîòîðîì ìåòîä "read" âîçâðàùàåò ýëåìåíòû êàòàëîãà, çàâèñèò îò îïåðàöèîííîé ñèñòåìû. </para> </note> <note> <para> Òàêæå, PHP àâòîìàòè÷åñêè îïðåäåëÿåò âíóòðåííèé êëàññ <classname>Directory</classname>, ÷òî îçíà÷àåò, ÷òî âû íå ñìîæåòå îïðåäåëÿòü ñîáñòâåííûå êëàññû ñ òàêèì æå èìåíåì. Çà ïîëíûì ñïèñêîì ïðåäîïðåäåëåííûõ êëàññîâ îáðàòèòåñü ê ãëàâå <link linkend="reserved.classes">Ïðåäîïðåäåëåííûå êëàññû</link>. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/closedir.xml +++ phpdoc-ru/reference/dir/functions/closedir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.closedir"> <refnamediv> <refname>closedir</refname> <refpurpose>Îñâîáîäèòü äåñêðèïòîð êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ïóñòîé</type><methodname>closedir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Çàêðûâàåò ïîòîê, ñâÿçàííûé ñ êàòàëîãîì è ïåðåäàííûé â êà÷åñòâå ïàðàìåòðà <parameter>äåñêðèïòîð_êàòàëîãà</parameter>. Ïåðåä èñïîëüçîâàíèåì äàííîé ôóíêöèè, ïîòîê äîëæåí áûòü îòêðûò ñ ïîìîùüþ ôóíêöèè <function>opendir</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/getcwd.xml +++ phpdoc-ru/reference/dir/functions/getcwd.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 --> <refentry id="function.getcwd"> <refnamediv> <refname>getcwd</refname> <refpurpose>Ïîëó÷èòü èìÿ òåêóùåãî ðàáî÷åãî êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ñòðîêà</type><methodname>getcwd</methodname> <void/> </methodsynopsis> <para> Âîçâðàùàåò èìÿ òåêóùåãî ðàáî÷åãî êàòàëîãà. </para> <para> Ñì.òàêæå îïèñàíèå ôóíêöèè <function>chdir</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/opendir.xml +++ phpdoc-ru/reference/dir/functions/opendir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.opendir"> <refnamediv> <refname>opendir</refname> <refpurpose>Îòêðûòü êàòàëîã</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ðåñóðñ</type><methodname>opendir</methodname> <methodparam><type>ñòðîêà</type><parameter>ïóòü</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò äåñêðèïòîð êàòàëîãà äëÿ ïîñëåäóþùåãî èñïîëüçîâàíèÿ ñ ôóíêöèÿìè <function>closedir</function>, <function>readdir</function> è <function>rewinddir</function>. </para> <para> Åñëè <parameter>ïóòü</parameter> íå ñóùåñòâóåò èëè êàòàëîã, ðàñïîëîæåííûé ïî óêàçàííîìó ïóòè, íå ìîæåò áûòü îòêðûò âñëåäñòâèå ïðàâîâûõ îãðàíè÷åíèé èëè îøèáîê ôàéëîâîé ñèñòåìû, ôóíêöèÿ <function>opendir</function> âîçâðàùàåò çíà÷åíèå &false; è ãåíåðèðóåò ñîîáùåíèå PHP îá îøèáêå óðîâíÿ <link linkend="errorfunc.constants">E_WARNING</link>. Âû ìîæåòå çàïðåòèòü âûâîä ñîîáùåíèÿ îá îøèáêå, ïðåäâàðèâ èìÿ ôóíêöèè <function>opendir</function> ñèìâîëîì '<link linkend="language.operators.errorcontrol">@</link>'. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>opendir</function></title> <programlisting role="php"> <![CDATA[ <?php $dir = "/tmp/"; // Îòêðûòü çàâåäîìî ñóùåñòâóþùèé êàòàëîã è íà÷àòü ñ÷èòûâàòü åãî ñîäåðæèìîå if (is_dir($dir)) { if ($dh = opendir($dir)) { while (($file = readdir($dh)) !== false) { print "Ôàéë: $file : òèï: " . filetype($dir . $file) . "\n"; } closedir($dh); } } ?> ]]> </programlisting> </example> </para> <para> Íà÷èíàÿ ñ âåðñèè <literal>PHP 4.3.0</literal>, ïàðàìåòð <parameter>ïóòü</parameter> ìîæåò òàêæå ÿâëÿòüñÿ ëþáûì URL'îì, îáðàùåíèå ê êîòîðîìó ïðèâîäèò ê ïîëó÷åíèþ ñïèñêà åãî ôàéëîâ è êàòàëîãîâ. Îäíàêî, äàííûé ñïîñîá ðàáîòàåò òîëüêî ïðè èñïîëüçîâàíèè url-óïàêîâùèêà <literal>file://</literal>.  âåðñèè <literal>PHP 5.0.0</literal> áûëà äîáàâëåíà ïîääåðæêà url-óïàêîâùèêà <literal>ftp://</literal>. </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>is_dir</function>, <function>readdir</function> è êëàññà <link linkend="class.dir">Dir</link> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/readdir.xml +++ phpdoc-ru/reference/dir/functions/readdir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.readdir"> <refnamediv> <refname>readdir</refname> <refpurpose>Ïîëó÷èòü ýëåìåíò êàòàëîãà ïî åãî äåñêðèïòîðó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ñòðîêà</type><methodname>readdir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò èìÿ ñëåäóþùåãî ïî ïîðÿäêó ýëåìåíòà êàòàëîãà. Èìåíà ýëåìåíòîâ âîçâðàùàþòñÿ â ïîðÿäêå, çàâèñÿùåì îò ôàéëîâîé ñèñòåìû. </para> <para> Îáðàòèòå âíèìàíèå íà ñïîñîá ïðîâåðêè çíà÷åíèÿ, âîçâðàùàåìîãî ôóíêöèåé <function>readdir</function> â ïðèâåäåííîì íèæå ïðèìåðå.  ýòîì ïðèìåðå îñóùåñòâëÿåòñÿ ïðîâåðêà çíà÷åíèÿ íà èäåíòè÷íîñòü (âûðàæåíèÿ èäåíòè÷íû, êîãäà îíè ðàâíû è ÿâëÿþòñÿ çíà÷åíèÿìè îäíîãî òèïà - çà áîëåå ïîäðîáíîé èíôîðìàöèåé îáðàòèòåñü ê ãëàâå <link linkend="language.operators.comparison"> Îïåðàòîðû ñðàâíåíèÿ</link>) çíà÷åíèþ &false;, ïîñêîëüêó â èíîì ñëó÷àå, ëþáîé ýëåìåíò êàòàëîãà, ÷üå èìÿ ìîæåò áûòü âûðàæåíî êàê &false;, îñòàíîâèò öèêë (íàïðèìåð, ýëåìåíò ñ èìåíåì "0"). </para> <para> <example> <title>Âûâåñòè ñïèñîê âñåõ ôàéëîâ â êàòàëîãå</title> <programlisting role="php"> <![CDATA[ <?php // Îáðàòèòå âíèìàíèå, ÷òî îïåðàòîð !== íå ñóùåñòâîâàë äî âåðñèè 4.0.0-RC2 if ($handle = opendir('/path/to/files')) { echo "Äåñêðèïòîð êàòàëîãà: $handle\n"; echo "Ôàéëû:\n"; /* Èìåííî ýòîò ñïîñîá ÷òåíèÿ ýëåìåíòîâ êàòàëîãà ÿâëÿåòñÿ ïðàâèëüíûì. */ while (false !== ($file = readdir($handle))) { echo "$file\n"; } /* Ýòîò ñïîñîá ÍÅÂÅÐÅÍ. */ while ($file = readdir($handle)) { echo "$file\n"; } closedir($handle); } ?> ]]> </programlisting> </example> </para> <para> Îáðàòèòå âíèìàíèå, ÷òî ôóíêöèÿ <function>readdir</function> òàêæå âîçâðàùàåò ýëåìåíòû ñ èìåíàìè <literal>.</literal> è <literal>..</literal>. Åñëè âû íå õîòèòå ïîëó÷àòü ýòè çíà÷åíèÿ, ïðîñòî îòáðàñûâàéòå èõ: <example> <title> Ïîëó÷èòü ñïèñîê ôàéëîâ â òåêóùåì êàòàëîãå è îòáðîñèòü ýëåìåíòû ñ èìåíàìè <literal>.</literal> è <literal>..</literal> </title> <programlisting role="php"> <![CDATA[ <?php if ($handle = opendir('.')) { while (false !== ($file = readdir($handle))) { if ($file != "." && $file != "..") { echo "$file\n"; } } closedir($handle); } ?> ]]> </programlisting> </example> </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>is_dir</function> è <function>glob</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/rewinddir.xml +++ phpdoc-ru/reference/dir/functions/rewinddir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> <refpurpose>Ñáðîñèòü äåñêðèïòîð êàòàëîãà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ïóñòîå</type><methodname>rewinddir</methodname> <methodparam><type>ðåñóðñ</type><parameter>äåñêðèïòîð_êàòàëîãà</parameter></methodparam> </methodsynopsis> <para> Ñáðàñûâàåò ïîòîê êàòàëîãà, ïåðåäàííûé â ïàðàìåòðå <parameter>äåñêðèïòîð_êàòàëîãà</parameter> òàêèì îáðàçîì, ÷òîáû òîò óêàçûâàë íà íà÷àëî êàòàëîãà. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-ru/reference/dir/functions/scandir.xml +++ phpdoc-ru/reference/dir/functions/scandir.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.1 Maintainer: tronic Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.scandir"> <refnamediv> <refname>scandir</refname> <refpurpose> Ïîëó÷èòü ñïèñîê ôàéëîâ è êàòàëîãîâ, ðàñïîëîæåííûõ ïî óêàçàííîìó ïóòè </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>ìàññèâ</type><methodname>scandir</methodname> <methodparam><type>ñòðîêà</type><parameter>êàòàëîã</parameter></methodparam> <methodparam choice="opt"><type>öåëîå</type><parameter>ïîðÿäîê_ñîðòèðîâêè</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò <type>ìàññèâ</type>, ñîäåðæàùèé èìåíà ôàéëîâ è êàòàëîãîâ, ðàñïîëîæåííûõ ïî ïóòè, ïåðåäàííîì â ïàðàìåòðå <parameter>êàòàëîã</parameter>. Åñëè <parameter>êàòàëîã</parameter> íå ÿâëÿåòñÿ òàêîâûì, ôóíêöèÿ âîçâðàùàåò ëîãè÷åñêîå çíà÷åíèå &false; è ãåíåðèðóåò ñîîáùåíèå îá îøèáêå óðîâíÿ <constant>E_WARNING</constant>. </para> <para> Ïî óìîë÷àíèþ, ñîðòèðîâêà ïðîèçâîäèòñÿ â àëôàâèòíîì ïîðÿäêå ïî âîçðàñòàíèþ. Åñëè óêàçàí íåîáÿçàòåëüíûé ïàðàìåòð <parameter>ïîðÿäîê_ñîðòèðîâêè</parameter> (ðàâåí 1), ñîðòèðîâêà ïðîèçâîäèòñÿ â àëôàâèòíîì ïîðÿäêå ïî óáûâàíèþ. </para> <para> <example> <title>Ïðîñòîé ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>scandir</function></title> <programlisting role="php"> <![CDATA[ <?php $dir = '/tmp'; $files1 = scandir($dir); $files2 = scandir($dir, 1); print_r($files1); print_r($files2); /* Ðåçóëüòàòîì áóäåò íå÷òî âðîäå: Array ( [0] => . [1] => .. [2] => bar.php [3] => foo.txt [4] => somedir ) Array ( [0] => somedir [1] => foo.txt [2] => bar.php [3] => .. [4] => . ) */ ?> ]]> </programlisting> </example> </para> <para> <example> <title>Àëüòåðíàòèâíûé âàðèàíò ôóíêöèè <function>scandir</function> äëÿ PHP 4</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); /* Ðåçóëüòàò áóäåò ïðèìåðíî òàêèì: Array ( [0] => . [1] => .. [2] => bar.php [3] => foo.txt [4] => somedir ) Array ( [0] => somedir [1] => foo.txt [2] => bar.php [3] => .. [4] => . ) */ ?> ]]> </programlisting> </example> </para> <para> Ñì.òàêæå îïèñàíèÿ ôóíêöèé <function>opendir</function>, <function>readdir</function>, <function>glob</function>, <function>is_dir</function> è <function>sort</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->