Translation of help page for clean function into Russian.
[scilab.git] / scilab / modules / fileio / help / ru_RU / save_format.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:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="save_format" xml:lang="ru">
15     <refnamediv>
16         <refname>save_format</refname>
17         <refpurpose>формат файлов, созданных функцией "save"</refpurpose>
18     </refnamediv>
19     <refsection>
20         <title>Описание</title>
21         <para>
22             Переменные сохраняются Scilab'ом с помощью функции <link linkend="save">save</link> в следующем формате:
23         </para>
24         <para>
25             каждая запись переменной добавляется в файл последовательно. Запись переменной начинается с 6-ти чисел типа длинное целое, хранящих имя переменной в кодированном формате (см. раздел Примечания ниже), после чего следует тип переменной (длинное цело), затем, в зависимости от него, следует:
26         </para>
27         <variablelist>
28             <varlistentry>
29                 <term>Матрицы значений с плавающей запятой (тип 1)</term>
30                 <listitem>
31                     <para>
32                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
33                     </para>
34                     <para>
35                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
36                     </para>
37                     <para>
38                         признак вещественности/комплекснозначности <varname>it</varname> (целое число типа long integer на интервале <literal>{0,1}</literal>),
39                     </para>
40                     <para>
41                         данные (<literal>n*m*(it+1)</literal> чисел типа double)
42                     </para>
43                 </listitem>
44             </varlistentry>
45         </variablelist>
46         <variablelist>
47             <varlistentry>
48                 <term>Полиномы (тип 2) и Неявный полином размера, используемый для (тип 129)</term>
49                 <listitem>
50                     <para>
51                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
52                     </para>
53                     <para>
54                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
55                     </para>
56                     <para>
57                         признак вещественности/комплекснозначности <varname>it</varname> (целое число типа long integer в интервале <literal>{0,1}</literal>),
58                     </para>
59                     <para>
60                         формальное имя переменной (16 байт),
61                     </para>
62                     <para>
63                         <varname>index_table</varname> (таблица индексов, <literal>m*n+1</literal> целых чисел типа long integer),
64                     </para>
65                     <para>
66                         данные (<literal>(N-1)*(it+1)</literal> чисел типа double), где <varname>N</varname> -- это значение последнего элемента таблицы индексов <varname>index_table</varname>.
67                     </para>
68                 </listitem>
69             </varlistentry>
70         </variablelist>
71         <variablelist>
72             <varlistentry>
73                 <term>Booleans (тип 4)</term>
74                 <listitem>
75                     <para>
76                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
77                     </para>
78                     <para>
79                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
80                     </para>
81                     <para>
82                         данные (<literal>n*m</literal> целых чисел типа long integer).
83                     </para>
84                 </listitem>
85             </varlistentry>
86         </variablelist>
87         <variablelist>
88             <varlistentry>
89                 <term>Разрежённые матрицы чисел с плавающей запятой (тип 5)</term>
90                 <listitem>
91                     <para>
92                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
93                     </para>
94                     <para>
95                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
96                     </para>
97                     <para>
98                         real/complex_flag <varname>it</varname> (целое число типа long integer на интервале <literal>{0,1}</literal>),
99                     </para>
100                     <para>
101                         <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (общее количество ненулевых элементов, число типа long integer),
102                     </para>
103                     <para>
104                         <varname>number_of_non_zero_elements_per_row</varname> (число количество ненулевых элементов на строку, <literal>m</literal> целых чисел типа long integer),
105                     </para>
106                     <para>
107                         <varname>column_index_non_zero_elements</varname> (индексы столбцов ненулевых элементов, <literal>nel</literal> целых чисел типа long integer),
108                     </para>
109                     <para>
110                         <varname>non_zero_values</varname> (ненулевые значения, <literal>nel*(it+1)</literal> чисел типа double).
111                     </para>
112                 </listitem>
113             </varlistentry>
114         </variablelist>
115         <variablelist>
116             <varlistentry>
117                 <term>Разрежённые матрицы логических значений (тип 6)</term>
118                 <listitem>
119                     <para>
120                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
121                     </para>
122                     <para>
123                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
124                     </para>
125                     <para>
126                         неиспользуемое <varname>it</varname> (целое число типа long integer),
127                     </para>
128                     <para>
129                         <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (общее количество ненулевых элементов, число типа long integer),
130                     </para>
131                     <para>
132                         <varname>number_of_non_zero_elements_per_row</varname> (число количество ненулевых элементов на строку, <literal>m</literal> целых чисел типа long integer),
133                     </para>
134                     <para>
135                         <varname>column_index_non_zero_elements</varname> (индексы столбцов ненулевых элементов, <literal>nel</literal> целых чисел типа long integer).
136                     </para>
137                 </listitem>
138             </varlistentry>
139         </variablelist>
140         <variablelist>
141             <varlistentry>
142                 <term>Разрежённая матрица Matlab'а (тип 7)</term>
143                 <listitem>
144                     <para>
145                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
146                     </para>
147                     <para>
148                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
149                     </para>
150                     <para>
151                         real/complex_flag <varname>it</varname> (целое число типа long integer на интервале <literal>{0,1}</literal>),
152                     </para>
153                     <para>
154                         <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (общее количество ненулевых элементов, число типа long integer),
155                     </para>
156                     <para>
157                         <varname>number_of_non_zero_elements_per_column</varname> (количество ненулевых элементов на столбец, <literal>n</literal> целых чисел типа long integer),
158                     </para>
159                     <para>
160                         <varname>row_index_non_zero_elements</varname> (индекс строки ненулевых элементов, <literal>nel</literal> целых чисел типа long integer),
161                     </para>
162                     <para>
163                         <varname>non_zero_values</varname> (ненулевые значения, <literal>nel*(it+1)</literal> чисел типа double).
164                     </para>
165                 </listitem>
166             </varlistentry>
167         </variablelist>
168         <variablelist>
169             <varlistentry>
170                 <term>матрицы целых чисел (тип 8)</term>
171                 <listitem>
172                     <para>
173                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
174                     </para>
175                     <para>
176                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
177                     </para>
178                     <para>
179                         <varname>integer_type</varname> (тип целого числа, число типа long integer): 1, 2, 4, или 11, 12, 14 для знаковых и беззнаковых 1-, 2-, 4-байтных целых чисел,
180                     </para>
181                     <para>
182                         данные (<literal>n*m</literal> байт для  <varname>integer_type</varname> 1 или 11, <literal>n*m</literal> чисел типа short integer для <varname>integer_type</varname> 2 или 12, <literal>n*m</literal> целых чисел типа long integer для <varname>integer_type</varname> 4 или 14).
183                     </para>
184                 </listitem>
185             </varlistentry>
186         </variablelist>
187         <variablelist>
188             <varlistentry>
189                 <term>handles (тип 9)</term>
190                 <listitem>
191                     <para>version (4 bytes)</para>
192                     <para>
193                         <varname>row_size</varname> <varname>m</varname> (размер строки, байт),
194                     </para>
195                     <para>
196                         <varname>column_size</varname> <varname>n</varname> (размер столбца, байт),
197                     </para>
198                     <para>
199                         данные (<literal>m*n</literal> записей в последовательной форме <varname>serialization_record</varname>)
200                     </para>
201                     <para>
202                         Запись в последовательной форме <varname>serialization_record</varname> -- это представление в плоском виде C-структуры данных, связанной с соответствующим графическим объектом. Каждый графический объект определяется (рекурсивным) набором свойств (см. справку по функции <link linkend="get">get</link>).
203                     </para>
204                     <para>
205                         Сохранённая запись <varname>serialization_record</varname> графического объекта структурирована в следующем виде:
206                     </para>
207                     <variablelist>
208                         <varlistentry>
209                             <term>serialization_record</term>
210                             <listitem>
211                                 <para>
212                                     длина типа <varname>type_length</varname> <varname>n</varname> (байт),
213                                 </para>
214                                 <para>
215                                     тип <varname>type</varname> (<literal>n</literal> байт, ascii-коды имени типа),
216                                 </para>
217                                 <para>
218                                     запись <varname>property_values</varname> (переменная длина).
219                                 </para>
220                             </listitem>
221                         </varlistentry>
222                     </variablelist>
223                 </listitem>
224             </varlistentry>
225         </variablelist>
226         <variablelist>
227             <varlistentry>
228                 <term>Строки (тип 10)</term>
229                 <listitem>
230                     <para>
231                         <varname>row_size</varname> <varname>m</varname> (размер строки, число типа long integer),
232                     </para>
233                     <para>
234                         <varname>column_size</varname> <varname>n</varname> (размер столбца, число типа long integer),
235                     </para>
236                     <para>
237                         <varname>index_table</varname> (<literal>n*m+1</literal> целых чисел типа long integer),
238                     </para>
239                     <para>
240                         данные (<literal>N</literal> целых чисел типа long integer, Scilab-кодировка символов (см. <link linkend="code2str">code2str</link>), где <literal>N</literal> -- это значение последнего элемента таблицы индексов <varname>index_table</varname>.
241                     </para>
242                 </listitem>
243             </varlistentry>
244         </variablelist>
245         <variablelist>
246             <varlistentry>
247                 <term>Некомпилированные функции (тип 11)</term>
248                 <listitem>
249                     <para>
250                         <varname>nout</varname> (целое число типа long integer),
251                     </para>
252                     <para>
253                         <varname>lhs_names</varname> (<literal>6*nout</literal> целых чисел типа long integer, см. раздел "Примечания" ниже),
254                     </para>
255                     <para>
256                         <varname>nin</varname> (целое число типа long integer),
257                     </para>
258                     <para>
259                         <varname>rhs_names</varname> (<literal>6*nin</literal> целых чисел типа long integer, см. раздел "Примечания" ниже),
260                     </para>
261                     <para>
262                         <varname>code_length</varname> <varname>N</varname> (целое число типа long integer),
263                     </para>
264                     <para>
265                         <varname>code</varname> (<literal>N</literal> целых чисел типа long integer).
266                     </para>
267                 </listitem>
268             </varlistentry>
269         </variablelist>
270         <variablelist>
271             <varlistentry>
272                 <term>Компилированные функции (тип 13)</term>
273                 <listitem>
274                     <para>
275                         <varname>nout</varname> (целое число типа long integer),
276                     </para>
277                     <para>
278                         <varname>lhs_names</varname> (<literal>6*nout</literal> целых чисел типа long integer, см. раздел "Примечания" ниже),
279                     </para>
280                     <para>
281                         <varname>nin</varname> (целое число типа long integer),
282                     </para>
283                     <para>
284                         <varname>rhs_names</varname> (<literal>6*nin</literal> целых чисел типа long integer, см. раздел "Примечания" ниже),
285                     </para>
286                     <para>
287                         <varname>pseudo_code_length</varname> <varname>N</varname> (целое число типа long integer),
288                     </para>
289                     <para>
290                         <varname>pseudo_code</varname> (<literal>N</literal> целых чисел типа long integer).
291                     </para>
292                 </listitem>
293             </varlistentry>
294         </variablelist>
295         <variablelist>
296             <varlistentry>
297                 <term>Библиотеки (тип 14)</term>
298                 <listitem>
299                     <para>
300                         <varname>path_length</varname> <varname>np</varname> (длина пути, целое число типа long integer),
301                     </para>
302                     <para>
303                         <varname>path_name</varname> (имя пути, <literal>np</literal> целых чисел типа long integer: последовательность кодов символов пути, (см. <link linkend="code2str">code2str</link>)),
304                     </para>
305                     <para>
306                         количество имён <varname>nn</varname> (целое число типа long integer),
307                     </para>
308                     <para>
309                         имена (<literal>6*nn</literal> целых чисел типа long integer, см. раздел "Примечания" ниже).
310                     </para>
311                 </listitem>
312             </varlistentry>
313         </variablelist>
314         <variablelist>
315             <varlistentry>
316                 <term>списки (тип 15), типизированные списки (тип 16), матричноориентированные списки (тип 17)</term>
317                 <listitem>
318                     <para>
319                         количество полей <varname>n</varname> (целое число типа long integer),
320                     </para>
321                     <para>
322                         индекс (<literal>n+1</literal> целых чисел типа long integer),
323                     </para>
324                     <para>
325                         последовательность переменных <varname>variables_sequence</varname> (<literal>n</literal> переменных, каждое из которых записано в своём формате).
326                     </para>
327                 </listitem>
328             </varlistentry>
329         </variablelist>
330         <variablelist>
331             <varlistentry>
332                 <term>Указатели (тип 128)</term>
333                 <listitem>
334                     <para>Не обрабатываются</para>
335                 </listitem>
336             </varlistentry>
337         </variablelist>
338         <variablelist>
339             <varlistentry>
340                 <term>Указатели на функцию (тип 130)</term>
341                 <listitem>
342                     <para>
343                         <varname>function_ptr</varname> (указатель на функцию, целое число типа long integer, (see <link linkend="funptr">funptr</link>)),
344                     </para>
345                     <para>
346                         <varname>function_name_code</varname> (код имени функции, 6 целых чисел типа long integer, см. раздел "Примечания" ниже).
347                     </para>
348                 </listitem>
349             </varlistentry>
350         </variablelist>
351     </refsection>
352     <refsection>
353         <title>Примечания</title>
354         <para>
355             Числа (типа long interger, short integer, double) хранятся в прямом порядке байтов.
356         </para>
357         <para>
358             Имена переменных хранятся в виде последовательности из 6 целых чисел типа long integer с особой кодировкой. См. подробности в файле <literal>cvname.f</literal>.
359         </para>
360     </refsection>
361     <refsection role="see also">
362         <title>Смотрите также</title>
363         <simplelist type="inline">
364             <member>
365                 <link linkend="save">save</link>
366             </member>
367             <member>
368                 <link linkend="load">load</link>
369             </member>
370             <member>
371                 <link linkend="listvarinfile">listvarinfile</link>
372             </member>
373             <member>
374                 <link linkend="type">type</link>
375             </member>
376             <member>
377                 <link linkend="typeof">typeof</link>
378             </member>
379         </simplelist>
380     </refsection>
381 </refentry>
382