Fix typos in help pages of module fileio (en_US, ru_RU)
[scilab.git] / scilab / modules / fileio / help / ru_RU / mkdir.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 - Allan CORNET
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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="mkdir" xml:lang="ru">
15     <refnamediv>
16         <refname>mkdir</refname>
17         <refpurpose>создаёт новую директорию</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Последовательность вызова</title>
21         <synopsis>
22             mkdir(dirname)
23             mkdir(parentdir, dirname)
24             status = mkdir( ... )
25             [status, msg] = mkdir( ... )
26         </synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Аргументы</title>
30         <variablelist>
31             <varlistentry>
32                 <term>dirname</term>
33                 <listitem>
34                     <para>
35                         символьная строка: имя директории, которую требуется создать.
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>parentdir</term>
41                 <listitem>
42                     <para>
43                         символьная строка: имя директории в которой будет создана новая 
44                         директория <varname>dirname</varname>.
45                     </para>
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>status</term>
50                 <listitem>
51                     <para>
52                         целое число: статус работы.
53                     </para>
54                 </listitem>
55             </varlistentry>
56             <varlistentry>
57                 <term>msg</term>
58                 <listitem>
59                     <para>
60                         символьная строка: сообщение об ошибке.
61                     </para>
62                 </listitem>
63             </varlistentry>
64         </variablelist>
65     </refsection>
66     <refsection>
67         <title>Описание</title>
68         <para>
69             Инструкция <code>mkdir(dirname)</code> создаёт директорию 
70             <varname>dirname</varname> в текущей директории, если 
71             <varname>dirname</varname> представляет относительный путь. 
72             Иначе, <varname>dirname</varname> представляет абсолютный путь и 
73             функция <function>mkdir</function> пытается создать директорию с 
74             абсолютным именем <varname>dirname</varname>.
75         </para>
76         <para>
77             Инструкция <code>mkdir(parentdir, dirname)</code> создаёт 
78             директорию <varname>dirname</varname> в директории 
79             <varname>parentdir</varname> (если <varname>parentdir</varname> 
80             не существует, то она будет создана), где 
81             <varname>parentdir</varname> -- абсолютное или относительное имя.
82         </para>
83         <para>
84             Инструкция <code>[status,msg] = mkdir(parentdir, dirname)</code> 
85             создаёт директорию <varname>dirname</varname> в существующей 
86             директории <varname>parentdir</varname>, возвращая статус работы 
87             <varname>status</varname> и сообщение об ошибке 
88             <varname>msg</varname>. 
89         </para>
90         <para>   
91             <informaltable border="1">
92                 <tr>
93                     <td>
94                         <varname>status</varname>
95                     </td>
96                     <td>
97                         <varname>msg</varname>
98                     </td>
99                 </tr>
100                 <tr>
101                     <td>
102                         -2
103                     </td>
104                     <td>
105                         mkdir: Произошла ошибка: Файл с таким именем уже существует в dirname
106                         
107                     </td>
108                 </tr>
109                 <tr>
110                     <td>
111                         0
112                     </td>
113                     <td>
114                         mkdir: Произошла ошибка: Невозможно создать каталог dirname
115                         
116                     </td>
117                 </tr>
118                 <tr>
119                     <td>
120                         1
121                     </td>
122                     
123                     <td>
124                         
125                     </td>
126                 </tr>
127                 <tr>
128                     <td>
129                         2
130                     </td>
131                     <td>
132                         mkdir: Произошла ошибка: Этот каталог уже существует в dirname
133                         
134                     </td>
135                 </tr>
136             </informaltable>
137         </para>
138         <para>
139             В любой операционной системе, если создание директории удалось, то статус <varname>status</varname> равен 1, а сообщение <varname>msg</varname> пустое.
140         </para>
141     </refsection>
142     <refsection>
143         <title>Примеры</title>
144         <programlisting role="example">
145             <![CDATA[ 
146 // Абсолютное имя пути
147 mkdir(TMPDIR+"/mkdir_example_1")
148 status_2 = mkdir(TMPDIR+"/mkdir_example_2")
149 [status_3,msg_3] = mkdir(TMPDIR+"/mkdir_example_3")
150  
151 // Абсолютное имя пути (parentdir + dirname)
152 [status_4,msg_4] = mkdir(TMPDIR,"mkdir_example_4")
153  
154 // Относительное имя пути
155 cd TMPDIR;
156 [status_5,msg_5] = mkdir("mkdir_example_5")
157 [status_6,msg_6] = mkdir("mkdir_example_5/mkdir_example_6")
158  ]]>
159         </programlisting>
160     </refsection>
161     <refsection role="see also">
162         <title>Смотрите также</title>
163         <simplelist type="inline">
164             <member>
165                 <link linkend="chdir">chdir</link>
166             </member>
167             <member>
168                 <link linkend="dir">dir</link>
169             </member>
170             <member>
171                 <link linkend="rmdir">rmdir</link>
172             </member>
173         </simplelist>
174     </refsection>
175 </refentry>
176