* Bugs 15866 & 15867 fixed: setdiff() + 'r'|'c' & integers
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / setoperations / union.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  * 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" xmlns:scilab="http://www.scilab.org" xml:id="union" xml:lang="ru">
17     <refnamediv>
18         <refname>union</refname>
19         <refpurpose>выделяет объединение компонентов векторов</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Синтаксис</title>
23         <synopsis>
24             [v [,ka, kb] ] = union(a,b)
25             [v [,ka, kb] ] = union(a,b,orient)
26         </synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Аргументы</title>
30         <variablelist>
31             <varlistentry>
32                 <term>a</term>
33                 <listitem>
34                     <para>вектор или матрица чисел или строк</para>
35                 </listitem>
36             </varlistentry>
37             <varlistentry>
38                 <term>b</term>
39                 <listitem>
40                     <para>вектор вещественных числе или строк</para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>orient</term>
45                 <listitem>
46                     <para>флаг с возможными значениями: 1 или "r", 2 или "c".</para>
47                 </listitem>
48             </varlistentry>
49             <varlistentry>
50                 <term>v</term>
51                 <listitem>
52                     <para>вектор-строка или матрица чисел или строк</para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>ka</term>
57                 <listitem>
58                     <para>вектор-строка целых чисел</para>
59                 </listitem>
60             </varlistentry>
61             <varlistentry>
62                 <term>kb</term>
63                 <listitem>
64                     <para>вектор-строка целых чисел</para>
65                 </listitem>
66             </varlistentry>
67         </variablelist>
68     </refsection>
69     <refsection>
70         <title>Описание</title>
71         <para>
72             <literal>union(a,b)</literal> возвращает отсортированный вектор-строку, который
73             содержит уникальные элементы <literal>[a(:);b(:)]</literal>.
74         </para>
75         <para>
76             <literal>union(a,b,"r")</literal> или <literal>union(a,b,1)</literal>
77             возвращает матрицу, сформированную объединением уникальных строк <literal>a</literal>
78             и <literal>b</literal>, отсортированную в лексикографическом порядке возрастания. В этом случае матрицы <literal>a</literal> и <literal>b</literal> должны иметь одинаковое количество столбцов.
79         </para>
80         <para>
81             <literal>union(a,b,"c")</literal> или <literal>union(a,b,2)</literal>
82             возвращает матрицу, сформированную объединением уникальных столбцов
83             <literal>a</literal> and <literal>b</literal>, отсортированную в лексикографическом порядке возрастания. В этом случае матрицы <literal>a</literal> и <literal>b</literal> должны иметь одинаковое количество строк.
84         </para>
85         <para>
86             <literal>[v,ka,kb]=union(a,b)</literal> также возвращает векторы индексов     <literal>ka</literal> и <literal>kb</literal> такие, что <literal>v</literal> является
87             сортированной комбинацией элементов <literal>a(ka)</literal> и
88             <literal>b(kb)</literal>.
89         </para>
90     </refsection>
91     <refsection>
92         <title>Примеры</title>
93         <programlisting role="example"><![CDATA[
94 A=round(5*rand(10,1));
95 B=round(5*rand(7,1));
96
97 union(A,B)
98 [N,ka,kb]=union(A,B)
99
100 union('a'+string(A),'b'+string(B))
101  ]]></programlisting>
102     </refsection>
103     <refsection role="see also">
104         <title>Смотрите также</title>
105         <simplelist type="inline">
106             <member>
107                 <link linkend="unique">unique</link>
108             </member>
109             <member>
110                 <link linkend="gsort">gsort</link>
111             </member>
112         </simplelist>
113     </refsection>
114 </refentry>