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