Elementary functions: improved help pages.
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / setoperations / intersect.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry version="5.0-subset Scilab" xml:id="intersect" xml:lang="fr"
3           xmlns="http://docbook.org/ns/docbook"
4           xmlns:xlink="http://www.w3.org/1999/xlink"
5           xmlns:svg="http://www.w3.org/2000/svg"
6           xmlns:ns5="http://www.w3.org/1999/xhtml"
7           xmlns:mml="http://www.w3.org/1998/Math/MathML"
8           xmlns:db="http://docbook.org/ns/docbook">
9   <info>
10     <pubdate>$LastChangedDate$</pubdate>
11   </info>
12
13   <refnamediv>
14     <refname>intersect</refname>
15
16     <refpurpose>recherche de valeurs communes à deux vecteurs.</refpurpose>
17   </refnamediv>
18
19   <refsynopsisdiv>
20     <title>Séquence d'appel</title>
21
22     <synopsis>
23       [v [,ka,kb]]=intersect(a,b)
24       [v [,ka,kb]]=intersect(a,b,orient)
25     </synopsis>
26   </refsynopsisdiv>
27
28   <refsection>
29     <title>Paramètres</title>
30
31     <variablelist>
32       <varlistentry>
33         <term>a</term>
34
35         <listitem>
36           <para>vecteur de nombres ou de chaînes de caractères</para>
37         </listitem>
38       </varlistentry>
39
40       <varlistentry>
41         <term>b</term>
42
43         <listitem>
44           <para>vecteur de nombres ou de chaînes de caractères</para>
45         </listitem>
46       </varlistentry>
47
48       <varlistentry>
49         <term>v</term>
50
51         <listitem>
52           <para>vecteur ligne ou matrice de nombres ou de chaînes de
53           caractères</para>
54         </listitem>
55       </varlistentry>
56
57       <varlistentry>
58         <term>ka</term>
59
60         <listitem>
61           <para>vecteur ligne d'entiers</para>
62         </listitem>
63       </varlistentry>
64
65       <varlistentry>
66         <term>kb</term>
67
68         <listitem>
69           <para>vecteur ligne d'entiers</para>
70         </listitem>
71       </varlistentry>
72     </variablelist>
73   </refsection>
74
75   <refsection>
76     <title>Description</title>
77
78     <para><literal>intersect(a,b)</literal> renvoie un vecteur trié des
79     valeurs communes à <literal>a</literal> et <literal>b</literal>. A noter
80     que 2 NaN sont toujours considéré comme différents.</para>
81
82     <para><literal>[v,ka,kb]=intersect(a,b)</literal> renvoie aussi deux
83     vecteurs d'indices <literal>ka</literal> et <literal>kb</literal> tels que
84     <literal>v=a(ka)</literal> et <literal>v=b(kb)</literal>.</para>
85
86     <para><literal>intersect(a,b,"r")</literal> ou
87     <literal>intersect(a,b,1)</literal> retourne la matrice formée de
88     l'intersection des lignes distinctes des matrices <literal>a</literal> et
89     <literal>b</literal> triées dans l'ordre lexicographique croissant. Dans
90     ce cas les matrices <literal>a</literal> et <literal>b</literal> doivent
91     avoir le même nombre de colonnes.</para>
92
93     <para><literal>[v,ka,kb]=intersect(a,b,"r")</literal> retourne aussi les
94     vecteurs d'indices <literal>ka</literal> et <literal>kb</literal> tels que
95     <literal>v=a(ka,:)</literal> et <literal>v=b(kb,:)</literal>.</para>
96
97     <para><literal>intersect(a,b,"c")</literal> ou
98     <literal>intersect(a,b,2)</literal> retourne la matrice formée de
99     l'intersection des colonnes distinctes des matrices <literal>a</literal>
100     et <literal>b</literal> triées dans l'ordre lexicographique croissant.
101     Dans ce cas les matrices <literal>a</literal> et <literal>b</literal>
102     doivent avoir le même nombre de lignes.</para>
103
104     <para><literal>[v,ka,kb]=intersect(a,b,"r")</literal> retourne aussi les
105     vecteurs d'indices <literal>ka</literal> et <literal>kb</literal> tels que
106     <literal>v=a(:,ka)</literal> et <literal>v=b(:,kb)</literal>.</para>
107   </refsection>
108
109   <refsection>
110     <title>Exemples</title>
111
112     <programlisting role="example"><![CDATA[ 
113 A=round(5*rand(10,1));
114 B=round(5*rand(7,1));
115
116 intersect(A,B)
117 [N,ka,kb]=intersect(A,B)
118
119 intersect('a'+string(A),'a'+string(B))
120
121
122
123 intersect(int16(A),int16(B))
124
125 //with matrices
126  A = [0,0,1,1 1;
127       0,1,1,1,1;
128       2,0,1,1,1;
129       0,2,2,2,2;
130       2,0,1,1,1;
131       0,0,1,1,%nan];
132 B = [1,0,1;
133      1,0,2;
134      1,2,3;
135      2,0,4;
136      1,2,5;
137      %nan,0,6];
138
139 [v,ka,kb] = intersect(A,B,'c')
140 A(:,ka)
141  ]]></programlisting>
142   </refsection>
143
144   <refsection role="see also">
145 <title>Voir aussi</title>
146
147     <simplelist type="inline">
148       <member><link linkend="unique">unique</link></member>
149
150       <member><link linkend="gsort">gsort</link></member>
151
152       <member><link linkend="union">union</link></member>
153     </simplelist>
154   </refsection>
155 </refentry>