svn: /phpdoc/ru/trunk/reference/dir/functions/ class.dir.xml

From: Date: Wed, 23 Feb 2011 11:55:45 +0000
Subject: svn: /phpdoc/ru/trunk/reference/dir/functions/ class.dir.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1424@lists.php.net to get a copy of this message
shein Wed, 23 Feb 2011 11:55:45 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308590 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/dir/functions/class.dir.xml Modified: phpdoc/ru/trunk/reference/dir/functions/class.dir.xml =================================================================== --- phpdoc/ru/trunk/reference/dir/functions/class.dir.xml 2011-02-23 11:48:16 UTC (rev 308589) +++ phpdoc/ru/trunk/reference/dir/functions/class.dir.xml 2011-02-23 11:55:45 UTC (rev 308590) @@ -1,86 +1,102 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: tronic Status: ready --> +<!-- EN-Revision: 297028 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> <!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 --> - <refentry xml:id="class.dir" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>dir</refname> - <refpurpose>Класс directory</refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <classsynopsis> - <ooclass><classname>dir</classname></ooclass> - <constructorsynopsis> - <methodname>dir</methodname> - <methodparam><type>string</type><parameter>каталог</parameter></methodparam> - </constructorsynopsis> - <fieldsynopsis> - <type>string</type><varname>path</varname> - </fieldsynopsis> - <fieldsynopsis> - <type>resource</type><varname>handle</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> +<refentry xml:id="class.dir" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>dir</refname> + <refpurpose>Возвращает экземпляр класса Directory</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <classsynopsis> + <ooclass><classname>Directory</classname></ooclass> + <classsynopsisinfo> + <ooclass> + <classname>Directory</classname> + </ooclass> + </classsynopsisinfo> + <fieldsynopsis> + <type>string</type><varname>path</varname> + </fieldsynopsis> + <fieldsynopsis> + <type>resource</type><varname>handle</varname> + </fieldsynopsis> + <methodsynopsis><type>string</type><methodname>Directory::read</methodname><void/></methodsynopsis> + <methodsynopsis><type>void</type><methodname>Directory::rewind</methodname><void/></methodsynopsis> + <methodsynopsis><type>void</type><methodname>Directory::close</methodname><void/></methodsynopsis> + </classsynopsis> + <para> + Псевдо-объектно-ориентированный механизм для чтения каталога. + В начале открывается каталог, переданный в параметре + <parameter>directory</parameter>. С момента открытия каталога + становятся доступными два свойства класса. Свойство "handle" + может быть использовано с другими функциями для работы с + каталогами, например, с функциями <function>readdir</function>, + <function>rewinddir</function> и <function>closedir</function>. + Свойство "path" содержит путь к открытому каталогу. Доступны три + метода: read, rewind and close. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования класса <function>dir</function></title> <para> - Псевдо-объектно-ориентированный механизм для чтения каталога, - переданного в параметре <parameter>каталог</parameter>. - С момента открытия каталога становятся доступными два свойства - класса. Свойство "handle" может быть использовано - с другими функциями для работы с каталогами, например, с - функциями <function>readdir</function>, <function>rewinddir</function> и - <function>closedir</function>. Свойство "path" содержит путь - к открытому каталогу. Доступны три метода: read, rewind and close. - </para> - <para> Пожалуйста, обратите внимание на способ, которым осуществляется - проверка значения, возвращаемого методами класса <function>dir</function> - в примере, приведенном ниже. В этом примере проводится + проверка значения, возвращаемого <function>dir::read</function> + в примере, приведенном ниже. В этом примере явно проводится проверка значения на идентичность (выражения идентичны, когда они равны и являются одного типа - за более подробной информацией обратитесь к главе <link linkend="language.operators.comparison"> Операторы сравнения</link>) значению &false;, поскольку в ином случае, любой элемент каталога, чье имя может быть выражено как &false;, остановит цикл. - <example> - <title>Пример использования класса <function>dir</function></title> - <programlisting role="php"> + </para> + <programlisting role="php"> <![CDATA[ <?php -$d = dir("/etc"); -echo "Дескриптор: ".$d->handle."<br>\n"; -echo "Путь: ".$d->path."<br>\n"; +$d = dir("/etc/php5"); +echo "Дескриптор: " . $d->handle . "\n"; +echo "Путь: " . $d->path . "\n"; while (false !== ($entry = $d->read())) { - echo $entry."<br>\n"; + echo $entry."\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> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Дескриптор: Resource id #2 +Путь: /etc/php5 +. +.. +apache +cgi +cli +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Порядок, в котором метод "read" возвращает элементы каталога, + зависит от операционной системы. + </para> + </note> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -92,7 +108,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1424) next »