Skip to content

Commit 0bd19d9

Browse files
lacatoirelacatoire
authored
[Sync EN] scanf: amend the CS of the fscanf and sscanf code examples (#784)
Refs: php/doc-en@9947012
1 parent 14c5e52 commit 0bd19d9

3 files changed

Lines changed: 155 additions & 157 deletions

File tree

‎reference/filesystem/functions/fscanf.xml‎

Lines changed: 52 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4225e50bc391ddba99e367c231463da0dc04357d Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,diogo,leonardolara -->
2+
<!-- EN-Revision: 9947012f745f0fb6e083bce5a8c920213ff468b7 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,diogo,leonardolara -->
33
<refentry xml:id="function.fscanf" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>fscanf</refname>
@@ -14,66 +14,68 @@
1414
<methodparam><type>string</type><parameter>format</parameter></methodparam>
1515
<methodparam rep="repeat"><type>mixed</type><parameter role="reference">vars</parameter></methodparam>
1616
</methodsynopsis>
17-
<para>
17+
<simpara>
1818
A função <function>fscanf</function> é semelhante à
1919
<function>sscanf</function>, mas usa como entrada um arquivo
2020
associado com o fluxo <parameter>stream</parameter> e interpreta a
2121
entrada de acordo com o especificado em <parameter>format</parameter>.
22-
</para>
23-
<para>
22+
</simpara>
23+
<simpara>
2424
Qualquer espaço em branco na string do formato corresponde a quaisquer espaços em branco
2525
no fluxo de entrada. Isto significa que até mesmo uma tabulação (<literal>\t</literal>) na
2626
string do formato pode corresponder a um único caractere de espaço no fluxo de entrada.
27-
</para>
28-
<para>
27+
</simpara>
28+
<simpara>
2929
Cada chamada a <function>fscanf</function> lê uma linha do arquivo.
30-
</para>
30+
</simpara>
3131
</refsect1>
3232

3333
<refsect1 role="parameters">
3434
&reftitle.parameters;
35-
<para>
36-
<variablelist>
37-
<varlistentry>
38-
<term><parameter>stream</parameter></term>
39-
<listitem>
40-
&fs.file.pointer;
41-
</listitem>
42-
</varlistentry>
43-
&strings.scanf.parameter.format;
44-
<varlistentry>
45-
<term><parameter>vars</parameter></term>
46-
<listitem>
47-
<para>
48-
Os valores opcionais atribuídos.
49-
</para>
50-
</listitem>
51-
</varlistentry>
52-
</variablelist>
53-
</para>
35+
<variablelist>
36+
<varlistentry>
37+
<term><parameter>stream</parameter></term>
38+
<listitem>
39+
&fs.file.pointer;
40+
</listitem>
41+
</varlistentry>
42+
&strings.scanf.parameter.format;
43+
<varlistentry>
44+
<term><parameter>vars</parameter></term>
45+
<listitem>
46+
<simpara>
47+
Os valores opcionais atribuídos.
48+
</simpara>
49+
</listitem>
50+
</varlistentry>
51+
</variablelist>
5452
</refsect1>
5553

5654
<refsect1 role="returnvalues">
5755
&reftitle.returnvalues;
58-
<para>
56+
<simpara>
5957
Se somente dois parâmetros forem passados a esta função, os valores interpretados
60-
serão retornados como um array. Do contrário, se parâmetros opcionais forem passados,
58+
serão retornados como um <type>array</type>. Do contrário, se parâmetros opcionais forem passados,
6159
a função retornará o número de valores atribuídos. Os parâmetros opcionais
6260
devem ser passados por referência.
63-
</para>
64-
<para>
61+
</simpara>
62+
<simpara>
6563
Se houver mais substrings esperadas no parâmetro <parameter>format</parameter>
6664
do que estiverem disponíveis na <parameter>string</parameter>,
6765
&null; será retornado. Para outros erros, &false; será retornado.
68-
</para>
66+
</simpara>
67+
<simpara>
68+
Quando parâmetros opcionais são usados e o fim da entrada lida de
69+
<parameter>stream</parameter> é alcançado antes que qualquer valor tenha sido
70+
interpretado, <literal>-1</literal> é retornado.
71+
</simpara>
6972
</refsect1>
7073

7174
<refsect1 role="examples">
7275
&reftitle.examples;
73-
<para>
74-
<example>
75-
<title>Exemplo de <function>fscanf</function></title>
76-
<programlisting role="php">
76+
<example>
77+
<title>Exemplo de <function>fscanf</function></title>
78+
<programlisting role="php">
7779
<![CDATA[
7880
<?php
7981
$handle = fopen("users.txt", "r");
@@ -84,36 +86,31 @@ while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) {
8486
fclose($handle);
8587
?>
8688
]]>
87-
</programlisting>
88-
</example>
89-
</para>
90-
<para>
91-
<example>
92-
<title>Conteúdo de users.txt</title>
93-
<programlisting role="txt">
89+
</programlisting>
90+
</example>
91+
<example>
92+
<title>Conteúdo de users.txt</title>
93+
<programlisting role="txt">
9494
<![CDATA[
9595
javier argonaut pe
9696
hiroshi sculptor jp
9797
robert slacker us
9898
luigi florist it
9999
]]>
100-
</programlisting>
101-
</example>
102-
</para>
100+
</programlisting>
101+
</example>
103102
</refsect1>
104103

105104
<refsect1 role="seealso">
106105
&reftitle.seealso;
107-
<para>
108-
<simplelist>
109-
<member><function>fread</function></member>
110-
<member><function>fgets</function></member>
111-
<member><function>fgetss</function></member>
112-
<member><function>sscanf</function></member>
113-
<member><function>printf</function></member>
114-
<member><function>sprintf</function></member>
115-
</simplelist>
116-
</para>
106+
<simplelist>
107+
<member><function>fread</function></member>
108+
<member><function>fgets</function></member>
109+
<member><function>fgetss</function></member>
110+
<member><function>sscanf</function></member>
111+
<member><function>printf</function></member>
112+
<member><function>sprintf</function></member>
113+
</simplelist>
117114
</refsect1>
118115

119116
</refentry>

‎reference/spl/splfileobject/fscanf.xml‎

Lines changed: 46 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: 9947012f745f0fb6e083bce5a8c920213ff468b7 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
33
<refentry xml:id="splfileobject.fscanf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>SplFileObject::fscanf</refname>
@@ -13,81 +13,85 @@
1313
<methodparam><type>string</type><parameter>format</parameter></methodparam>
1414
<methodparam rep="repeat"><type>mixed</type><parameter role="reference">vars</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Lê uma linha do arquivo e a interpreta de acordo com o <parameter>format</parameter> especificado.
18-
</para>
19-
<para>
18+
</simpara>
19+
<simpara>
2020
Qualquer espaço em branco na string <parameter>format</parameter> corresponde a qualquer espaço em branco na linha do arquivo.
2121
Isso significa que até mesmo um tab (<literal>\t</literal>) na string de formato pode corresponder a um único caractere de espaço na sequência de entrada.
22-
</para>
22+
</simpara>
2323
</refsect1>
2424

2525
<refsect1 role="parameters">
2626
&reftitle.parameters;
27-
<para>
28-
<variablelist>
29-
&strings.scanf.parameter.format;
30-
<varlistentry>
31-
<term><parameter>vars</parameter></term>
32-
<listitem>
33-
<para>
34-
Os valores atribuídos opcionais.
35-
</para>
36-
</listitem>
37-
</varlistentry>
38-
</variablelist>
39-
</para>
27+
<variablelist>
28+
&strings.scanf.parameter.format;
29+
<varlistentry>
30+
<term><parameter>vars</parameter></term>
31+
<listitem>
32+
<simpara>
33+
Os valores atribuídos opcionais.
34+
</simpara>
35+
</listitem>
36+
</varlistentry>
37+
</variablelist>
4038
</refsect1>
4139

4240
<refsect1 role="returnvalues">
4341
&reftitle.returnvalues;
44-
<para>
42+
<simpara>
4543
Se apenas um parâmetro for passado para este método, os valores analisados serão
46-
retornados como uma array. Caso contrário, se parâmetros opcionais forem passados, a
47-
função retornará o número de valores atribuídos. Os parâmetros opcionais
44+
retornados como uma <type>array</type>. Caso contrário, se parâmetros opcionais forem passados, o
45+
método retornará o número de valores atribuídos. Os parâmetros opcionais
4846
devem ser passados por referência.
49-
</para>
47+
</simpara>
48+
<simpara>
49+
Se houver mais substrings esperadas em <parameter>format</parameter>
50+
do que estiverem disponíveis na linha lida do arquivo,
51+
&null; será retornado.
52+
</simpara>
53+
<simpara>
54+
Quando parâmetros opcionais são usados e o fim da linha lida do
55+
arquivo é alcançado antes que qualquer valor tenha sido interpretado,
56+
<literal>-1</literal> é retornado.
57+
</simpara>
5058
</refsect1>
5159

5260
<refsect1 role="examples">
5361
&reftitle.examples;
54-
<para>
55-
<example>
56-
<title>Exemplo de <methodname>SplFileObject::fscanf</methodname></title>
57-
<programlisting role="php">
62+
<example>
63+
<title>Exemplo de <methodname>SplFileObject::fscanf</methodname></title>
64+
<programlisting role="php">
5865
<![CDATA[
5966
<?php
6067
$file = new SplFileObject("misc.txt");
6168
while ($userinfo = $file->fscanf("%s %s %s")) {
62-
list ($name, $profession, $countrycode) = $userinfo;
63-
// Faça algo com $name $profession $countrycode
69+
list ($name, $profession, $countrycode) = $userinfo;
70+
// Faça algo com $name $profession $countrycode
6471
}
6572
?>
6673
]]>
67-
</programlisting>
68-
<para>Conteúdo de users.txt</para>
69-
<programlisting role="txt">
74+
</programlisting>
75+
<simpara>Conteúdo de users.txt</simpara>
76+
<programlisting role="txt">
7077
<![CDATA[
7178
javier argonaut pe
7279
hiroshi sculptor jp
7380
robert slacker us
7481
luigi florist it
7582
]]>
76-
</programlisting>
77-
</example>
78-
</para>
83+
</programlisting>
84+
</example>
7985
</refsect1>
8086

8187
<refsect1 role="seealso">
8288
&reftitle.seealso;
83-
<para>
84-
<simplelist>
85-
<member><function>fscanf</function></member>
86-
<member><function>sscanf</function></member>
87-
<member><function>printf</function></member>
88-
<member><function>sprintf</function></member>
89-
</simplelist>
90-
</para>
89+
<simplelist>
90+
<member><function>fscanf</function></member>
91+
<member><function>sscanf</function></member>
92+
<member><function>printf</function></member>
93+
<member><function>sprintf</function></member>
94+
</simplelist>
9195
</refsect1>
9296

9397
</refentry>

0 commit comments

Comments
 (0)