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>