Xcos load: use a valid port type value
[scilab.git] / scilab / modules / core / help / pt_BR / 1_keywords / try.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
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:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="try" xml:lang="en">
3     <refnamediv>
4         <refname>try</refname>
5         <refpurpose>início de um bloco try numa instrução de controle try-catch
6             (significa "tentar...")
7         </refpurpose>
8     </refnamediv>
9     <refnamediv xml:id="catch">
10         <refname>catch</refname>
11         <refpurpose>início de um bloco catch numa instrução de controle try-catch
12             (significa "prender...") 
13         </refpurpose>
14     </refnamediv>
15     <refsynopsisdiv>
16         <title> Seqüência de Chamamento </title>
17         <synopsis>try
18             statements
19             catch
20             statements
21             end
22         </synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title> Descrição </title>
26         <para>A instrução de controle
27             <literal>try</literal>-<literal>catch</literal>pode ser usada para
28             gerenciar códigos que possivelmente poderiam gerar erros.
29         </para>
30         <para>Quando uma instrução de controle
31             <literal>try</literal>-<literal>catch</literal> é executada, normalmente
32             apenas as sentenças entre as palavras-chaves <literal>try</literal> e
33             <literal>catch</literal>são executadas. Contudo, se um erro ocorre durante
34             a execução de uma dessas sentenças, o erro é registrado, as sentenças
35             restantes até <literal>catch</literal>são puladas e as sentenças entre as
36             palavras-chaves <literal>catch</literal> e <literal>end</literal> são
37             executadas usando-se o modo de manipulação de erros padrão.
38         </para>
39         <para>
40             A mensagem de erro registrada pode ser recuperada pela função <link linkend="lasterror">lasterror</link> .
41         </para>
42         <para>
43             As sentenças <literal>catch</literal> , tanto quanto a palavra-chave
44             <literal>catch</literal> podem ser omitidas se nenhuma sentença
45             alternativa for fornecida.
46         </para>
47         <para>
48             Note que também é possível utilizar a função <link linkend="execstr">execstr</link> com o argumento<literal>
49                 'errcatch'
50             </literal>
51             para manipulação de erros. Isto pode ser
52             particularmente útil para manipulação de erros sintáticos.
53         </para>
54     </refsection>
55     <refsection>
56         <title>Exemplos</title>
57         <programlisting role="example"><![CDATA[ 
58
59 file_path=TMPDIR+'/wrong
60 try
61   u=mopen(file_path,'r')
62   x=mget(10,'c',u)
63 catch
64   disp(['o arquivo '+file_path+ ' não pode ser lido',
65         'usando valores padrões para x'])
66   x=1:10
67 end 
68 [error_message,error_number]=lasterror(%t)
69  ]]></programlisting>
70     </refsection>
71     <refsection>
72         <title> Ver Também </title>
73         <simplelist type="inline">
74             <member>
75                 <link linkend="error">error</link>
76             </member>
77             <member>
78                 <link linkend="execstr">execstr</link>
79             </member>
80             <member>
81                 <link linkend="if">if</link>
82             </member>
83             <member>
84                 <link linkend="lasterror">lasterror</link>
85             </member>
86         </simplelist>
87     </refsection>
88 </refentry>