[doc] update and fix some warnings
[scilab.git] / scilab / modules / compatibility_functions / help / fr_FR / mtlb_s.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) 2002-2004 - INRIA - Vincent COUVERT
5     *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14     *
15     -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="mtlb_s">
17     <refnamediv>
18         <refname>mtlb_s</refname>
19         <refpurpose>Fonction d'émulation de la soustraction Matlab</refpurpose>
20     </refnamediv>
21     <refsection>
22         <title>Description</title>
23         <para>Dans plusieurs cas particuliers, la soustraction se comporte différemment dans Matlab et dans Scilab :</para>
24         <itemizedlist>
25             <listitem>
26                 <para>
27                     Avec des opérandes de type chaîne de caractères : L'opérateur <literal>-</literal>
28                     ne peut pas être utilisé dans Scilab avec des chaînes de caractère, alors que
29                     Matlab réalise dans ce cas la soustraction des codes ASCII des opérandes.
30                 </para>
31             </listitem>
32             <listitem>
33                 <para>
34                     Avec une matrice vide : Dans Scilab, si une des
35                     opérandes est une matrice vide alors le résultat de la soustraction est
36                     l'autre opérande. Dans Matlab si une des opérandes est une matrice
37                     vide alors le résultat de la soustraction est soit une erreur (la seconde opérande n'est pas un scalaire)
38                     soit une matrice vide.
39                 </para>
40             </listitem>
41         </itemizedlist>
42         <para>
43             La fonction <literal>mtlb_s(A,B)</literal> est utilisée par
44             <literal>mfile2sci</literal> pour remplacer <literal>A-B</literal> quand il n'était pas
45             possible de savoir ce qu'étaient les opérandes pendant la conversion d'un code Matlab vers Scilab. Cette fonction va
46             déterminer la sémantique correcte pendant l'exécution. Pour obtenir un code plus performant
47             on peut remplacer les appels à <literal>mtlb_s</literal> :
48         </para>
49         <itemizedlist>
50             <listitem>
51                 <para>
52                     Si <literal>A</literal> et <literal>B</literal> sont des chaînes de caractères,
53                     <literal>mtlb_s(A,B)</literal> peut être remplacé par <literal>asciimat(A)-asciimat(B)</literal>
54                 </para>
55             </listitem>
56             <listitem>
57                 <para>
58                     Si <literal>A</literal> et <literal>B</literal> ne sont pas des matrices vides
59                     <literal>mtlb_s(A,B)</literal> peut être remplacé par <literal>A-B</literal>,
60                     sinon <literal>mtlb_s(A,B)</literal> peut être remplacé par
61                     <literal>[]</literal>.
62                 </para>
63             </listitem>
64         </itemizedlist>
65         <para>
66             <warning>
67                 Attention : <literal>mtlb_s</literal> ne doit pas être utilisée pour une programmation manuelle.
68             </warning>
69         </para>
70     </refsection>
71     <refsection role="see also">
72         <title>Voir aussi</title>
73         <simplelist type="inline">
74             <member>
75                 <link linkend="mtlb_a">mtlb_a</link>
76             </member>
77         </simplelist>
78     </refsection>
79 </refentry>