Update cell help page.
[scilab.git] / scilab / modules / data_structures / help / ru_RU / cell.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) 2007-2008 - INRIA
5 *
6 * This file must be used under the terms of the CeCILL.
7 * This source file is licensed as described in the file COPYING, which
8 * you should have received as part of this distribution.  The terms
9 * are also available at
10 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11 *
12 -->
13 <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" xmlns:scilab="http://www.scilab.org" xml:id="cell" xml:lang="ru">
14     <refnamediv>
15         <refname>cell</refname>
16         <refpurpose>создаёт cell-массив пустых матриц</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>Последовательность вызова</title>
20         <synopsis>
21             c = cell()
22             c = cell(m1)
23             c = cell(m1, m2)
24             c = cell(m1, m2, ..., mn)
25             c = cell(x)
26         </synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Аргументы</title>
30         <variablelist>
31             <varlistentry>
32                 <term>x</term>
33                 <listitem>
34                     <para>
35                         целочисленный вектор, содержащий размеры cell-массива, который требуется создать.
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>m1, m2, ..., mn</term>
41                 <listitem>
42                     <para>
43                         целые числа: размеры cell-массива, который
44                         требуется создать.
45                     </para>
46                 </listitem>
47             </varlistentry>
48         </variablelist>
49     </refsection>
50     <refsection>
51         <title>Описание</title>
52         <para>
53             Функция <function>cell</function> возвращает cell-массив пустых матриц.
54         </para>
55         <variablelist>
56             <varlistentry>
57                 <term>cell()</term>
58                 <listitem>
59                     <para>
60                         возвращает cell-массив размером <literal>0 x 0</literal> пустых матриц.
61                     </para>
62                 </listitem>
63             </varlistentry>
64             <varlistentry>
65                 <term>cell(m1)</term>
66                 <listitem>
67                     <para>
68                         возвращает cell-массив размером <literal>m1 x m1)</literal> пустых матриц.
69                     </para>
70                 </listitem>
71             </varlistentry>
72             <varlistentry>
73                 <term>cell(m1, m2)</term>
74                 <listitem>
75                     <para>
76                         возвращает cell-массив размером <literal>m1 x m2</literal> пустых матриц.
77                     </para>
78                 </listitem>
79             </varlistentry>
80             <varlistentry>
81                 <term>cell(m1, m2, ..., mn)</term>
82                 <listitem>
83                     <para>
84                         создаёт cell-массив размером <literal>m1 x m2 x ... x mn</literal> пустых матриц.
85                     </para>
86                 </listitem>
87             </varlistentry>
88             <varlistentry>
89                 <term>cell(x)</term>
90                 <listitem>
91                     <para>
92                         возвращает cell-массив пустых матриц у которого первая размерность равна <literal>x(1)</literal>, вторая размерность равна <literal>x(2)</literal> и так далее.
93                     </para>
94                 </listitem>
95             </varlistentry>
96         </variablelist>
97     </refsection>
98     <refsection>
99         <title>Примечания</title>
100         <para>
101             У <code>cell(x)</code> не такой же размер, как у <varname>x</varname>.
102         </para>
103         <para>
104             <code>cell()</code> эквивалентна <code>cell(0)</code>.
105         </para>
106         <para>
107             Если <literal>A</literal> является cell-массивом, то у вас есть
108             допуск к содержимому элемента <literal>A</literal> с помощью
109             <code>A{m1, m2, ..., mn}</code>. Инструкция
110             <code>A(1,1) = zeros(2,2)</code> не допустима, правильным
111             синтаксисом является <code>A{1,1} = zeros(2,2)</code>.
112         </para>
113     </refsection>
114     <refsection>
115         <title>Примеры</title>
116         <programlisting role="example"><![CDATA[
117 a = cell(3)
118 b = cell(3,1)
119 c = cell([2,3,4])
120  
121 // Assigning cell entries
122 b = cell(3,1);
123  
124 // Assigning the first element of b using {}
125 b{1} = 1:3
126  
127 // Assigning the second element of b using {}
128 b{2} = 'Scilab'
129  
130 // Assigning the third element of b using the 'entries' field
131 b{3} = poly(1:3,'s')
132  
133 // Assigning sub-cells
134 X = cell(3,2);
135 X{:,1} = b
136  
137 // Extracting a sub-cell: result is a cell
138 b{1}
139 b{1:2}
140  
141 // Extracting a sub-cell value: result is an array
142 b{1}
143  
144 // Dimensions of b as a double value
145 size(b)
146 ]]></programlisting>
147     </refsection>
148     <refsection role="see also">
149         <title>Смотрите также</title>
150         <simplelist type="inline">
151             <member>
152                 <link linkend="eye">eye</link>
153             </member>
154             <member>
155                 <link linkend="ones">ones</link>
156             </member>
157             <member>
158                 <link linkend="zeros">zeros</link>
159             </member>
160             <member>
161                 <link linkend="iscell">iscell</link>
162             </member>
163         </simplelist>
164     </refsection>
165     <refsection>
166         <title>History</title>
167         <revhistory>
168             <revision>
169                 <revnumber>6.0.0</revnumber>
170                 <revremark>
171                     <para>
172                         Fields "entries" and "dims" do not exist anymore. To assign or extract an element, use {}.
173                     </para>
174                 </revremark>
175             </revision>
176         </revhistory>
177     </refsection>
178 </refentry>
179