cvs: phpdoc /he/functions dir.xml

matroz Fri Mar 8 06:42:14 2002 EDT Added files: /phpdoc/he/functions dir.xml Log: almost done

Index: phpdoc/he/functions/dir.xml +++ phpdoc/he/functions/dir.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.00 Maintainer: matty Status: working --> <reference id="ref.dir"> <title>ôåð÷öéåú ìèéôåì áñôøéåú</title> <titleabbrev>ñôøéåú</titleabbrev> <partintro> <simpara> ìôåð÷öéåú ðåñôåú áðåùà ëâåï : <function>dirname</function>, <function>is_dir</function>, <function>mkdir</function>, å <function>rmdir</function>,øàä àú îåãåì <link linkend="ref.filesystem">Filesystem</link>. </simpara> </partintro> <refentry id="function.chroot"> <refnamediv> <refname>chroot</refname> <refpurpose>ùðä àú ñôøééú ä root</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>bool</type><methodname>chroot</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> îùðä àú ñôøééú ä root ùì äúäìéê äðåëçé ì <parameter>directory</parameter>. îçæéøä &false; àí ìà ðéúï ìùðåú àú ñôøééú ä root , &true; àçøú. </para> <note> <para> àéï æä îåîìõ ìäùúîù áôåð÷öéä æå ëàùø øöéí áñáéáú ùøú äàéðèøðè, áâìì ùìà ðéúï éäéä ìäçæéø àú ñôøééú ä root ì / ìàçø ñéåí äá÷ùä. ôåð÷öéä æå úúô÷ã ëéàä ø÷ ëàùø øöéí ë CGI. </para> </note> </refsect1> </refentry> <refentry id="function.chdir"> <refnamediv> <refname>chdir</refname> <refpurpose>ùðä ñôøéä</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>bool</type><methodname>chdir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> îùðä àú ñôøééú äòáåãä äðåëçéú ùì PHP ì <parameter>directory</parameter>. îçæéøä &false; àí ìà ðéúï ìùðåú ñôøéä, &true; àçøú. </para> </refsect1> </refentry> <refentry id="class.dir"> <refnamediv> <refname>dir</refname> <refpurpose>directory class</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> <methodname>dir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </constructorsynopsis> <fieldsynopsis> <type>string</type><varname>path</varname> </fieldsynopsis> <methodsynopsis><type>string</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> <para> îðâðåï pseudo-object oriented ì÷øéàä îúåê ñôøéä. äîùúðä <parameter>directory</parameter> ðôúç. ùðé îàôééðéí äéðí æîéðéí ìàçø ùäñôøéä ðôúçä. ðéúï ìäùúîù áîàôééï handle òí ôåî÷öéåú ñôøéä ðåñôåú ëâåï <function>readdir</function>, <function>rewinddir</function> and <function>closedir</function>. äîàôééï path î÷áì àú òøê îé÷åí äñôøééä ùðôúçä. éùðï ùìåùä ùéèåú àôùøéåú : read, rewind å close. </para> <para> ùéí ìá ìãøê ùáä äòøê ùîçæéøä äôåð÷öéä <function>dir</function>'s ðáã÷ áãåâîà îúçú. àðå áåã÷éí áôéøåù äàí äòøê äîåçæø æää(ùååä ì åâí îàåúå type ,øàä <link linkend="language.operators.comparison"> Comparison Operators</link> ìîéãò ðåñó) &false; ëé àçøú , ëì òøê äîåçæø îäñôøééä äùååä ì &false; éòöåø àú äìåìàä. <example> <title><function>dir</function> ãåâîà</title> <programlisting role="php"> <![CDATA[ $d = dir("/etc"); echo "Handle: ".$d->handle."<br>\n"; echo "Path: ".$d->path."<br>\n"; while (false !== ($entry = $d->read())) { echo $entry."<br>\n"; } $d->close(); ]]> </programlisting> </example> </para> <note> <para> äñãø ùáå îåçæøéí òøëé äñôøéä ìàçø ùéîåù áùéèä read äí system-dependent. </para> </note> </refsect1> </refentry> <refentry id="function.closedir"> <refnamediv> <refname>closedir</refname> <refpurpose>ñâåø ñôøéä</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>void</type><methodname>closedir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> </methodsynopsis> <para> ñåâøú àú stream äñôøéä äîåöáòú òì éãé <parameter>dir_handle</parameter>. ä stream çééá äéä ìäéôúç ìôðé ëï òí <function>opendir</function>. </para> </refsect1> </refentry> <refentry id="function.getcwd"> <refnamediv> <refname>getcwd</refname> <refpurpose>äçæø àú ñôøéú äòáåãä äðåëçéú</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>string</type><methodname>getcwd</methodname> <void/> </methodsynopsis> <para> îçæéøä àú ñôøéú äòáåãä äðåëçéú. </para> </refsect1> </refentry> <refentry id="function.opendir"> <refnamediv> <refname>opendir</refname> <refpurpose>ôåúçú îöáéò ìñôøéä</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>resource</type><methodname>opendir</methodname> <methodparam><type>string</type><parameter>path</parameter></methodparam> </methodsynopsis> <para> îçæéøä îöáéò ìñôøéä ìùéîåù á÷øéàåú ìôåð÷öéåú <function>closedir</function>, <function>readdir</function>, å <function>rewinddir</function>. </para> <para> àí <parameter>path</parameter> àéðå îöáéò òì ñôøéä çå÷éú àå ùìà ðéúï ìôúåç àú äñôøéä áâìì äâáìåú ùéîåù àå ùâéàåú áîòøëú ä÷áöéí, <function>opendir</function> úçæéø &false; å úééöø ùâéàú PHP. ðéúï ìäñúéø àú ôìè äùâéàä <function>opendir</function> òì éãé äåñôú `@' ìôðé ùí äôåð÷öéä. </para> <para> <example> <title><function>opendir</function> ãåâîà</title> <programlisting role="php"> <![CDATA[ <?php if ($dir = @opendir("/tmp")) { while (($file = readdir($dir)) !== false) { echo "$file\n"; } closedir($dir); } ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.readdir"> <refnamediv> <refname>readdir</refname> <refpurpose>÷øà òøê îîöáéò äñôøéä</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>string</type><methodname>readdir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> </methodsynopsis> <para> îçæéøä àú ùí ä÷åáõ äáà îîöáéò äñôøéä. ùîåú ä÷áöéí îåçæøéí áàåúå äñãø ùáå äí îàåçñðéí áîòøëú ä÷áöéí. </para> <para> ùéí ìá ìãøê ùáä äòøê ùîçæéøä äôåð÷öéä <function>readdir</function>'s ðáã÷ áãåâîà îúçú. àðå áåã÷éí áôéøåù äàí äòøê äîåçæø æää(ùååä ì åâí îàåúå type ,øàä <link linkend="language.operators.comparison"> Comparison Operators</link> ìîéãò ðåñó) &false; ëé àçøú , ëì òøê äîåçæø îäñôøééä äùååä ì &false; éòöåø àú äìåìàä. </para> <para> <example> <title>äöâ àú ëì ä÷áöéí äðîöàéí áñôøéä</title> <programlisting role="php"> <![CDATA[ // Note that !== did not exist until 4.0.0-RC2 <?php $handle=opendir('/path/to/files'); echo "Directory handle: $handle\n"; echo "Files:\n"; /* This is the correct way to loop over the directory. */ while (false !== ($file = readdir($handle))) { echo "$file\n"; } /* This is the WRONG way to loop over the directory. */ 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 $handle = opendir('.'); while (false !== ($file = readdir($handle))) { if ($file != "." && $file != "..") { echo "$file\n"; } } closedir($handle); ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> <refpurpose>îöéáä àú îöáéò äñôøéä áäúçìä</refpurpose> </refnamediv> <refsect1> <title>úéàåø</title> <methodsynopsis> <type>void</type><methodname>rewinddir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> </methodsynopsis> <para> îöéáä àú îöáéò äñôøéä äîéåöâ òì éãé <parameter>dir_handle</parameter> ìäúçìú äñôøéä. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm