[doc] misc. fix & improvements
[scilab.git] / scilab / modules / core / help / fr_FR / 1_keywords / plus.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) ???? - INRIA
5  * Copyright (C) 2018 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18         xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19         xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20         xml:lang="fr" xml:id="plus">
21     <refnamediv>
22         <refname>plus (+)</refname>
23         <refpurpose>Addition numérique. Concaténation (collage) de textes entre eux</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Séquence d'appel</title>
27         <synopsis>
28             X + Y
29             str1 + str2
30         </synopsis>
31     </refsynopsisdiv>
32     <refsection>
33         <title>Arguments</title>
34         <variablelist>
35             <varlistentry>
36                 <term>X,Y  </term>
37                 <listitem>
38                     <para>
39                         matrices booléennes, réelles, complexes, polynomiales, de fractions
40                         rationnelles, ou listes <literal>syslin</literal> représentant un système linéaire.
41                     </para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>str1,str2  </term>
46                 <listitem>
47                     <para>
48                         textes uniques, ou vecteurs ou matrices de textes.
49                     </para>
50                 </listitem>
51             </varlistentry>
52         </variablelist>
53     </refsection>
54     <refsection>
55         <title>Description</title>
56         <para>
57             Pour deux opérandes numériques, l'addition a sa signification et son résultat habituels.
58         </para>
59         <para>
60             Ajouter des booléens entre eux ou à des nombres de type entier, décimal, ou complexe
61             effectue les conversions implicites <literal>%F => 0</literal> et
62             <literal>%T => 1</literal> avant les additions. Le résultat a le type des nombres
63             en entrée, ou est de type décimal pour des booléens ajoutés entre eux.
64         </para>
65         <para>
66             <literal>+</literal> appliquée entre deux textes les concatène (colle) entre eux.
67         </para>
68         <para>
69             Si un opérande est un tableau et l'autre est un élément unique (scalaire), le scalaire
70             est appliqué (ajouté ou collé) à chaque élément du tableau.
71         </para>
72         <para>
73             Si un opérande est la matrice vide <literal>[]</literal>, le résultat est <literal>[]</literal>.
74         </para>
75         <para>
76            L'opérateur "+" peut être étendu à d'autres types d'opérandes par surcharge
77            (voir <link linkend="overloading">overloading</link>).
78         </para>
79     </refsection>
80     <refsection>
81         <title>Exemples</title>
82         <programlisting role="example"><![CDATA[
83 [1, 2] + 1
84 [] + 2
85 %s + 2
86 1/%s + %s
87 "con" + ["catenate" "crete" "sole"]
88  ]]></programlisting>
89     <screen><![CDATA[
90 --> [1, 2] + 1
91  ans  =
92    2.   3.
93
94 --> [] + 2
95  ans  =
96     []
97
98 --> %s + 2
99  ans  =
100    2 +s
101
102 --> 1/%s + %s
103  ans  =
104         2
105    1 + s
106    ------
107      s
108
109 --> "con" + ["catenate" "crete" "sole"]
110  ans  =
111 !concatenate  concrete  console  !
112 ]]></screen>
113     <para>Avec des booléens :</para>
114         <programlisting role="example"><![CDATA[
115 [%f %f %t %t] + [%f %t %f %t]
116 %f + [-1 0 2 %i]
117 %t + [-1 0 2 %i]
118  ]]></programlisting>
119     <screen><![CDATA[
120 --> [%f %f %t %t] + [%f %t %f %t]
121  ans  =
122    0.   1.   1.   2.
123
124 --> %f + [-1 0 2 %i]
125  ans  =
126   -1.   0.   2.   i
127
128 --> %t + [-1 0 2 %i]
129  ans  =
130    0.   1.   3.   1. + i
131 ]]></screen>
132     </refsection>
133     <refsection role="see also">
134         <title>Voir aussi</title>
135         <simplelist type="inline">
136             <member>
137                 <link linkend="minus">minus</link>
138             </member>
139             <member>
140                 <link linkend="symbols">operators</link>
141             </member>
142             <member>
143                 <link linkend="overloading">overloading</link>
144             </member>
145             <member>
146                 <link linkend="oldEmptyBehaviour">oldEmptyBehaviour</link>
147             </member>
148             <member>
149                 <link linkend="mtlb_a">mtlb_a</link>
150             </member>
151         </simplelist>
152     </refsection>
153     <refsection>
154         <title>Historique</title>
155         <revhistory>
156             <revision>
157                 <revnumber>6.0.0</revnumber>
158                 <revremark>
159                     <literal>A + []</literal> produit désormais <literal>[]</literal> au lieu de
160                     <literal>A</literal>
161                 </revremark>
162             </revision>
163         </revhistory>
164     </refsection>
165 </refentry>