svn: /phpdoc/ru/trunk/reference/dir/functions/ class.dir.xml
| From: | Shein Alexey | 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