update japanese translation of core module.
[scilab.git] / scilab / modules / core / help / ja_JP / error_handling / errcatch.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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="errcatch">
3     <refnamediv>
4         <refname>errcatch</refname>
5         <refpurpose>エラーの捕捉</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>呼出し手順</title>
9         <synopsis>errcatch(n [,'action'] [,'option'])
10             errcatch()
11         </synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>引数</title>
15         <variablelist>
16             <varlistentry>
17                 <term>n</term>
18                 <listitem>
19                     <para>整数</para>
20                 </listitem>
21             </varlistentry>
22             <varlistentry>
23                 <term>action, option</term>
24                 <listitem>
25                     <para>文字列</para>
26                 </listitem>
27             </varlistentry>
28         </variablelist>
29     </refsection>
30     <refsection>
31         <title>説明</title>
32         <para>
33           <function>errcatch</function> は,
34           <literal>n</literal>型のエラーが発生した時に
35           実行される "アクション" (エラーハンドラ)を指定します,
36         </para>
37         <para>
38           <varname>n</varname> は以下の意味を有します:
39         </para>
40         <para>
41           <varname>n</varname><literal>&gt;0</literal>の場合, <varname>n</varname> は
42           捕捉するエラー番号となります.
43         </para>
44         <para>
45           <varname>n</varname><literal>&lt;0</literal> の場合,全てのエラーが捕捉されます.
46         </para>
47         <para>
48           <varname>action</varname>は以下の文字列のどれかとなります:
49         </para>
50         <variablelist>
51             <varlistentry>
52                 <term>"pause"</term>
53                 <listitem>
54                     <para>
55                       誤差を捕捉した際に pause が実行されます.
56                       このオプションはデバッグの際に有用です.
57                       カレントのコンテキストで情報を取得するには
58                       <code>whereami()</code>を使用してください.
59                     </para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>"continue"</term>
64                 <listitem>
65                     <para>
66                       関数または実行ファイルないの次の命令が実行され,
67                       カレントの命令は無視されます.
68                       <link linkend="iserror">iserror</link>関数により,
69                       エラーが発生したかどうかを調べることが可能です.できるだけ早く
70                       <link linkend="errclear">errclear</link>関数によりエラーをクリアすることを
71                       忘れないようにしてください.
72                       このオプションはエラーからの回復の際に有用です.
73                       多くの場合,
74                       <link linkend="execstr">execstr</link> 関数または
75                       <link linkend="try">try</link>制御構造を使用することにより
76                       <literal>errcatch(n,"continue",..)</literal>を
77                       置換することができます.
78                     </para>
79                 </listitem>
80             </varlistentry>
81             <varlistentry>
82                 <term>"kill"</term>
83                 <listitem>
84                     <para>デフォルトのモードであり,全ての実行中の関数の実行が破棄され,
85                         Scilabの処理はレベル0プロンプトに戻ります.
86                     </para>
87                 </listitem>
88             </varlistentry>
89             <varlistentry>
90                 <term>"stop"</term>
91                 <listitem>
92                     <para>
93                         カレントのScilabセッションを中断します(Scilabが外部プログラムからコールされた時に有用).
94                     </para>
95                 </listitem>
96             </varlistentry>
97         </variablelist>
98         <para>
99           <varname>option</varname> は中断時のエラーメッセージである
100           文字列 <literal>'nomessage'</literal> です.
101         </para>
102         <para>
103           デフォルトモードに戻すためには,
104           <code>errcatch(-1,"kill")</code> または
105           <code>errcatch(-1)</code>と入力してください.
106           <code>errcatch()</code> は以前使用されていた<code>errcatch(-1)</code>と
107             等価です. 
108         </para>
109         <para/>
110         <para>
111           <function>errcatch</function>のアクションはカレントの評価コンテキスト
112           (function, exec, pause) およびサブレベル全体に適用されます.
113           あるサブレベル内で<function>errcatch</function>を2回コールすると
114           このサブレベルでの最初のコールが隠蔽され,
115           最初の関数コールの効果は削除されます.
116         </para>
117         <para> 
118           Scilab関数または exec のコンテキスト内でコールされた場合,
119           <function>errcatch</function>は,関数のリターンの時に自動的にリセットされます.
120         </para>
121     </refsection>
122     <refsection>
123         <title>例</title>
124         <programlisting role="example"><![CDATA[ 
125 errcatch(144,"continue")
126 2/"foo"
127 disp(a) // Without the errcatch, this line would not be executed
128
129 errcatch(-1,"kill") // Come back in the normal mode
130 errcatch(144,"pause")
131 2/"foo" // Enter in "pause" mode
132
133 errcatch(27,'continue','nomessage')
134 b=2/0 // No error message but b will not exist
135  ]]></programlisting>
136     </refsection>
137     <refsection role="see also">
138         <title>参照</title>
139         <simplelist type="inline">
140             <member>
141                 <link linkend="try">try</link>
142             </member>
143             <member>
144                 <link linkend="errclear">errclear</link>
145             </member>
146             <member>
147                 <link linkend="iserror">iserror</link>
148             </member>
149             <member>
150                 <link linkend="whereami">whereami</link>
151             </member>
152             <member>
153                 <link linkend="execstr">execstr</link>
154             </member>
155             <member>
156                 <link linkend="exec">exec</link>
157             </member>
158             <member>
159                 <link linkend="pause">pause</link>
160             </member>
161         </simplelist>
162     </refsection>
163 </refentry>