sync with en rev

This commit is contained in:
Leonardo Lara Rodrigues
2025-11-28 09:42:35 -03:00
parent f2e884dc2c
commit dba30ac2db
6 changed files with 239 additions and 235 deletions

View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c999c7066ede7dc2df80e0bd3364bfa0ef1f9533 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2f1812217524ac60414745bad05cbbee00262b3b Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<sect1 xml:id="language.operators.functional">
<title>Operadores Funcionais</title>
<titleabbrev>Funcional</titleabbrev>
@@ -48,7 +48,7 @@ $result = "PHP Rocks"
|> (fn($x) => array_map(strtoupper(...), $x))
|> (fn($x) => array_filter($x, fn($v) => $v != 'O'))
;
echo $result, PHP_EOL;
print_r($result);
$temp = "PHP Rocks";
$temp = htmlentities($temp);
@@ -56,7 +56,7 @@ $temp = str_split($temp);
$temp = array_map(strtoupper(...), $temp);
$temp = array_filter($temp, fn($v) => $v != 'O');
$result = $temp;
echo $result, PHP_EOL;
print_r($result);
?>
]]>
</programlisting>

View File

@@ -1,6 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: leonardolara Status: ready -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 5c7e9e1351240b5f9e0858cdeba8f754a366d1b7 Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.closedir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>closedir</refname>
@@ -13,61 +11,84 @@
<type>void</type><methodname>closedir</methodname>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Fecha o fluxo de diretório indicado por
<parameter>dir_handle</parameter>. O fluxo deve ter sido previamente
aberto por <function>opendir</function>.
</para>
<parameter>dir_handle</parameter>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
O manipulador de diretório do tipo <type>resource</type> aberto previamente
com <function>opendir</function>. Se o manipulador de diretório não
for especificado, o último manipulador aberto por <function>opendir</function>
será o assumido.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<simpara>
O manipulador de diretório do tipo <type>resource</type> aberto previamente
com <function>opendir</function>.
Se <parameter>dir_handle</parameter> for &null;, o último manipulador aberto
por <function>opendir</function> será usado.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Usar &null; para <parameter>dir_handle</parameter> foi descontinuado.
Em vez disso, o manipulador do último diretório aberto deve ser fornecido explicitamente.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>dir_handle</parameter> agora pode ser nulo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemplo da <function>closedir</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dir = "/etc/php5/";
<simpara>
Para um exemplo completo, consulte a documentação de
<function>opendir</function>.
</simpara>
</refsect1>
// Abre um diretório conhecido, lê na variável e depois fecha
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
$directory = readdir($dh);
closedir($dh);
}
}
?>
]]>
</programlisting>
</example>
</para>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>opendir</function></member>
<member><function>readdir</function></member>
<member><function>rewinddir</function></member>
<member><function>dir</function></member>
<member><function>is_dir</function></member>
<member><function>glob</function></member>
<member><function>scandir</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: ae Status: ready --><!-- CREDITS: rarruda, thiago -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 5c7e9e1351240b5f9e0858cdeba8f754a366d1b7 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda, thiago, leonardolara -->
<refentry xml:id="function.opendir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>opendir</refname>
@@ -14,55 +12,53 @@
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Abre um manipulador de diretório para ser usado em chamadas subsequentes de
<function>closedir</function>, <function>readdir</function> e
<function>rewinddir</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>directory</parameter></term>
<listitem>
<para>
O caminho do diretório a ser aberto
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<para>
Para descrição do parâmetro <parameter>context</parameter>,
consulte <link linkend="ref.stream">a seção sobre fluxos</link> do
manual.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>directory</parameter></term>
<listitem>
<simpara>
O caminho do diretório a ser aberto.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<simpara>
Para descrição do parâmetro <parameter>context</parameter>,
consulte <link linkend="ref.stream">a seção sobre fluxos</link> do
manual.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna um manipulador de diretório do tipo <type>resource</type> em caso de sucesso,
<simpara>
Retorna um manipulador de diretório em caso de sucesso,
&return.falseforfailure;
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
<para>
<simpara>
Isto pode ocorrer se <parameter>directory</parameter> não for um nome de diretório válido,
o diretório não puder ser aberto por restrições de permissão,
ou por erros no sistema de arquivos.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -89,49 +85,65 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemplo de <function>opendir</function></title>
<programlisting role="php">
<example>
<title>
Lista todas as entradas de um diretório, pulando os especiais <literal>.</literal>
e <literal>..</literal>
</title>
<simpara>
Como os nomes de diretório e arquivo podem ser strings interpretadas como "falso" pelo PHP
(por exemplo um diretório com nome <literal>"0"</literal>) e
<function>readdir</function> retorna &false; quando tiver lido todas as entradas
em um diretório, deve-se usar o <link linkend="language.operators.comparison">operador de comparação</link>
<literal>===</literal>
para distinguir adequadamente entre uma entrada de diretório cujo nome seja interpretado como "falso" e
a função ter terminado de ler todas as entradas.
</simpara>
<programlisting role="php">
<![CDATA[
<?php
$dir = "/etc/php5/";
// Abre um diretório existente, e faz a leitura de seu conteúdo
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
while (($file = readdir($dh)) !== false) {
echo "filename: $file : filetype: " . filetype($dir . $file) . "\n";
if ($handle = opendir('/path/to/files')) {
echo "Entradas:\n";
/* Lidando corretamente com entradas de diretório que podem ser interpretadas como "falso" */
while (false !== ($entry = readdir($handle))) {
if ($entry === '.' || $entry === '..') {
continue;
}
closedir($dh);
echo "$entry\n";
}
closedir($handle);
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
filename: . : filetype: dir
filename: .. : filetype: dir
filename: apache : filetype: dir
filename: cgi : filetype: dir
filename: cli : filetype: dir
Entradas:
base
en
fr
output.md
test.php
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>is_dir</function></member>
<member><function>readdir</function></member>
<member><function>dir</function></member>
</simplelist>
</para>
<simplelist>
<member><function>readdir</function></member>
<member><function>rewinddir</function></member>
<member><function>closedir</function></member>
<member><function>dir</function></member>
<member><function>is_dir</function></member>
<member><function>glob</function></member>
<member><function>scandir</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: leonardolara Status: ready -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 5c7e9e1351240b5f9e0858cdeba8f754a366d1b7 Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.readdir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>readdir</refname>
@@ -13,37 +11,35 @@
<type class="union"><type>string</type><type>false</type></type><methodname>readdir</methodname>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Retorna o nome da próxima entrada do diretório. As
entradas são retornadas na ordem em que estão armazenadas no
<simpara>
Retorna o nome da próxima entrada do diretório.
As entradas são retornadas na ordem em que estão armazenadas no
sistema de arquivos.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
O manipulador de diretório do tipo <type>resource</type> previamente aberto
com <function>opendir</function>. Se o manipulador de diretório não
for especificado, o último manipulador aberto por <function>opendir</function>
será o assumido.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<simpara>
O manipulador de diretório do tipo <type>resource</type> previamente aberto
por <function>opendir</function>.
Se <parameter>dir_handle</parameter> for &null;, o último manipulador aberto
por <function>opendir</function> será usado.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna o nome do arquivo em caso de sucesso&return.falseforfailure;.
</para>
<simpara>
Retorna o nome do arquivo em caso de sucesso,&return.falseforfailure;.
</simpara>
&return.falseproblem;
</refsect1>
@@ -58,6 +54,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Usar &null; para <parameter>dir_handle</parameter> foi descontinuado.
Em vez disso, o manipulador do último diretório aberto deve ser fornecido explicitamente.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
@@ -71,77 +74,23 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Listando todas as entradas de um diretório</title>
<para>
Note a maneira com que o valor de retorno de
<function>readdir</function> é verificado nos exemplos abaixo. Está
sendo explicitamente testado se o valor de retorno é idêntico a (igual e
do mesmo tipo que--consulte <link linkend="language.operators.comparison">Operadores de
Comparação</link> para maiores detalhes) &false;, caso contrário,
qualquer entrada de diretório cujo nome seja interpretado como &false; irá parar o
loop (por exemplo, um diretório com nome "0").
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($handle = opendir('/caminho/para/arquivos')) {
echo "Manipulador de diretório: $handle\n";
echo "Arquivos:\n";
/* Esta é a forma correta de percorrer o diretório */
while (false !== ($entry = readdir($handle))) {
echo "$entry\n";
}
/* Esta é a forma INCORRETA de percorrer o diretório */
while ($entry = readdir($handle)) {
echo "$entry\n";
}
closedir($handle);
}
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>
Lista todas as entradas no diretório atual e remove <literal>.</literal>
e <literal>..</literal>
</title>
<programlisting role="php">
<![CDATA[
<?php
if ($handle = opendir('.')) {
while (false !== ($entry = readdir($handle))) {
if ($entry != "." && $entry != "..") {
echo "$entry\n";
}
}
closedir($handle);
}
?>
]]>
</programlisting>
</example>
</para>
<simpara>
Para um exemplo completo, consulte a documentação de
<function>opendir</function>.
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>is_dir</function></member>
<member><function>glob</function></member>
<member><function>opendir</function></member>
<member><function>scandir</function></member>
</simplelist>
</para>
<simplelist>
<member><function>opendir</function></member>
<member><function>rewinddir</function></member>
<member><function>closedir</function></member>
<member><function>dir</function></member>
<member><function>is_dir</function></member>
<member><function>glob</function></member>
<member><function>scandir</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,49 +1,44 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: leonardolara Status: ready -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<refentry xml:id="function.rewinddir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>rewinddir</refname>
<refpurpose>Retroceder o manipulador de diretório</refpurpose>
</refnamediv>
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 5c7e9e1351240b5f9e0858cdeba8f754a366d1b7 Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.rewinddir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>rewinddir</refname>
<refpurpose>Retroceder o manipulador de diretório</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>rewinddir</methodname>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Reinicia o fluxo do diretório indicado por
<parameter>dir_handle</parameter> para o início do
diretório.
</para>
<methodsynopsis>
<type>void</type><methodname>rewinddir</methodname>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<simpara>
Reinicia o fluxo do diretório indicado por <parameter>dir_handle</parameter>
para o início do diretório.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
O manipulador de diretório do tipo <type>resource</type> aberto previamente
com <function>opendir</function>. Se o manipulador de diretório não
for especificado, o último manipulador aberto por <function>opendir</function>
será o assumido.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>dir_handle</parameter></term>
<listitem>
<simpara>
O manipulador de diretório do tipo <type>resource</type> previamente aberto
por <function>opendir</function>.
Se <parameter>dir_handle</parameter> for &null;, o último manipulador aberto
por <function>opendir</function> será usado.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -57,6 +52,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Usar &null; para <parameter>dir_handle</parameter> foi descontinuado.
Em vez disso, o manipulador do último diretório aberto deve ser fornecido explicitamente.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
@@ -68,6 +70,26 @@
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<simpara>
Para um exemplo completo, consulte a documentação de
<function>opendir</function>.
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>opendir</function></member>
<member><function>readdir</function></member>
<member><function>closedir</function></member>
<member><function>dir</function></member>
<member><function>is_dir</function></member>
<member><function>glob</function></member>
<member><function>scandir</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 198702020219835de11dc3064b7dc0590361ecab Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 480cc8a9efdb0d2cb1a12bc5c3bab80875a099ee Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.xdiff-string-rabdiff" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>xdiff_string_rabdiff</refname>
@@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string|false</type><methodname>xdiff_string_rabdiff</methodname>
<type class="union"><type>string</type><type>false</type></type><methodname>xdiff_string_rabdiff</methodname>
<methodparam><type>string</type><parameter>old_data</parameter></methodparam>
<methodparam><type>string</type><parameter>new_data</parameter></methodparam>
</methodsynopsis>