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>