* Bug #15472 fixed - mdelete('test') worked like mdelete('test.*') under Windows
[scilab.git] / scilab / modules / fileio / help / ru_RU / listfiles.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  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19           xml:lang="ru" xml:id="listfiles">
20     <refnamediv>
21         <refname>listfiles</refname>
22         <refpurpose>список файлов</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Синтаксис</title>
26         <synopsis>files = listfiles(paths [,flag,flagexpand])</synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Аргументы</title>
30         <variablelist>
31             <varlistentry>
32                 <term>paths</term>
33                 <listitem>
34                     <para>
35                         матрица строк, указывающая набор имён путей (обычно
36                         оканчивающихся шаблоном, построенным с <literal>*</literal>).
37                     </para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>flag, flagexpand</term>
42                 <listitem>
43                     <para>
44                         логические необязательные параметры (значение по умолчанию равно
45                         <constant>%t</constant>).
46                     </para>
47                 </listitem>
48             </varlistentry>
49             <varlistentry>
50                 <term>files</term>
51                 <listitem>
52                     <para>матрица строк.</para>
53                 </listitem>
54             </varlistentry>
55         </variablelist>
56     </refsection>
57     <refsection>
58         <title>Описание</title>
59         <para>
60             Функция <function>listfiles</function> может быть использована для
61             составления списка файлов, которые соответствуют шаблонам, указанным
62             одним из элементов путей. Шаблоны указываются Unix-команде
63             <command>ls</command> или Windows-команде <command>dir</command> для
64             получения информации о файлах. Таким образом, чтобы написать переносимый
65             Scilab-сценарий, следует указывать корректные знаки шаблонов для обеих
66             ОС. Заметьте, что выполняется преобразование имени пути и, например,
67             <literal>SCI/core/macros/*.sci</literal> является корректным шаблоном
68             как для Unix, так и для Windows.
69         </para>
70         <para>
71             Если <varname>flag</varname> равен ИСТИНЕ, то имена пути, указанные с
72             помощью <varname>paths</varname>, преобразуются в соответствии со
73             значением <code>getos() == 'Windows'</code> (см. также <link linkend="pathconvert">pathconvert</link>).
74             Более того, если <varname>flagexpand</varname> равен ИСТИНЕ, то
75             начальные строки, такие как <literal>SCIHOME</literal>,
76             <literal>SCI</literal> или <literal>~</literal> расширяются с помощью
77             переменных окружения.
78         </para>
79         <para>
80             Если входной путь является именем директории, то возвращаемые имена
81             файлов <varname>files</varname> относятся к этой директории.
82         </para>
83         <para>
84             Если входные пути содержат шаблон (например <literal>"/*"</literal>,
85             <literal>"*.c"</literal>), то к возвращаемым именам файлов <varname>files</varname>
86             добавляется начало входного пути.
87         </para>
88     </refsection>
89     <refsection>
90         <title>Примеры</title>
91         <programlisting role="example">
92             <![CDATA[
93 files=listfiles(['SCI/modules/core/macros/*.sci';'SCI/modules/core/macros/*.bin']);
94  ]]>
95         </programlisting>
96     </refsection>
97     <refsection role="see also">
98         <title>Смотрите также</title>
99         <simplelist type="inline">
100             <member>
101                 <link linkend="findfiles">findfiles</link>
102             </member>
103             <member>
104                 <link linkend="basename">basename</link>
105             </member>
106             <member>
107                 <link linkend="pathconvert">pathconvert</link>
108             </member>
109         </simplelist>
110     </refsection>
111     <refsection>
112         <title>История</title>
113         <revhistory>
114             <revision>
115                 <revnumber>5.4.0</revnumber>
116                 <revremark>
117                     Если пути не являются одиночной строкой, то все возвращаемые файлы
118                     представляются единообразно в форме абсолютного пути.
119                 </revremark>
120             </revision>
121             <revision>
122                 <revnumber>6.0.2</revnumber>
123                 <revremark>
124                     Under Windows, up to 6.0.1, <literal>listfile("test")</literal> actually
125                     performed <literal>listfile("test.*")</literal>. It is no longer the case.
126                 </revremark>
127             </revision>
128         </revhistory>
129     </refsection>
130 </refentry>
131