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