Revision of some help pages for module fileio.
[scilab.git] / scilab / modules / fileio / help / ru_RU / dir.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  * ...
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  *
13  -->
14 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="ru" xml:id="dir">
15   <refnamediv>
16     <refname>dir</refname>
17     <refpurpose>получает список файлов</refpurpose>
18   </refnamediv>
19   <refsynopsisdiv>
20     <title>Последовательность вызова</title>
21     <synopsis>dir path
22       S=dir([path])
23     </synopsis>
24   </refsynopsisdiv>
25   <refsection>
26     <title>Аргументы</title>
27     <variablelist>
28       <varlistentry>
29         <term>path</term>
30         <listitem>
31           <para>
32             строковая матрица, указывающая путь до директории (обычно
33             заканчивающаяся маской <literal>*</literal>). Значение по
34             умолчанию <literal>.</literal> (точка).
35           </para>
36         </listitem>
37       </varlistentry>
38       <varlistentry>
39         <term>S</term>
40         <listitem>
41           <para>
42             типизированный список <literal>tlist</literal> типа
43             <literal>dir</literal> с полями:
44             <varname>name</varname>, <varname>date</varname>, <varname>bytes</varname> и <varname>isdir</varname>.
45           </para>
46         </listitem>
47       </varlistentry>
48     </variablelist>
49   </refsection>
50   <refsection>
51     <title>Описание</title>
52     <para>
53       <function>dir</function> может использоваться для получения
54       файлов, которые соответствуют шаблонам, указанным аргументом 
55       <varname>path</varname>. Шаблоны указываются для команды Unix
56       <command>ls</command> либо для команды Windows
57       <command>dir</command> для того, чтобы получить информацию о
58       файлах. Таким образом, чтобы написать переносимый Scilab-сценарий,
59       требуется указать шаблоны для обеих ОС. Заметьте, что
60       выполняется преобразование имени пути, например,
61       <literal>SCI/modules/core/macros/*.sci</literal> является
62       корректным шаблоном как для Unix, так и для Windows.
63     </para>
64     <para>
65       Поле <varname>name</varname> возвращаемой переменной является
66       вектор-столбцом имён файлов.
67     </para>
68     <para>
69       Поле <varname>date</varname> возвращаемой переменной является вектор-столбцом
70       целых чисел, содержащих дату последней модификации, кодированную
71       в секундах от 1 Янв 1970.
72     </para>
73     <para>
74       Поле <varname>bytes</varname> возвращаемой переменной является вектор-столбцом
75       целых чисел, содержащих размер файлов в байтах.
76     </para>
77     <para>
78       Поле <varname>isdir</varname> возвращаемой переменной является вектор-столбцом
79       логического значения ИСТИНА, если соответствующее имя расположено в директории.
80     </para>
81     <para>
82       Возвращаемая структура по умолчанию отображается в виде списка файлов,
83       форматированного в виде столбца. Это можно изменить,
84       переопределив функцию <function>%dir_p</function>.
85     </para>
86     <para>
87       Начиная с Scilab 5.3.1, завершение "/" или "\" (см. <link
88       linkend="filesep">filesep</link>) отображается для каждой директории.
89     </para>
90   </refsection>
91   <refsection>
92     <title>Примеры</title>
93     <programlisting role="example"><![CDATA[ 
94 dir
95 dir SCI/modules/core/macros/*.bin
96 x=dir('SCI/modules/core/macros/*.bin')
97 dt=getdate(x.date);
98 mprintf("%s: %04d-%02d-%02d %02d:%02d:%02d\n",x.name,dt(:,[1 2 6 7:9]))
99  ]]></programlisting>
100   </refsection>
101   <refsection role="see also">
102     <title>Смотрите также</title>
103     <simplelist type="inline">
104       <member>
105         <link linkend="listfiles">listfiles</link>
106       </member>
107       <member>
108         <link linkend="findfiles">findfiles</link>
109       </member>
110       <member>
111         <link linkend="ls">ls</link>
112       </member>
113       <member>
114         <link linkend="fileinfo">fileinfo</link>
115       </member>
116       <member>
117         <link linkend="date">date</link>
118       </member>
119     </simplelist>
120   </refsection>
121 </refentry>
122