824995d3284caf391fc9a05d28944277d7ea41bc
[scilab.git] / scilab / modules / string / help / ru_RU / length.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) INRIA -
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <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" xml:id="length" xml:lang="ru">
17     <refnamediv>
18         <refname>length</refname>
19         <refpurpose>длина объекта</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Синтаксис</title>
23         <synopsis>n = length(M)</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Аргументы</title>
27         <variablelist>
28             <varlistentry>
29                 <term>M</term>
30                 <listitem>
31                     <para>
32                         матрица (обычная или полиномиальная или символьных строк) или список.
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>n</term>
38                 <listitem>
39                     <para>
40                         целое число или матрица целочисленных значений.
41                     </para>
42                 </listitem>
43             </varlistentry>
44         </variablelist>
45     </refsection>
46     <refsection>
47         <title>Описание</title>
48         <para>
49             Для обычной или полиномиальной матрицы <varname>n</varname> является целым числом, равным произведению количества строк и
50             столбцов <varname>M</varname>. (Также корректно и для матрицы
51             логических значений <varname>M</varname>).
52         </para>
53         <para>
54             Для матриц, составленных из символьных строк (и, в частности, для
55             символьной строки), функция <function>length</function> возвращает
56             в <varname>n</varname> длину элементов матрицы символьных строк
57             <varname>M</varname>.
58         </para>
59         <para>
60             Длина списка - это количество элементов в списке (также получается с помощью функции <function>size</function>).
61         </para>
62         <para>
63             Длина матричноориентированного списка (mlist) равна по умолчанию
64             количеству элементов в этом списке, но вы можете перегрузить <function>length</function> (см. пример).
65         </para>
66         <para>
67             <code>length('123')</code> равно <literal>3</literal>.
68             <code>length([1,2;3,4])</code> равно <literal>4</literal>.
69         </para>
70         <para>
71             <warning>
72                 Внимание: <function>length</function> разрежённой матрицы
73                 возвращает максимум размерностей а не произведение
74                 размерностей. (Например: <code>length(sparse(eye(12,2)))</code>
75                 возвращает <code>max(12,2)</code> а не <literal>24</literal>).
76                 Пожалуйста, к разрежённой матрице применяйте
77                 <literal>size(...,'*')</literal>.
78             </warning>
79         </para>
80     </refsection>
81     <refsection>
82         <title>Примеры</title>
83         <programlisting role="example"><![CDATA[
84 length([123 ; 456 ])
85 length(['hello world',SCI])
86     ]]></programlisting>
87         <programlisting role="example"><![CDATA[
88 a = mlist(["myMlistT" "field1" "field2"],"aexample","bexampleb");
89 length(a)
90 // возвращает 3, поведение по умолчанию, если length не перегружена для
91 // матричноориентированного списка (mlist)
92
93 // создадим функцию перегрузки для матричноориентированного списка типа
94 // myMlistT
95 function r = %myMlistT_length(M)
96     r = length(M.field1)
97 endfunction
98 length(a)
99 // returns 8 result of length(a.field1)
100     ]]></programlisting>
101     </refsection>
102     <refsection role="see also">
103         <title>Смотрите также</title>
104         <simplelist type="inline">
105             <member>
106                 <link linkend="size">size</link>
107             </member>
108         </simplelist>
109     </refsection>
110     <refsection>
111         <title>История</title>
112         <revhistory>
113             <revision>
114                 <revnumber>5.4.0</revnumber>
115                 <revremark>
116                     Эта функция позволяет перегрузку для типа mlist.
117                 </revremark>
118             </revision>
119         </revhistory>
120     </refsection>
121 </refentry>