Revision of help pages for poly function after commit 19f65129f614e293dd5663e8f6e0ef0...
[scilab.git] / scilab / modules / data_structures / help / ru_RU / list.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) 2006-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-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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="list">
14     <refnamediv>
15         <refname>list</refname>
16         <refpurpose>объект Scilab'а и функция определения списка</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>Последовательность вызова</title>
20         <synopsis>list(a1, ..., an)</synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>Описание</title>
24         <para>
25             Создаёт список <literal>list</literal> с элементами
26             <varname>ai</varname>, которые являются произвольными объектами Scilab'а (<literal>matrix</literal>,
27             <literal>list</literal>,...). Тип объекта  <literal>list</literal> равен 15. <code>list()</code>
28             создаёт пустой список (0 элементов).
29         </para>
30     </refsection>
31     <refsection>
32         <title>Операции со списками</title>
33         <variablelist>
34             <varlistentry>
35                 <term>выделение</term>
36                 <listitem>
37                     <para>
38                         <literal>[x,y,z,...]=L(v)</literal>, где <literal>v</literal> - вектор индексов;
39                         <literal>[x,y,z,...]=L(:)</literal> выделяет все элементы.
40                     </para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>вставка на место индекса i</term>
45                 <listitem>
46                     <para>
47                         <code>L(i)=a</code> (заметьте, что это не ошибка использовать <code>L(i)=a</code> с
48                         <code><![CDATA[i > 1 + size(L)]]></code>, но
49                         некоторые элементы списка тогда не определены, и их
50                         выделение вызовет ошибку).
51                     </para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>добавление элемента в хвост</term>
56                 <listitem>
57                     <para>
58                         <code>L($+1)=e</code>.
59                     </para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>добавление элемента в начало</term>
64                 <listitem>
65                     <para>
66                         <code>L(0)=e</code>.
67                         <note>
68                             После этой операции <literal>e</literal> имеет индекс 1, исходные элементы будут сдвинуты вправо.
69                         </note>
70                     </para>
71                 </listitem>
72             </varlistentry>
73             <varlistentry>
74                 <term>удаление</term>
75                 <listitem>
76                     <para>
77                         <code>L(i)=null()</code> удаляет <literal>i</literal>-тый элемент списка <literal>L</literal>.
78                     </para>
79                 </listitem>
80             </varlistentry>
81             <varlistentry>
82                 <term>конкатенация двух списков</term>
83                 <listitem>
84                     <para>
85                         <code>L3 = lstcat(L1,L2)</code>.
86                     </para>
87                 </listitem>
88             </varlistentry>
89             <varlistentry>
90                 <term>число элементов списка</term>
91                 <listitem>
92                     <para>
93                         вы можете использовать либо <code>nb_elm = size(L)</code>, либо <code>nb_elm = length(L)</code>.
94                     </para>
95                 </listitem>
96             </varlistentry>
97             <varlistentry>
98                 <term>итерации со списками</term>
99                 <listitem>
100                     <para>
101                         можно использовать список <literal>L</literal> в цикле <link linkend="for">for</link>:
102                         <literal>for e=L,...,end</literal> - цикл с числом
103                         итераций <literal>length(L)</literal>, переменная
104                         цикла <literal>e</literal> будет равна <literal>L(i)</literal>
105                         на <literal>i</literal>-той итерации.
106                     </para>
107                 </listitem>
108             </varlistentry>
109         </variablelist>
110     </refsection>
111     <refsection>
112         <title>Примечания</title>
113         <para>
114             Scilab предлагает также другие виды списков, тип <link linkend="tlist">tlist</link> (типизированный список)
115             и тип <link linkend="mlist">mlist</link> (матричноориентированный список), которые полезны для определения нового типа данных с механизмом 
116             <link linkend="overloading">перегрузки</link> операторов (<link linkend="hypermatrices">гиперматрицы</link>, которые являются многомерными массивами, в Scilab'е на самом деле имеют тип <emphasis>mlist</emphasis>).
117         </para>
118         <para>
119             Также доступны структуры <emphasis>struct</emphasis> Matlab'а.
120         </para>
121     </refsection>
122     <refsection>
123         <title>Примеры</title>
124         <programlisting role="example"><![CDATA[
125 l = list(1,["a" "b"])
126 l(0) = "foo"
127 l($+1) = "hello"
128 l(2) = "toto"
129 l(3) = rand(1,2)
130 l(3) = null()
131 lbis = list("gewurtz", "caipirina" ,"debug")
132 lter = lstcat(l,lbis)
133 size(lter) - size(lbis) - size(l)  // должен быть ноль
134  ]]></programlisting>
135     </refsection>
136     <refsection role="see also">
137         <title>Смотрите также</title>
138         <simplelist type="inline">
139             <member>
140                 <link linkend="null">null</link>
141             </member>
142             <member>
143                 <link linkend="lstcat">lstcat</link>
144             </member>
145             <member>
146                 <link linkend="tlist">tlist</link>
147             </member>
148             <member>
149                 <link linkend="mlist">mlist</link>
150             </member>
151             <member>
152                 <link linkend="insertion">вставка</link>
153             </member>
154             <member>
155                 <link linkend="extraction">выделение</link>
156             </member>
157             <member>
158                 <link linkend="size">size</link>
159             </member>
160             <member>
161                 <link linkend="length">length</link>
162             </member>
163         </simplelist>
164     </refsection>
165 </refentry>