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