69ba987b2f4eb84ae0191c34c732bf9a73be2db8
[scilab.git] / scilab / modules / m2sci / help / fr_FR / m2scideclare.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="m2scideclare">
17     <refnamediv>
18         <refname>m2scideclare</refname>
19         <refpurpose>Donner des indices pour aider M2SCI...</refpurpose>
20     </refnamediv>
21     <refsection>
22         <title>Description</title>
23         <para>
24             La principale difficulté de M2SCI (<literal>mfile2sci</literal>) est de trouver
25             ce que sont les variables : dimensions, type...
26         </para>
27         <para>
28             Pour aider cet outil, il suffit d'ajouter des commentaires commencant par
29             <literal>%m2scideclare</literal> dans le fichier Matlab à convertir,
30             (<literal>%m2sciassume</literal> était utilisée dans les versions précédentes
31             de Scilab mais est maintenant obsolète).
32         </para>
33         <para>
34             La syntaxe de cette commande est :
35         </para>
36         <para>
37             <literal>%m2scideclare nom_de_variable|dimensions|type_de_données|propriété</literal>
38         </para>
39         <para>
40             avec :
41         </para>
42         <itemizedlist>
43             <listitem>
44                 <itemizedlist>
45                     <listitem>
46                         <para>
47                             nom_de_variable : nom de la variable déclarée. Ce nom peut être
48                             un champ de Struct (e.g. <literal>x(1,2).nom</literal>)
49                             ou décrire le contenu d'une Cell en utilisant la syntaxe
50                             <literal>x(1,2).entries</literal>. NOTEZ que pour les Cells et les
51                             Structs <literal>*</literal> peut être utilisé comme index.
52                         </para>
53                     </listitem>
54                     <listitem>
55                         <para>
56                             dimensions : dimensions de la variable déclarée séparées par des espaces,
57                             si une dimension est inconnue, remplacez la par <literal>?</literal>. NOTEZ que
58                             les dimensions des chaînes de caractère doivent être identiques aux dimensions
59                             Matlab e.g. <literal>1 6</literal> pour la chaîne de caractères 'chaine'.
60                         </para>
61                     </listitem>
62                     <listitem>
63                         <para>
64                             type_de_données: le type de donnée de la variable qui peut être :
65                         </para>
66                         <informaltable border="1">
67                             <tr>
68                                 <td>Type de donnée m2scideclare</td>
69                                 <td>Type Scilab "équivalent"</td>
70                             </tr>
71                             <tr>
72                                 <td>Double</td>
73                                 <td>1</td>
74                             </tr>
75                             <tr>
76                                 <td>Boolean</td>
77                                 <td>4</td>
78                             </tr>
79                             <tr>
80                                 <td>Sparse</td>
81                                 <td>5</td>
82                             </tr>
83                             <tr>
84                                 <td>Int</td>
85                                 <td>8</td>
86                             </tr>
87                             <tr>
88                                 <td>Handle</td>
89                                 <td>9</td>
90                             </tr>
91                             <tr>
92                                 <td>String</td>
93                                 <td>10</td>
94                             </tr>
95                             <tr>
96                                 <td>Struct</td>
97                                 <td>Struct Matlab (16)</td>
98                             </tr>
99                             <tr>
100                                 <td>Cell</td>
101                                 <td>Cell Matlab (17)</td>
102                             </tr>
103                             <tr>
104                                 <td>Void</td>
105                                 <td>Sans type (0)</td>
106                             </tr>
107                             <tr>
108                                 <td>?</td>
109                                 <td>Type inconnu</td>
110                             </tr>
111                         </informaltable>
112                     </listitem>
113                     <listitem>
114                         <para>
115                             propriété : propriété de la variable qui peut être :
116                         </para>
117                         <informaltable border="1">
118                             <tr>
119                                 <td>Propriété m2scideclare</td>
120                                 <td>"Equivalent" Scilab</td>
121                             </tr>
122                             <tr>
123                                 <td>Real</td>
124                                 <td>Donnée réelle</td>
125                             </tr>
126                             <tr>
127                                 <td>Complex</td>
128                                 <td>Donnée complexe</td>
129                             </tr>
130                             <tr>
131                                 <td>?</td>
132                                 <td>Property inconnue</td>
133                             </tr>
134                         </informaltable>
135                         <para>
136                             Ce champ est ignoré pour les types de données suivants : <literal>Cell</literal>,
137                             <literal>Struct</literal>, <literal>String</literal> et <literal>Boolean</literal>.
138                         </para>
139                     </listitem>
140                 </itemizedlist>
141             </listitem>
142         </itemizedlist>
143         <para>
144             Toutes les informations données par <literal>m2scideclare</literal> sont comparées avec
145             les données inférées, en cas de conflit, les données inférées sont conservées et
146             un warning est affiché. Si vous êtes sûrs de vos informations, rapportez ce bug.
147         </para>
148         <para>Voici quelques exemples :</para>
149         <itemizedlist>
150             <listitem>
151                 <itemizedlist>
152                     <listitem>
153                         <para>
154                             <literal>%m2scideclare var1|2 3|Double|Real</literal>var1 est déclarée comme une matrice de Doubles de taille 2x3
155                             et contenant des données réelles
156                         </para>
157                     </listitem>
158                     <listitem>
159                         <para>
160                             <literal>%m2scideclare var2|2 3 10|Double|Complex</literal>var2 est déclarée comme une hypermatrice de Doubles de taille 2x3x10
161                             et contenant des données complexes
162                         </para>
163                     </listitem>
164                     <listitem>
165                         <para>
166                             <literal>%m2scideclare var3(1,2).name|1 10|String|?</literal>var3 est déclarée comme un tableau de Structs contenant une chaîne de
167                             caractères de taille 1x10 dans le champ 'name' de la Struct à l'indice (1,2)
168                         </para>
169                     </listitem>
170                     <listitem>
171                         <para>
172                             <literal>%m2scideclare var4(1,5).entries|1 ?|Boolean|?</literal>var4 est déclarée comme un tableau de Cells contenant
173                             un vecteur ligne de booléens à l'indice (1,5)
174                         </para>
175                     </listitem>
176                     <listitem>
177                         <para>
178                             <literal>%m2scideclare var4(1,6).entries|? ?|Int|?</literal>var4 est déclarée comme un tableau de Cells contenant
179                             un vecteur ligne de booléens à l'indice (1,5)
180                             et des données entières à l'indice (1,6)
181                         </para>
182                     </listitem>
183                     <listitem>
184                         <para>
185                             <literal>%m2scideclare var5(*,*).name|1 ?|String|?</literal>var5 est déclarée comme un tableau de Structs contenant une
186                             chaîne de caractères de taille 1xn dans chaque champ 'name'
187                         </para>
188                     </listitem>
189                     <listitem>
190                         <para>
191                             <literal>%m2scideclare var6(2,*).entries|1 3|Double|Real</literal>var6 est déclarée comme un tableau de Cells contenant un
192                             veteur de Doubles de taille 1x3 dans chaque élement de sa
193                             seconde ligne.
194                         </para>
195                     </listitem>
196                 </itemizedlist>
197             </listitem>
198         </itemizedlist>
199     </refsection>
200 </refentry>