Indent all the XML files to the same way
[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>