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