1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
<?xml version="1.0" encoding="UTF-8"?>
<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" version="5.0-subset Scilab" xml:lang="fr" xml:id="errcatch">
<info>
<pubdate>$LastChangedDate$</pubdate>
</info>
<refnamediv>
<refname>errcatch</refname>
<refpurpose> interception d'erreur </refpurpose>
</refnamediv>
<refsynopsisdiv>
<title>Séquence d'appel</title>
<synopsis>errcatch(n [,'action'] [,'option'])
errcatch()</synopsis>
</refsynopsisdiv>
<refsection>
<title>Paramètres</title>
<variablelist>
<varlistentry>
<term>n </term>
<listitem>
<para>entier
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>action, option </term>
<listitem>
<para>chaînes de caractères
</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection>
<title>Description</title>
<para><literal>errcatch</literal> définit une action à effectuer quand une erreur de
numéro <literal>n</literal> est rencontrée. <literal>n</literal> a la signification
suivante:
</para>
<para>
si <literal>n>0</literal>, <literal>n</literal> est le numéro de l'erreur à
intercepter
</para>
<para>
si <literal>n<0</literal>, toutes les erreurs sont à intercepter
</para>
<para><literal>action</literal> est une des chaînes de caractères suivantes :
</para>
<variablelist>
<varlistentry>
<term>"pause"</term>
<listitem>
<para>l'interception de l'erreur conduit à une pause. Cette
option est utile en phase de mise au point. On peut utiliser
<literal>whereami()</literal> pour obtenir des informations sur le contexte
courant.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>"continue"</term>
<listitem>
<para>l'exécution de la fonction ou du script continue,
l'instruction courante est tout simplement ignorée. Il est
possible de vérifier si une erreur s'est produite avec la
fonction <literal>iserror</literal>. Ne pas oublier d'effacer
l'erreur avec la fonction <literal>errclear</literal> le plus tôt
possible. Cette option est utile pour remédier aux erreurs. Dans la
plupart des cas, l'usage de <literal>
errcatch(n,"continue",..)</literal> peut être remplacé par
l'usage de la fonction <literal>execstr</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>"kill"</term>
<listitem>
<para>mode par défaut, tous les niveaux intermédiaires sont abandonnés,
et Scilab revient à l'invite de commande de niveau 0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>"stop"</term>
<listitem>
<para>interrompt la session Scilab courante (très utile quand Scilab est
exécuté à partir d'un programme externe).
</para>
</listitem>
</varlistentry>
</variablelist>
<para><literal>option</literal> est la chaîne de caractères
<literal>'nomessage'</literal> pour supprimer les messages
d'erreurs.
</para>
<para>
Pour revenir au mode par défaut, taper
<literal>errcatch(-1,"kill")</literal> ou bien
<literal>errcatch(-1)</literal>.
</para>
<para>
Lorsque <literal>errcatch</literal> est appelée à l'intérieur d'une
fonction, le mode d'interception d'erreur est automatiquement
réinitialisé au mode par défaut lorsque l'on sort de la fonction.
</para>
<para><literal>errcatch()</literal> est un equivalent obsolete de <literal>errcatch(-1)</literal>.</para>
</refsection>
<refsection>
<title>REMARQUES</title>
<para><literal>errcatch</literal> est obsolete.
Il est préférable d'utiliser <link linkend="try">try</link> ou <literal>execstr(...,'errcatch')</literal> à
la place de <literal>errcatch</literal> lorsque c'est possible.
</para>
</refsection>
<refsection>
<title>Voir Aussi</title>
<simplelist type="inline">
<member>
<link linkend="errclear">errclear</link>
</member>
<member>
<link linkend="iserror">iserror</link>
</member>
<member>
<link linkend="whereami">whereami</link>
</member>
<member>
<link linkend="execstr">execstr</link>
</member>
</simplelist>
</refsection>
</refentry>
|
