scanf/printf_conversion documentation corrected.
[scilab.git] / scilab / modules / output_stream / help / pt_BR / printf_conversion.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) XXXX-2008 - INRIA
5  *
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="printf_conversion" xml:lang="en">
14     <refnamediv>
15         <refname>printf_conversion</refname>
16         <refpurpose>Especificações de conversão de mprintf, msprintf,
17             mfprintf
18         </refpurpose>
19     </refnamediv>
20     <refsection>
21         <title>Descrição</title>
22         <para>Cada especificação de conversão no parâmetro format de
23             <literal>mprintf</literal> , <literal>msprintf</literal> ,
24             <literal>mfprintf</literal> possui a seguinte sintaxe:
25         </para>
26         <itemizedlist>
27             <listitem>
28                 <para>Um sinal % (porcento).</para>
29             </listitem>
30             <listitem>
31                 <para>
32                     Zero ou mais <literal>options</literal> (opções), que modificam
33                     o significado da especificação de conversão. A lista seguinte contem
34                     os caracteres <literal>option</literal> e seus significados:
35                 </para>
36             </listitem>
37             <listitem>
38                 <para>Alinhe à esquerda, dentro do campo, o resultado da
39                     conversão.
40                 </para>
41             </listitem>
42             <listitem>
43                 <para>Comece o resultado de uma conversão com sinal com um sinal (+ ou
44                     -).
45                 </para>
46             </listitem>
47             <listitem>
48                 <para>Prefixe um caractere de espaço ao resultado se o primeiro
49                     caractere de uma conversão com sinal não for um sinal. Se ambas as
50                     opções (espaço) e + aparecerem, a opção (space) é ignorada.
51                 </para>
52             </listitem>
53             <listitem>
54                 <para>Converta o valor para uma forma alternativa. Para as conversões
55                     <literal>c</literal>, <literal>d</literal>, <literal>i</literal>,
56                     <literal>s</literal>, e <literal>u</literal>, a opção
57                     <literal>#</literal> não possui efeito. Para a conversão
58                     <literal>o</literal>, <literal>#</literal> aumenta a precisão para
59                     forçar o primeiro dígito do resultado a ser 0 (zero). Para as
60                     conversões <literal>x</literal> e <literal>X</literal>, um valor
61                     não-nulo possui 0x ou 0X prefixado a ele. Para as conversões
62                     <literal>e, E, f, g,</literal> e <literal>G</literal>, o resultado
63                     sempre contém ponto decimal, Mesmo que nenhum dígito o siga. Para as
64                     conversões <literal>g</literal> e <literal>G</literal>, zeros por
65                     último não são removidos.
66                 </para>
67             </listitem>
68             <listitem>
69                 <para>Aumente a largura do campo utilizando zeros à esquerda (seguindo
70                     qualquer indicação de sinal ou base) para as conversões
71                     <literal>d</literal>, <literal>i</literal>, <literal>o</literal>,
72                     <literal>u</literal>, <literal>x</literal>, <literal>X</literal>,
73                     <literal>e</literal>, <literal>E</literal>, <literal>f</literal>,
74                     <literal>g</literal>, e <literal>G</literal>; nenhum aumento de espaço
75                     é realizado. Se ambos os indicadores <literal>0</literal> e
76                     <literal>\-</literal> (barra) aparecerem, o indicador
77                     <literal>0</literal> é ignorado. Para as conversões
78                     <literal>d</literal>, <literal>i</literal>, <literal>o</literal>
79                     <literal>u</literal>, <literal>x</literal>, e <literal>X</literal>, se
80                     uma precisão for especificada, o indicador <literal>0</literal> também
81                     é ignorado.
82                 </para>
83             </listitem>
84             <listitem>
85                 <para>Um string de dígitos decimais opcional que especifica a largura
86                     mínima do campo. Se o valor convertido tiver menos caracteres que a
87                     largura do campo, o campo é aumentado à esquerda até o comprimento
88                     especificado pela largura do campo. Se a opção de ajuste à esquerda for
89                     especificada, o campo é aumentado pela direita.
90                 </para>
91             </listitem>
92             <listitem>
93                 <para>
94                     Uma precisão opcional. A precisão é um ponto <literal>.</literal>
95                     seguido por um string de dígito decimal. Se nenhuma precisão for
96                     fornecida, o parâmetro é tratado como 0 (zero). A precisão
97                     especifica:
98                 </para>
99                 <itemizedlist>
100                     <listitem>
101                         <para>O número mínimo de dígitos a aparecerem nas conversões
102                             <literal>d</literal>, <literal>u</literal>, <literal>o</literal>,
103                             <literal>x</literal>, ou <literal>X</literal>
104                         </para>
105                     </listitem>
106                     <listitem>
107                         <para>O número de dígitos a aparecerem após o ponto decimal nas
108                             conversões <literal>e</literal>, <literal>E</literal>, e
109                             <literal>f</literal>
110                         </para>
111                     </listitem>
112                     <listitem>
113                         <para>O número máximo de dígitos significativos para as conversões
114                             <literal>g</literal> e <literal>G</literal>
115                         </para>
116                     </listitem>
117                     <listitem>
118                         <para>O número máximo de caracteres a serem impressos a partir de um
119                             string em uma convesão <literal>s</literal>
120                         </para>
121                     </listitem>
122                 </itemizedlist>
123             </listitem>
124             <listitem>
125                 <para>O caractere que indica o tipo de conversão a ser
126                     aplicada:
127                 </para>
128             </listitem>
129             <listitem>
130                 <para>Não realiza conversão. Exibe %.</para>
131             </listitem>
132             <listitem>
133                 <para>Aceita um valor inteiro e o converte para notação decimal com
134                     sinal. A precisão especifica o número mínimo de dígitos a aparecer. Se
135                     o valor sendo convertido puder ser representado em menos dígitos, ele
136                     é expandido com zeros à esquerda. A precisão padrão é 1. O resultado
137                     de se converter um valor zero com uma precisão de zero é um string
138                     nulo. A especificação de uma largura de campo com zero como caractere
139                     mais à esquerda faz com que o valor da largura do campo seja
140                     preenchido com zeros à esquerda.
141                 </para>
142             </listitem>
143             <listitem>
144                 <para>Aceita um valor inteiro e o converte para a notação decimal sem
145                     sinal. A precisão especifica o número mínimo de dígitos a aparecer. Se
146                     o valor sendo convertido puder ser representado em menos dígitos, ele
147                     é expandido com zeros à esquerda. A precisão padrão é 1. O resultado
148                     de se converter um valor zero com uma precisão de zero é um string
149                     nulo. A especificação de uma largura de campo com zero como caractere
150                     mais à esquerda faz com que o valor da largura do campo seja
151                     preenchido com zeros à esquerda.
152                 </para>
153             </listitem>
154             <listitem>
155                 <para>Aceita um valor inteiro e o converte para a sua notação octal
156                     sem sinal. A precisão especifica o número mínimo de dígitos a
157                     aparecer. Se o valor sendo convertido puder ser representado em menos
158                     dígitos, ele é expandido com zeros à esquerda. A precisão padrão é 1.
159                     O resultado de se converter um valor zero com uma precisão de zero é
160                     um string nulo. A especificação de uma largura de campo com zero como
161                     caractere mais à esquerda faz com que o valor da largura do campo seja
162                     preenchido com zeros à esquerda. Não é implicado um valor octal para a
163                     largura do campo.
164                 </para>
165             </listitem>
166             <listitem>
167                 <para>Aceita um valor inteiro e o converte para a sua notação
168                     hexadecimal sem sinal. As letras ``abcdef'' são utilizadas para a
169                     conversão <literal>x</literal>; as letras ``ABCDEF'' são utilizadas
170                     para a conversão <literal>X</literal>. A precisão especifica o número
171                     mínimo de dígitos a aparecer. Se o valor sendo convertido puder ser
172                     representado em menos dígitos, ele é expandido com zeros à esquerda. A
173                     precisão padrão é 1. O resultado de se converter um valor zero com uma
174                     precisão de zero é um string nulo. A especificação de uma largura de
175                     campo com zero como caractere mais à esquerda faz com que o valor da
176                     largura do campo seja preenchido com zeros à esquerda.
177                 </para>
178             </listitem>
179             <listitem>
180                 <para>Aceita um valor float ou double e o converte para a sua notação
181                     decimal no formato %[\-]<literal>ddd.ddd</literal>. O número de
182                     dígitos após o ponto decimal é igual à especificação de
183                     precisão.
184                 </para>
185             </listitem>
186             <listitem>
187                 <para>Se nenhuma precisão for especificada, a saída possui seis
188                     dígitos
189                 </para>
190             </listitem>
191             <listitem>
192                 <para>Se a precisão for zero, nenhum ponto decimal aparece e o sistema
193                     imprime na saída o valor inteiro mais próximo de
194                     <literal>value</literal>.
195                 </para>
196             </listitem>
197             <listitem>
198                 <para>Se a saída possui um ponto decimal, pelo menos um dígito é posto
199                     antes dele.
200                 </para>
201             </listitem>
202             <listitem>
203                 <para>Aceita um real e o converte para a sua forma exponencial
204                     %[\-]<literal>d.ddde</literal>+/\-<literal>dd</literal>. Há um dígito
205                     antes do ponto decimal, e o número de dígitos após o ponto decimal é
206                     igual à especificação de precisão.
207                 </para>
208             </listitem>
209             <listitem>
210                 <para>Se nenhuma precisão for especificada, a saída são seis
211                     dígitos
212                 </para>
213             </listitem>
214             <listitem>
215                 <para>Se a precisão for zero, nenhum ponto decimal aparece.</para>
216             </listitem>
217             <listitem>
218                 <para>
219                     A caractere de conversão <literal>E</literal> produz um número
220                     com o caractere 'E', ao invés de 'e' antes do expoente. O expoente
221                     sempre contém pelo menos dois dígitos. Se o valor for zero, o expoente
222                     é zero.
223                 </para>
224             </listitem>
225             <listitem>
226                 <para>Aceita um real e o converte no estilo dos caracteres de
227                     conversão <literal>e</literal>, <literal>E</literal>, ou
228                     <literal>f</literal>, com a precisão especificando o número de dígitos
229                     significativos. Zeros por último são removidos. Um ponto decimal
230                     aparece apenas se for seguido de um dígito. O estilo depende do valor
231                     convertido. O resultado é o estilo <literal>e</literal>
232                     (<literal>E</literal>, se <literal>G</literal> é o indicador
233                     utilizado) apenas se o expoente resultante da conversão for menor do
234                     que -4, ou se for maior do que ou igual à precisão.
235                 </para>
236             </listitem>
237             <listitem>
238                 <para>Aceita e exibe um valor inteiro convertido em um
239                     caractere.
240                 </para>
241             </listitem>
242             <listitem>
243                 <para>Aceita um valor string e exibe caracteres do string até o fim
244                     ou até que o número de caracteres indicados pela precisão seja
245                     alcançado. Se nenhuma precisão for especificada, todos os caracteres
246                     até o fim são exibidos.
247                 </para>
248             </listitem>
249         </itemizedlist>
250         <para>Uma largura de campo ou uma precisão podem ser indicadas por
251             <literal>*</literal> (asterísco) ao invés de um string de dígito. Neste
252             caso, um parâmetro de valor inteiro provê a largura do campo ou a
253             precisão. O parâmetro de valor convertido para saída não é buscado até que
254             a letra de conversão seja alcançada, então os parâmetros especificando o
255             comprimento de campo ou precisão devem aparecer antes do valor a ser
256             convertido (se houver algum).
257         </para>
258         <para>Se o resultado da conversão for maior que a largura do campo, o
259             campo é expandido para conter o resultado convertido.
260         </para>
261         <para>A representação do sinal de mais depende da opção de formatação
262             especificada, se <literal>+</literal> ou (espaço).
263         </para>
264     </refsection>
265     <refsection role="see also">
266         <title>Ver Também</title>
267         <simplelist type="inline">
268             <member>
269                 <link linkend="mprintf">mprintf</link>
270             </member>
271             <member>
272                 <link linkend="mfprintf">mfprintf</link>
273             </member>
274             <member>
275                 <link linkend="msprintf">msprintf</link>
276             </member>
277         </simplelist>
278     </refsection>
279 </refentry>