mirror of
https://github.com/php/doc-pt_br.git
synced 2026-03-23 22:52:12 +01:00
fix and improve translation
This commit is contained in:
@@ -33,8 +33,8 @@
|
||||
Existem diversos formatos offline do manual, e o formato mais adequado
|
||||
depende do sistema operacional e do
|
||||
estilo de leitura pessoal. Para informações de como o manual é gerado em tantos
|
||||
formatos, veja a seção <link linkend="about.generate">'Como nós geramos os
|
||||
formatos'</link> deste apêndice.
|
||||
formatos, veja a seção <link linkend="about.generate">Como os
|
||||
formatos são gerados</link> deste apêndice.
|
||||
</para>
|
||||
<para>
|
||||
A versão HTML é o formato mais multi-plataforma deste manual. Esta versão
|
||||
@@ -380,29 +380,29 @@ Retorna o tamanho da string dada.
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="about.generate">
|
||||
<title>Como nós geramos os formatos</title>
|
||||
<title>Como os formatos são gerados</title>
|
||||
<para>
|
||||
Este Manual é escrito em <acronym>XML</acronym> usando o <link
|
||||
xlink:href="&url.docbook.xml;">DocBook XML DTD</link>, usando <link
|
||||
Este manual é escrito em <acronym>XML</acronym> usando o <link
|
||||
xlink:href="&url.docbook.xml;">DocBook XML DTD</link> e o <link
|
||||
xlink:href="&url.phd;"><acronym>PhD</acronym></link> (The [PH]P based
|
||||
[D]ocBook renderer) para manutenção e formatação.
|
||||
</para>
|
||||
<para>
|
||||
Usar <acronym>XML</acronym> como formato fonte nos dá
|
||||
Usar <acronym>XML</acronym> dá
|
||||
a capacidade de gerar diversos formatos de saída a partir
|
||||
dos arquivos fonte, enquanto apenas um documento fonte é mantido para todos os formatos.
|
||||
A ferramenta usada para formatar o manual online é <link
|
||||
A ferramenta usada para formatar o manual online é o <link
|
||||
xlink:href="&url.phd;">PhD</link>.
|
||||
Usamos <link xlink:href="&url.winhelp;">Microsoft HTML Help
|
||||
Workshop</link> para gerar o formato <productname>Windows HTML Help</productname>
|
||||
do manual e, é claro, o próprio PHP
|
||||
O <link xlink:href="&url.winhelp;">Microsoft HTML Help
|
||||
Workshop</link> é usado para gerar o formato <productname>Windows HTML Help</productname>
|
||||
do manual e, é claro, o próprio PHP é usado
|
||||
para fazer algumas conversões e formatações.
|
||||
</para>
|
||||
<para>
|
||||
O manual PHP é gerado em vários idiomas e formatos, veja
|
||||
O manual do PHP é gerado em vários idiomas e formatos, veja
|
||||
<link xlink:href="&url.php.docs;">&url.php.docs;</link> para maiores detalhes.
|
||||
O código fonte <acronym>XML</acronym> pode ser baixado do Git e
|
||||
visualizado em <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link>.
|
||||
visualizado em <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link> (ou doc-pt_br para o manual em português do Brasil).
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 6d46a5549bcb66444ce7a3b34301420ba7552bc8 Maintainer: ae Status: ready --><!-- CREDITS: felipe,rarruda,ae,pasf,fibbarth,adiel,lhsazevedo -->
|
||||
<appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>Lista de funções sinônimas (aliases)</title>
|
||||
<title>Lista de funções sinônimas</title>
|
||||
<para>
|
||||
Existem algumas poucas funções no PHP que podem ser chamadas com mais de um
|
||||
nome. Em alguns casos, não existe preferência entres os nomes,
|
||||
@@ -20,7 +20,7 @@
|
||||
<tgroup cols="3">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Nome da função sinônima (alias)</entry>
|
||||
<entry>Nome da função sinônima</entry>
|
||||
<entry>Nome da função canônica</entry>
|
||||
<entry>Extensão usada</entry>
|
||||
</row>
|
||||
|
||||
@@ -528,7 +528,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Duração do tempo (em segundos) pela qual armazenar em cache as informações do realpath
|
||||
Duração do tempo (em segundos) em que as informações do realpath deve ser armazenadas em cache
|
||||
para um dado arquivo ou diretório. Para sistemas com arquivos que raramente mudam,
|
||||
considere aumentar o valor.
|
||||
</para>
|
||||
|
||||
@@ -203,7 +203,7 @@ echo ANIMALS[1]; // imprime "cat"
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.new-features.anonymous-classes">
|
||||
<title>Classes anônimas</title>
|
||||
<title>Classes Anônimas</title>
|
||||
|
||||
<para>
|
||||
O suporte a classes anônimas foi adicionado utilizando <literal>new
|
||||
|
||||
@@ -287,7 +287,7 @@ foo(...gen());
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration73.incompatible.spl">
|
||||
<title>Standard PHP Library (SPL)</title>
|
||||
<title>Biblioteca Padrão PHP (SPL)</title>
|
||||
|
||||
<para>
|
||||
Se um autoloader <link linkend="book.spl">SPL</link> lançar uma exceção,
|
||||
|
||||
@@ -258,7 +258,7 @@
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration74.incompatible.spl">
|
||||
<title>Standard PHP Library (SPL)</title>
|
||||
<title>Biblioteca Padrão PHP (SPL)</title>
|
||||
|
||||
<para>
|
||||
Chamar <function>get_object_vars</function> em uma instância de <classname>ArrayObject</classname>
|
||||
|
||||
@@ -31,10 +31,10 @@ class User {
|
||||
</sect3>
|
||||
|
||||
<sect3 xml:id="migration74.new-features.core.arrow-functions">
|
||||
<title>Arrow functions</title>
|
||||
<title>Funções de Seta</title>
|
||||
|
||||
<para>
|
||||
<link linkend="functions.arrow">Arrow functions</link> fornecem uma
|
||||
<link linkend="functions.arrow">Funções de seta</link> fornecem uma
|
||||
sintaxe abreviada para definir funções
|
||||
com ligação implícita por valor de escopo.
|
||||
|
||||
|
||||
@@ -61,7 +61,7 @@
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration74.new-functions.pcntl">
|
||||
<title>Process Control</title>
|
||||
<title>Controle de Processos</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
|
||||
@@ -161,8 +161,8 @@ class Test {
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$fn = fn() => throw new Exception('Exception in arrow function');
|
||||
$user = $session->user ?? throw new Exception('Must have user');
|
||||
$fn = fn() => throw new Exception('Exceção na função de seta');
|
||||
$user = $session->user ?? throw new Exception('É necessário haver um usuário.');
|
||||
]]>
|
||||
</programlisting>
|
||||
<!-- RFC: https://wiki.php.net/rfc/throw_expression -->
|
||||
|
||||
@@ -87,10 +87,10 @@ $arr2 = [...$arr1, 'c' => 'd']; //[1, 'a' => 'b', 'c' => 'd']
|
||||
</sect3>
|
||||
|
||||
<sect3 xml:id="migration81.new-features.core.callable-syntax">
|
||||
<title>Sintaxe de Callable de Primeira Classe</title>
|
||||
<title>Sintaxe de Chamáveis de Primeira Classe</title>
|
||||
|
||||
<para>
|
||||
Closures para callables agora podem ser criadas usando <link linkend="functions.first_class_callable_syntax">a sintaxe <code>myFunc(...)</code></link>,
|
||||
Closures para chamáveis agora podem ser criadas usando <link linkend="functions.first_class_callable_syntax">a sintaxe <code>myFunc(...)</code></link>,
|
||||
que é idêntica a <code>Closure::fromCallable('myFunc')</code>.
|
||||
<!-- RFC: https://wiki.php.net/rfc/first_class_callable_syntax -->
|
||||
</para>
|
||||
|
||||
@@ -132,7 +132,7 @@
|
||||
</sect3>
|
||||
|
||||
<sect3 xml:id="migration83.other-changes.functions.calendar">
|
||||
<title>Calendar</title>
|
||||
<title>Calendário</title>
|
||||
|
||||
<para>
|
||||
A função <function>easter_date</function> agora suporta anos de 1970 a
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
</para>
|
||||
|
||||
<sect1 xml:id="reserved.keywords">
|
||||
<title>Lista de Palavras-chave (Keywords)</title>
|
||||
<title>Lista de Palavras-chave</title>
|
||||
<simpara>
|
||||
Estas palavras têm um significado especial no PHP. Algumas delas representam coisas
|
||||
que parecem funções, algumas parecem constantes, e assim por diante - mas
|
||||
|
||||
@@ -62,7 +62,7 @@ PHP por vários critérios.</para>'>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
|
||||
<!ENTITY extcat.membership '<title xmlns="http://docbook.org/ns/docbook">Sociedade</title>'>
|
||||
<!ENTITY extcat.membership '<title xmlns="http://docbook.org/ns/docbook">Classificadas por Pertencimento</title>'>
|
||||
|
||||
<!ENTITY extcat.membership.core '<title xmlns="http://docbook.org/ns/docbook">Extensões Principais</title><para xmlns="http://docbook.org/ns/docbook">Essas
|
||||
não são de fato extensões. Eles são parte do núcleo do PHP e não podem ser
|
||||
@@ -76,14 +76,14 @@ compilar essas extensões é preciso ter bibliotecas externas.</para>'>
|
||||
|
||||
<!ENTITY extcat.membership.pecl '<title xmlns="http://docbook.org/ns/docbook">Extensões
|
||||
PECL</title>
|
||||
<para xmlns="http://docbook.org/ns/docbook">Essas extensões estão disponíveis em
|
||||
<para xmlns="http://docbook.org/ns/docbook">Essas extensões estão disponíveis no
|
||||
&link.pecl;. Elas podem requerer bibliotecas externas. Existem outras extensões PECL mas
|
||||
elas não estão documentadas no manual do PHP.</para>'>
|
||||
|
||||
<!-- ======================================================================= -->
|
||||
|
||||
<!ENTITY extcat.state '<title xmlns="http://docbook.org/ns/docbook">Estado</title><para xmlns="http://docbook.org/ns/docbook">Essa parte lista as extensões
|
||||
não destinadas para uso de produção - elas são ou muito velhas (descontinuadas) ou
|
||||
<!ENTITY extcat.state '<title xmlns="http://docbook.org/ns/docbook">Classificadas por status de desenvolvimento</title><para xmlns="http://docbook.org/ns/docbook">Essa parte lista as extensões
|
||||
não destinadas para uso em produção - elas são ou muito antigas (descontinuadas) ou
|
||||
muito novas (experimentais).</para>'>
|
||||
|
||||
<!ENTITY extcat.state.deprecated '<title xmlns="http://docbook.org/ns/docbook">Extensões Descontinuadas</title><para xmlns="http://docbook.org/ns/docbook">Essas
|
||||
@@ -91,6 +91,6 @@ extensões tornaram-se descontinuadas normalmente em favor de outras extensões.
|
||||
|
||||
<!ENTITY extcat.state.experimental '<title xmlns="http://docbook.org/ns/docbook">Extensões Experimentais</title><para xmlns="http://docbook.org/ns/docbook">O
|
||||
comportamento dessas extensões - incluindo os nomes das suas funções e qualquer
|
||||
outra coisa documentada sobre essas extensões - podem mudar sem aviso em versões futuras
|
||||
outra coisa documentada sobre essas extensões - pode mudar sem aviso em versões futuras
|
||||
do PHP. Use essas funções a seu próprio risco.</para>'>
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<refentry xml:id="context.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
|
||||
<refnamediv>
|
||||
<refname>Opções de contexto para Zip</refname>
|
||||
<refpurpose>Listagem de opções de contexto para Zip</refpurpose>
|
||||
<refpurpose>Lista de opções de contexto de Zip</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description"><!-- {{{ -->
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<refentry xml:id="context.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
|
||||
<refnamediv>
|
||||
<refname>Opções de contexto Zlib</refname>
|
||||
<refpurpose>Listagem de opções de contexto Zlib</refpurpose>
|
||||
<refpurpose>Lista de opções de contexto de Zlib</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
|
||||
@@ -12,24 +12,24 @@
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Enums aparecem em muitas linguagens com uma variedade de recursos diferentes. No PHP,
|
||||
Enums são um tipo especial de objeto. A Enum em si é uma classe, e seus possíveis
|
||||
casos são todos objetos de instância única dessa classe. Isso significa que casos Enum são
|
||||
Enumerações aparecem em muitas linguagens com uma variedade de recursos diferentes. No PHP,
|
||||
Enumerações são um tipo especial de objeto. A enumeração em si é uma classe, e seus possíveis
|
||||
casos são todos objetos de instância única dessa classe. Isso significa que casos de enumeração são
|
||||
objetos válidos e podem ser usados em qualquer lugar em que um objeto pode ser usado, incluindo verificações de tipo.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
O exemplo mais popular de enumerações é o tipo embutido booleano, que é um
|
||||
tipo enumerado com valores válidos &true; e &false;.
|
||||
Enums permitem que os desenvolvedores definam suas próprias enumerações robustas.
|
||||
Enumerações permitem que os desenvolvedores definam suas próprias enumerações robustas.
|
||||
</para>
|
||||
</sect1>
|
||||
<sect1 xml:id="language.enumerations.basics">
|
||||
<title>Enumerações básicas</title>
|
||||
<title>Enumerações Básicas</title>
|
||||
|
||||
<para>
|
||||
Enums são similares às classes, e compartilham o mesmo namespaces que as classes, interfaces, e traits.
|
||||
Elas também podem ser carregadas automaticamente da mesma maneira. Uma Enum define um novo tipo, que possui um número fixo
|
||||
Enumerações são similares às classes e compartilham o mesmo namespaces que classes, interfaces, e traits.
|
||||
Elas também podem ser carregadas automaticamente da mesma maneira. Uma Enumeração define um novo tipo, que possui um número fixo
|
||||
e limitado de valores legais possíveis.
|
||||
</para>
|
||||
|
||||
@@ -82,7 +82,7 @@ pegar_uma_carta('Espadas');
|
||||
|
||||
<para>
|
||||
Uma enumeração pode ter zero ou mais definições <literal>case</literal>, sem limite máximo.
|
||||
Uma enum sem nenhum caso é sintaticamente válida, embora inútil.
|
||||
Uma enumeração sem nenhum caso é sintaticamente válida, embora inútil.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@@ -110,18 +110,18 @@ $a instanceof Naipe; // true
|
||||
</programlisting>
|
||||
|
||||
<para>
|
||||
Isso também significa que os valores enum nunca são <literal><</literal> ou <literal>></literal> do que o outro,
|
||||
Isso também significa que os valores de enumeração nunca são <literal><</literal> ou <literal>></literal> do que o outro,
|
||||
uma vez que essas comparações não fazem sentido em objetos. Essas comparações sempre retornarão
|
||||
&false; ao trabalhar com valores enum.
|
||||
&false; ao trabalhar com valores de enumeração.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Esse tipo de caso, sem dados relacionados, é chamado de "Caso Puro". Uma Enum que contém
|
||||
apenas Casos Puros é chamada de Pure Enum (enum pura).
|
||||
Esse tipo de caso, sem dados relacionados, é chamado de "Caso Puro". Uma enumeração que contém
|
||||
apenas Casos Puros é chamada de Enumeração Pura.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Todos os Casos Puros são implementados como instâncias de seus tipos enum. O tipo enum é representado internamente como uma classe.
|
||||
Todos os Casos Puros são implementados como instâncias de seus tipos 'enum'. O tipo 'enum' é representado internamente como uma classe.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@@ -141,15 +141,15 @@ print Naipe::Espadas->name;
|
||||
|
||||
<para>
|
||||
É possível também utilizar as funções <function>defined</function> e <function>constant</function>
|
||||
para verificar a existência ou ler um item de enum se o nome for obtido dinamicamente.
|
||||
Isto é desencorajado, já que utilizar <link linkend="language.enumerations.backed">Backed enums</link>
|
||||
para verificar a existência ou ler um item de enumeração se o nome for obtido dinamicamente.
|
||||
Isto é desencorajado, já que utilizar <link linkend="language.enumerations.backed">Enumerações Apoiadas</link>
|
||||
funciona para a maioria dos casos.
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="language.enumerations.backed">
|
||||
<title>Backed enums</title>
|
||||
<title>Enumerações Apoiadas</title>
|
||||
|
||||
<para>
|
||||
Por padrão, os Casos não possuem um equivalente escalar. Eles são apenas objetos singleton. No entanto,
|
||||
@@ -176,19 +176,19 @@ enum Naipe: string
|
||||
</programlisting>
|
||||
|
||||
<para>
|
||||
Um caso que possui um equivalente escalar é chamado de Backed Case, sendo "Backed" no sentido de lastreado, suportado,
|
||||
por um valor mais simples. Uma Enum que possui todos Casos Lastreados é chamada Backed Enum.
|
||||
Uma Backed Enum pode conter apenas Backed Case. Uma Enum Pura pode conter apenas Casos Puros.
|
||||
Um caso que possui um equivalente escalar é chamado de Caso Apoiado, sendo "Apoiado" no sentido de lastreado, suportado,
|
||||
por um valor mais simples. Uma enumeração que possui todos Casos Apoiados é chamada Enumeração Apoiada.
|
||||
Uma Enumeração Apoiada pode conter apenas Casos Apoiados. Uma Enumeração Pura pode conter apenas Casos Puros.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Uma Backed Enum pode associar valores de tipos <literal>int</literal> ou <literal>string</literal>,
|
||||
Uma Enumeração Apoiada pode associar valores de tipos <literal>int</literal> ou <literal>string</literal>,
|
||||
e uma determinada enumeração suporta apenas um único tipo de cada vez (isto é, sem união de <literal>int|string</literal>).
|
||||
Se uma enumeração for marcada como tendo um equivalente escalar, então todos os casos devem possuir um escalar equivalente
|
||||
único definido explicitamente. Não existem equivalentes escalares gerados automaticamente
|
||||
(p. ex.: inteiros sequenciais). Casos lastreados devem ser únicos; dois casos enum lastreados não podem
|
||||
(p. ex.: inteiros sequenciais). Casos apoiados devem ser únicos; dois casos apoiados não podem
|
||||
ter o mesmo equivalente escalar. No entanto, uma constante pode se referir a um caso, efetivamente
|
||||
criando um apelido. Veja <link linkend="language.enumerations.constants">Constantes de enumeração</link>.
|
||||
criando um apelido. Veja as <link linkend="language.enumerations.constants">constantes de enumeração</link>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@@ -200,7 +200,7 @@ enum Naipe: string
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Backed Cases possuem uma propriedade somente leitura adicional, <literal>value</literal>, que é o valor
|
||||
Casos Apoiados possuem uma propriedade somente leitura adicional, <literal>value</literal>, que é o valor
|
||||
especificado na definição.
|
||||
</para>
|
||||
|
||||
@@ -231,20 +231,20 @@ $ref = &$naipe->value;
|
||||
</programlisting>
|
||||
|
||||
<para>
|
||||
Backed Enums implementam uma interface interna <interfacename>BackedEnum</interfacename>,
|
||||
Enumerações Apoiadas implementam uma interface interna <interfacename>BackedEnum</interfacename>,
|
||||
que expõe dois métodos adicionais:
|
||||
</para>
|
||||
|
||||
<simplelist>
|
||||
<member>
|
||||
<literal>from(int|string): self</literal> recebe uma escalar e retornará o Caso Enum
|
||||
correspondente. Se um não for encontrado, ela lançará um <classname>ValueError</classname>. Isso é útil
|
||||
principalmente nas situações somente valores previstos são permitidos e um valor enum ausente deve ser
|
||||
<literal>from(int|string): self</literal> recebe um escalar e retornará o caso
|
||||
correspondente da enumeração. Se não for encontrado, ela lançará um <classname>ValueError</classname>. Isso é útil
|
||||
principalmente nas situações somente valores previstos são permitidos e um valor de enumeração ausente deve ser
|
||||
considerado um erro de interrupção de aplicação.
|
||||
</member>
|
||||
<member>
|
||||
<literal>tryFrom(int|string): ?self</literal> recebe uma escalar e retornará o
|
||||
Caso Enum correspondente. Se um não for encontrado, ela retornará <literal>null</literal>.
|
||||
caso de enumeração correspondente. Se um não for encontrado, ela retornará <literal>null</literal>.
|
||||
Isso é útil principalmente em casos onde o escalar de entrada não é confiável e o chamador quer
|
||||
implementar sua própria lógica de manipulação de erros ou de valor padrão.
|
||||
</member>
|
||||
@@ -255,7 +255,7 @@ $ref = &$naipe->value;
|
||||
padrão de tipagem fraca/forte. No modo de tipagem fraca, passar um inteiro ou string é aceitável
|
||||
e o sistema irá coagir o valor de acordo. Passar um float também irá funcionar e será
|
||||
convertido. No modo de tipagem estrita, passar um inteiro para <literal>from()</literal> em uma
|
||||
enum associada a strings (ou vice-versa) irá resultar em um <classname>TypeError</classname>,
|
||||
enumeração associada a strings (ou vice-versa) irá resultar em um <classname>TypeError</classname>,
|
||||
assim como um float irá lançar um erro em todas as circunstâncias. Todos os outros tipos de parâmetro lançarão um TypeError
|
||||
em ambos os modos.
|
||||
</para>
|
||||
@@ -278,7 +278,7 @@ print $naipe->value;
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
<para>Definir manualmente um método <literal>from()</literal> ou <literal>tryFrom()</literal> em uma Backed Enum irá resultar em um erro fatal.</para>
|
||||
<para>Definir manualmente um método <literal>from()</literal> ou <literal>tryFrom()</literal> em uma Enumeração Apoiada irá resultar em um erro fatal.</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
@@ -286,9 +286,9 @@ print $naipe->value;
|
||||
<title>Métodos de enumerações</title>
|
||||
|
||||
<para>
|
||||
Enums (tanto Puras quanto Backed) podem conter métodos, e podem implementar interfaces.
|
||||
Se uma Enum implementa uma interface, então qualquer verificação de tipo para aquela interface também aceitará
|
||||
todos os casos daquela Enum.
|
||||
Enumerações (tanto Puras quanto Apoiadas) podem conter métodos e podem implementar interfaces.
|
||||
Se uma enumeração implementa uma interface, qualquer verificação de tipo para aquela interface também aceitará
|
||||
todos os casos daquela enumeração.
|
||||
</para>
|
||||
|
||||
<programlisting role="php">
|
||||
@@ -342,7 +342,7 @@ print Naipe::Ouros->shape(); // imprime "Retângulo"
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Em uma Backed Enum, a declaração de interface vai após a declaração do tipo de lastro.
|
||||
Em uma Enumeração Apoiada, a declaração de interface vai após a declaração do tipo de lastro.
|
||||
</para>
|
||||
|
||||
<programlisting role="php">
|
||||
@@ -386,7 +386,7 @@ enum Naipe: string implements Colorido
|
||||
|
||||
<para>
|
||||
Note que nesse caso, uma prática melhor de modelagem de dados seria definir também um
|
||||
Tipo Enum <literal>CorDeNaipe</literal> com valores Preto e Vermelho e retornar isso no seu lugar.
|
||||
Tipo 'enum' <literal>CorDeNaipe</literal> com valores Preto e Vermelho e retornar isso no seu lugar.
|
||||
No entanto, isso complicaria esse exemplo.
|
||||
</para>
|
||||
|
||||
@@ -428,7 +428,7 @@ final class Naipe implements UnitEnum, Colorido
|
||||
|
||||
public static function cases(): array
|
||||
{
|
||||
// Método ilegal, porque definir manualmente um método cases() em uma Enum não é permitido.
|
||||
// Método ilegal, porque definir manualmente um método cases() em uma enumeração não é permitido.
|
||||
// Veja também a seção "Listagem de valores".
|
||||
}
|
||||
}
|
||||
@@ -489,7 +489,7 @@ enum Tamanho
|
||||
apesar das privadas e protegidas são equivalentes na prática, pois herança não é permitida.
|
||||
</para>
|
||||
|
||||
<para>Uma constante de enum pode se referir a um caso enum:</para>
|
||||
<para>Uma constante de enumeração pode se referir a um caso de enumeração:</para>
|
||||
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
@@ -511,9 +511,9 @@ enum Tamanho
|
||||
<sect1 xml:id="language.enumerations.traits">
|
||||
<title>Traits</title>
|
||||
|
||||
<para>Enumerações podem utilizar traits, que se comportam da mesma maneira que nas classes.
|
||||
A limitação é que usados com <literal>use</literal> em uma enum não podem conter propriedades.
|
||||
Eles podem incluir apenas métodos, métodos estáticos e constantes. Um trait com propriedades
|
||||
<para>Enumerações podem utilizar Traits, que se comportam da mesma maneira que nas classes.
|
||||
A limitação é que usados com <literal>use</literal> em uma enumeração não podem conter propriedades.
|
||||
Eles podem incluir apenas métodos, métodos estáticos e constantes. Um Trait com propriedades
|
||||
resultará em um erro fatal.
|
||||
</para>
|
||||
|
||||
@@ -556,17 +556,17 @@ enum Naipe implements Colorido
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="language.enumerations.expressions">
|
||||
<title>Valores enum em expressões constantes</title>
|
||||
<title>Valores de enumeração em expressões constantes</title>
|
||||
|
||||
<para>
|
||||
Como os casos são representados como constantes no próprio enum, eles podem ser usados como valores
|
||||
Como os casos são representados como constantes na própria enumeração, eles podem ser usados como valores
|
||||
estáticos na maioria das expressões constantes: padrões de propriedades, padrões de variáveis estáticas, padrões
|
||||
de parâmetros, valores constantes globais e de classes. Eles não podem ser usados em outros valores de caso enum, mas
|
||||
constantes normais podem se referir a um caso enum.
|
||||
de parâmetros, valores constantes globais e de classes. Eles não podem ser usados em outros valores de caso de enumeração, mas
|
||||
constantes normais podem se referir a um caso.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
No entanto, chamadas implícitas de métodos mágicos como <classname>ArrayAccess</classname> em enums não são permitidas em definições estáticas
|
||||
No entanto, chamadas implícitas de métodos mágicos como <classname>ArrayAccess</classname> em enumerações não são permitidas em definições estáticas
|
||||
ou de constantes já que não podemos garantir absolutamente que o valor resultante é determinístico
|
||||
ou que a invocação do método é livre de efeitos colaterais. Chamadas de funções, chamadas de métodos e
|
||||
acesso às propriedades continuam a ser operações inválidas em expressões constantes.
|
||||
@@ -576,7 +576,7 @@ enum Naipe implements Colorido
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
// Esta é uma definição de Enum perfeitamente legal.
|
||||
// Esta é uma definição de enumeração perfeitamente legal.
|
||||
enum Direcao implements ArrayAccess
|
||||
{
|
||||
case Cima;
|
||||
@@ -627,17 +627,17 @@ $foo = new Foo();
|
||||
<title>Diferenças de objetos</title>
|
||||
|
||||
<para>
|
||||
Apesar de Enums serem construídas sobre classes e objetos, elas não suportam todas as funcionalidades relacionadas a objetos.
|
||||
Em particular, casos Enum são proibidos de ter estado.
|
||||
Apesar de enumerações serem construídas sobre classes e objetos, elas não suportam todas as funcionalidades relacionadas a objetos.
|
||||
Em particular, casos de enumeração são proibidos de ter estado.
|
||||
</para>
|
||||
|
||||
<simplelist>
|
||||
<member>Construtores e Destrutores são proibidos.</member>
|
||||
<member>Herança não é suportada. Enums não podem estender ou ser estendidos.</member>
|
||||
<member>Herança não é suportada. Enumerações não podem estender ou ser estendidas.</member>
|
||||
<member>Propriedades estáticas ou de objeto não são permitidas.</member>
|
||||
<member>Clonar um caso Enum não é suportado, pois os casos devem ser instâncias singleton.</member>
|
||||
<member>Clonar um caso de enumeração não é suportado, pois os casos devem ser instâncias únicas.</member>
|
||||
<member><link linkend="language.oop5.magic">Métodos mágicos</link>, exceto para aqueles listados abaixo, não são permitidos.</member>
|
||||
<member>Enums sempre precisam ser declarados antes de serem utilizados.</member>
|
||||
<member>Enumerações sempre precisam ser declaradas antes de serem utilizadas.</member>
|
||||
</simplelist>
|
||||
|
||||
<para>As seguintes funcionalidades de objeto estão disponíveis, e se comportam exatamente como em qualquer outro objeto:</para>
|
||||
@@ -646,12 +646,12 @@ $foo = new Foo();
|
||||
<member>Métodos públicos, privados e protegidos.</member>
|
||||
<member>Métodos estáticos públicos, privados e protegidos.</member>
|
||||
<member>Constantes públicas, privadas e protegidas.</member>
|
||||
<member>Enums podem implementar qualquer número de interfaces.</member>
|
||||
<member>Enumerações podem implementar qualquer número de interfaces.</member>
|
||||
<member>
|
||||
Enums e casos podem ter <link linkend="language.attributes">atributos</link> anexados
|
||||
Enumerações e casos podem ter <link linkend="language.attributes">atributos</link> anexados
|
||||
a eles. O filtro de alvo <constant>TARGET_CLASS</constant>
|
||||
inclui as próprias Enums. O filtro de alvo <constant>TARGET_CLASS_CONST</constant>
|
||||
inclui Casos Enum.
|
||||
inclui as próprias enumerações. O filtro de alvo <constant>TARGET_CLASS_CONST</constant>
|
||||
inclui Casos de Enumeração.
|
||||
</member>
|
||||
<member>
|
||||
Os métodos mágicos <link linkend="object.call">__call</link>, <link linkend="object.callstatic">__callStatic</link>,
|
||||
@@ -661,9 +661,9 @@ $foo = new Foo();
|
||||
</simplelist>
|
||||
|
||||
<para>
|
||||
A constante mágica <literal>::class</literal> em um tipo Enum avalia ao nome
|
||||
A constante mágica <literal>::class</literal> em um tipo 'enum' avalia ao nome
|
||||
do tipo incluindo qualquer namespace, exatamente o mesmo que um objeto. A constante mágica <literal>::class</literal>
|
||||
em uma instância de Caso também avalia para o tipo Enum, pois ele é uma
|
||||
em uma instância de Caso também avalia para o tipo 'enum', pois ele é uma
|
||||
instância daquele tipo.
|
||||
</para>
|
||||
|
||||
@@ -690,7 +690,7 @@ $ferraduras = (new ReflectionClass(Naipe::class))->newInstanceWithoutConstructor
|
||||
<title>Listagem de valores</title>
|
||||
|
||||
<para>
|
||||
Tanto Pure Enums quanto Backed Enums implementam uma interface interna chamada
|
||||
Tanto Enumerações Puras quanto Enumerações Apoiadas implementam uma interface interna chamada
|
||||
<interfacename>UnitEnum</interfacename>. <literal>UnitEnum</literal> inclui um método estático
|
||||
<literal>cases()</literal>. <literal>cases()</literal> retorna um array embalado com
|
||||
todos os Casos definidos na ordem de declaração.
|
||||
@@ -706,7 +706,7 @@ Naipe::cases();
|
||||
]]>
|
||||
</programlisting>
|
||||
|
||||
<para>Definir manualmente um método <literal>cases()</literal> em uma Enum resultará em um erro fatal.</para>
|
||||
<para>Definir manualmente um método <literal>cases()</literal> em uma enumeração resultará em um erro fatal.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="language.enumerations.serialization">
|
||||
@@ -714,7 +714,7 @@ Naipe::cases();
|
||||
|
||||
<para>
|
||||
As enumerações são serializadas de maneira diferente dos objetos. Especificamente, elas têm um novo código de serialização,
|
||||
<literal>"E"</literal>, que especifica o nome do caso enum. A rotina de desserialização pode
|
||||
<literal>"E"</literal>, que especifica o nome do caso de enumeração. A rotina de desserialização pode
|
||||
então usar isso para definir uma variável para o valor singleton existente. Isso garante que:
|
||||
</para>
|
||||
|
||||
@@ -731,17 +731,17 @@ print serialize(Naipe::Copas);
|
||||
</programlisting>
|
||||
|
||||
<para>
|
||||
Na desserialização, se uma enum e caso não podem ser encontrados para combinar com um valor
|
||||
Na desserialização, se uma enumeração e um caso não podem ser encontrados para combinar com um valor
|
||||
serializado, um aviso será emitido e &false; retornado.</para>
|
||||
|
||||
<para>
|
||||
Se uma Pure Enum for serializada para JSON, um erro será lançado. Se uma Backed Enum
|
||||
Se uma Enumeração Pura for serializada para JSON, um erro será lançado. Se uma Enumeração Apoiada
|
||||
for serializada para JSON, ela será representada apenas por seu valor escalar, no
|
||||
tipo apropriado. O comportamento de ambas pode ser sobrescrito ao implementar
|
||||
<classname>JsonSerializable</classname>.
|
||||
</para>
|
||||
|
||||
<para>Para <function>print_r</function>, a saída de um caso enum é ligeiramente diferente
|
||||
<para>Para <function>print_r</function>, a saída de um caso de enumeração é ligeiramente diferente
|
||||
dos objetos para minimizar confusões.
|
||||
</para>
|
||||
|
||||
@@ -777,7 +777,7 @@ Baz Enum:int {
|
||||
|
||||
<sect1 xml:id="language.enumerations.object-differences.inheritance">
|
||||
|
||||
<title>Porque enums não são extensíveis</title>
|
||||
<title>Porque enumerações não são extensíveis</title>
|
||||
|
||||
<simpara>
|
||||
Classes possuem contratos em seus métodos:
|
||||
@@ -806,7 +806,7 @@ function bar(B $b) {
|
||||
</simpara>
|
||||
|
||||
<simpara>
|
||||
Enums possuem contratos em seus itens, não em seus métodos:
|
||||
Enumerações possuem contratos em seus itens, não em seus métodos:
|
||||
</simpara>
|
||||
|
||||
<programlisting role="php">
|
||||
@@ -835,7 +835,7 @@ function quux(ErrorCode $errorCode)
|
||||
</simpara>
|
||||
|
||||
<simpara>
|
||||
Mas imagine que seja possível estender enums, assim:
|
||||
Mas imagine que seja possível estender enumerações, assim:
|
||||
</simpara>
|
||||
|
||||
|
||||
@@ -843,7 +843,7 @@ function quux(ErrorCode $errorCode)
|
||||
<;
|
||||
$f9 = [Foo::class, 'metodoestatico'](...);
|
||||
@@ -1677,9 +1677,9 @@ $f9 = [Foo::class, 'metodoestatico'](...);
|
||||
|
||||
<para>
|
||||
<code>CallableExpr(...)</code> tem a mesma semântica que <methodname>Closure::fromCallable</methodname>.
|
||||
Isto é, That is, ao contrário de callable usando string e array, <code>CallableExpr(...)</code> respeita o escopo no ponto onde ela é criada:
|
||||
Isto é, That is, ao contrário de um chamável usando string e array, <code>CallableExpr(...)</code> respeita o escopo no ponto onde ela é criada:
|
||||
<example>
|
||||
<title>Comparação de escopo de <code>CallableExpr(...)</code> e callable tradicional</title>
|
||||
<title>Comparação de escopo de <code>CallableExpr(...)</code> e chamável tradicional</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
@@ -1702,7 +1702,7 @@ $metodoPrivado();
|
||||
|
||||
class Foo1 {
|
||||
public function obterMetodoPrivado() {
|
||||
// Usa o escopo onde o callable é adquirido.
|
||||
// Usa o escopo onde o chamável é adquirido.
|
||||
return $this->metodoPrivado(...); // Idêntico a Closure::fromCallable([$this, 'metodoPrivado']);
|
||||
}
|
||||
|
||||
|
||||
@@ -785,8 +785,8 @@ use const algum\namespace\{ConstA, ConstB, ConstC};
|
||||
</sect2>
|
||||
</sect1>
|
||||
<sect1 xml:id="language.namespaces.global">
|
||||
<title>Espaço global</title>
|
||||
<titleabbrev>Espaço global</titleabbrev>
|
||||
<title>Espaço Global</title>
|
||||
<titleabbrev>Espaço Global</titleabbrev>
|
||||
<?phpdoc print-version-for="namespaces"?>
|
||||
<para>
|
||||
Quando um namespace não é definido, todas as definições de classes e funções são
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,lhsazevedo,leonardolara -->
|
||||
<sect1 xml:id="language.oop5.anonymous" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>Classes anônimas</title>
|
||||
<title>Classes Anônimas</title>
|
||||
|
||||
<para>
|
||||
Classes anônimas são úteis quando objetos simples e descartáveis precisarem ser criados.
|
||||
@@ -154,7 +154,7 @@ same class
|
||||
|
||||
<note>
|
||||
<para>
|
||||
Classes anônimas tem nomes atribuídos automaticamente
|
||||
Classes anônimas têm nomes atribuídos automaticamente
|
||||
como demonstrado no exemplo a seguir. Este nome deve ser
|
||||
considerado apenas um detalhe não confiável na implementação.
|
||||
</para>
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,amandavale,narigone,fabioluciano,lhsazevedo,leonardolara -->
|
||||
|
||||
<sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>O básico</title>
|
||||
<title>O Básico</title>
|
||||
|
||||
<sect2 xml:id="language.oop5.basic.class">
|
||||
<title>class</title>
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 28529d3539b850e870e3aa97570f4db0e53daa03 Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae,fabioluciano -->
|
||||
<!-- EN-Revision: 28529d3539b850e870e3aa97570f4db0e53daa03 Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae,fabioluciano,leonardolara -->
|
||||
<sect1 xml:id="language.oop5.cloning" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>Clonando objetos</title>
|
||||
<title>Clonando Objetos</title>
|
||||
|
||||
<para>
|
||||
Criar uma cópia de um objeto com propriedades totalmente replicadas nem sempre
|
||||
@@ -30,7 +30,7 @@ $copia_do_objeto = clone $objeto;
|
||||
</informalexample>
|
||||
|
||||
<para>
|
||||
Ao se clonar um objeto, o PHP fará uma cópia superficial de todas as
|
||||
Ao clonar um objeto, o PHP fará uma cópia superficial de todas as
|
||||
propriedades do objeto. Qualquer propriedade que seja referência a outra variável,
|
||||
permanecerá como referência.
|
||||
</para>
|
||||
@@ -72,8 +72,8 @@ class MyCloneable
|
||||
|
||||
function __clone()
|
||||
{
|
||||
// Force a copy of this->object, otherwise
|
||||
// it will point to same object.
|
||||
// Força uma cópia de this->object, caso contrário
|
||||
// aponta para o mesmo objeto.
|
||||
$this->object1 = clone $this->object1;
|
||||
}
|
||||
}
|
||||
@@ -86,10 +86,10 @@ $obj->object2 = new SubObject();
|
||||
$obj2 = clone $obj;
|
||||
|
||||
|
||||
print "Original Object:\n";
|
||||
print "Objeto original:\n";
|
||||
print_r($obj);
|
||||
|
||||
print "Cloned Object:\n";
|
||||
print "Objeto clonado:\n";
|
||||
print_r($obj2);
|
||||
|
||||
?>
|
||||
@@ -98,7 +98,7 @@ print_r($obj2);
|
||||
&example.outputs;
|
||||
<screen role="php">
|
||||
<![CDATA[
|
||||
Original Object:
|
||||
Objeto original:
|
||||
MyCloneable Object
|
||||
(
|
||||
[object1] => SubObject Object
|
||||
@@ -112,7 +112,7 @@ MyCloneable Object
|
||||
)
|
||||
|
||||
)
|
||||
Cloned Object:
|
||||
Objeto clonado:
|
||||
MyCloneable Object
|
||||
(
|
||||
[object1] => SubObject Object
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 5e15a6c3e4d5819102361ae78e73c90a06238c8a Maintainer: ae Status: ready --><!-- CREDITS: narigone,felipe,lcobucci,fabioluciano,ae,github:GabrielGabriel197 -->
|
||||
<sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>Métodos mágicos</title>
|
||||
<title>Métodos Mágicos</title>
|
||||
<para>
|
||||
Métodos mágicos são métodos especiais que sobrescrever o comportamento padrão do PHP
|
||||
quando certas operações são realizadas em um objeto.
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: ae Status: ready --><!-- CREDITS: narigone, felipe, ae, fabioluciano, cviniciussdias -->
|
||||
<sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>Comparando objetos</title>
|
||||
<title>Comparando Objetos</title>
|
||||
<para>
|
||||
Ao usar o operador de comparação (<literal>==</literal>),
|
||||
as variáveis dos objetos são comparadas de maneira simples, nominalmente: Duas instâncias
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
<refentry xml:id="closure.fromcallable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Closure::fromCallable</refname>
|
||||
<refpurpose>Converte um callable em uma closure</refpurpose>
|
||||
<refpurpose>Converte um chamável em uma closure</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
@@ -21,7 +21,7 @@
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
A partir do PHP 8.1.0, <link linkend="functions.first_class_callable_syntax">Sintaxe de callable de primeira classe</link> possui a mesma semântica que este método.
|
||||
A partir do PHP 8.1.0, <link linkend="functions.first_class_callable_syntax">Sintaxe de chamáveis de primeira classe</link> possui a mesma semântica que este método.
|
||||
</para>
|
||||
</note>
|
||||
</refsect1>
|
||||
@@ -33,7 +33,7 @@
|
||||
<term><parameter>callback</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
O callable para converter.
|
||||
O chamável a ser convertido.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -53,7 +53,7 @@
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><link linkend="functions.anonymous">Funções anônimas</link></member>
|
||||
<member><link linkend="functions.first_class_callable_syntax">Sintaxe de callable de primeira classe</link></member>
|
||||
<member><link linkend="functions.first_class_callable_syntax">Sintaxe de chamável de primeira classe</link></member>
|
||||
</simplelist>
|
||||
</refsect1>
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<!-- EN-Revision: 267a3d4e60d8a6da941e72d195386b5841052cca Maintainer: leonardolara Status: ready -->
|
||||
<reference xml:id="class.countable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
|
||||
|
||||
<title>Interface Countable</title>
|
||||
<title>A interface Countable</title>
|
||||
<titleabbrev>Countable</titleabbrev>
|
||||
|
||||
<partintro>
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 20b4b383127faaf37495d7746885f2bb674a1a33 Maintainer: ae Status: ready --><!-- CREDITS: royopa,ae,leonardolara -->
|
||||
<!-- EN-Revision: 20b4b383127faaf37495d7746885f2bb674a1a33 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,ae,leonardolara -->
|
||||
<reference xml:id="class.iteratoraggregate" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
|
||||
|
||||
<title>The IteratorAggregate interface</title>
|
||||
<title>A interface IteratorAggregate</title>
|
||||
<titleabbrev>IteratorAggregate</titleabbrev>
|
||||
|
||||
<partintro>
|
||||
@@ -42,7 +42,7 @@
|
||||
<section xml:id="iteratoraggregate.examples">
|
||||
&reftitle.examples;
|
||||
<example xml:id="iteratoraggregate.example.basic"><!-- {{{ -->
|
||||
<title>Basic usage</title>
|
||||
<title>Uso básico</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
|
||||
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,ae,leonardolara -->
|
||||
<reference xml:id="class.serializable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
|
||||
|
||||
<title>The Serializable interface</title>
|
||||
<title>A interface Serializable</title>
|
||||
<titleabbrev>Serializable</titleabbrev>
|
||||
|
||||
<partintro>
|
||||
@@ -17,12 +17,12 @@
|
||||
<para>
|
||||
Classes que implementam esta intarface não possuem mais suporte aos métodos
|
||||
<link linkend="object.sleep">__sleep()</link> and
|
||||
<link linkend="object.wakeup">__wakeup()</link>. O método serialize é
|
||||
<link linkend="object.wakeup">__wakeup()</link>. O método de serialização é
|
||||
chamado não importando se uma instância possui a necessidade de ser serializada. Não invoca o método __destruct(),
|
||||
ou possui qualquer outro efeito colateral a não ser que programado no método. Quando os dados são
|
||||
deserializados, a classe toma conhecimento e o método unserialize() apropriado é chamado como
|
||||
um construtor, em vez de chamar o método __construct(). Se necessitar executar o construtor
|
||||
padrão, pode-se fazer no método.
|
||||
desserializados, a classe toma conhecimento e o método unserialize() apropriado é chamado como
|
||||
um construtor, em vez de chamar o método __construct(). Se for necessário executar o construtor
|
||||
padrão, pode-se fazer isso no método.
|
||||
</para>
|
||||
|
||||
<warning>
|
||||
@@ -54,7 +54,7 @@
|
||||
<section xml:id="serializable.examples">
|
||||
&reftitle.examples;
|
||||
<example xml:id="serializable.example.basic"><!-- {{{ -->
|
||||
<title>Basic usage</title>
|
||||
<title>Uso básico</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<!-- EN-Revision: 09caff9ea664f7154a7d37e92b2c332c28462404 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
|
||||
<reference xml:id="class.throwable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
|
||||
|
||||
<title>Throwable</title>
|
||||
<title>A classe Throwable</title>
|
||||
<titleabbrev>Throwable</titleabbrev>
|
||||
|
||||
<partintro>
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: f4609f913fe6bf4a8b41328df9366726208b7e33 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
|
||||
<sect1 xml:id="language.types.enumerations">
|
||||
<title>Enumerations</title>
|
||||
<title>Enumerações</title>
|
||||
<?phpdoc print-version-for="enumerations"?>
|
||||
|
||||
<sect2 xml:id="language.types.enumerations.basics">
|
||||
<title>Enumerações Básicas</title>
|
||||
|
||||
<para>
|
||||
Enumerations são uma camada de restrição sobre classes e constantes de classe,
|
||||
Enumerações são uma camada de restrição sobre classes e constantes de classe,
|
||||
destinadas a fornecer uma maneira de definir um conjunto fechado de valores possíveis para um tipo.
|
||||
</para>
|
||||
|
||||
@@ -37,7 +37,7 @@ do_stuff(Suit::Spades);
|
||||
|
||||
<simpara>
|
||||
Para uma discussão completa, consulte o capítulo
|
||||
<link linkend="language.enumerations">Enumerations.</link>
|
||||
sobre <link linkend="language.enumerations">enumerações.</link>
|
||||
</simpara>
|
||||
|
||||
</sect2>
|
||||
@@ -48,9 +48,9 @@ do_stuff(Suit::Spades);
|
||||
<para>
|
||||
Se um <type>enum</type> for convertido em um <type>object</type>, ele não será
|
||||
modificado. Se um <type>enum</type> for convertido em um <type>array</type>,
|
||||
será criado um array com uma única chave de <literal>name</literal> (para enumerations puras) ou
|
||||
será criado um array com uma única chave de <literal>name</literal> (para enumerações puras) ou
|
||||
um array com chaves <literal>name</literal> e <literal>value</literal>
|
||||
(para enumerations com backup). Todos os outros tipos de conversão resultarão em erro.
|
||||
(para enumerações com backup). Todos os outros tipos de conversão resultarão em erro.
|
||||
</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
|
||||
<sect1 xml:id="language.types.mixed">
|
||||
<title>Mixed</title>
|
||||
<title>Misto</title>
|
||||
|
||||
<para>
|
||||
O tipo <type>mixed</type> aceita todos os valores. É equivalente ao
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
|
||||
<refnamediv>
|
||||
<refname>ogg://</refname>
|
||||
<refpurpose>Streams de áudio</refpurpose>
|
||||
<refpurpose>Fluxos de áudio</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description"><!-- {{{ -->
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
<book xml:id="book.bc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="bundled" ?>
|
||||
<title>BCMath, funções matemáticas de precisão arbitrária</title>
|
||||
<title>Funções matemáticas de precisão arbitrária</title>
|
||||
<titleabbrev>BC Math</titleabbrev>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
@@ -35,7 +35,7 @@ $num1 = 0; // (string) 0 => '0'
|
||||
$num2 = -0.000005; // (string) -0.000005 => '-5.05E-6'
|
||||
echo bcadd($num1, $num2, 6); // => '0.000000'
|
||||
|
||||
setlocale(LC_NUMERIC, 'de_DE'); // uses a decimal comma
|
||||
setlocale(LC_NUMERIC, 'de_DE'); // usa uma vírgula como separador de decimais
|
||||
$num2 = 1.2; // (string) 1.2 => '1,2'
|
||||
echo bcsub($num1, $num2, 1); // => '0.0'
|
||||
?>
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
<book xml:id="book.calendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="bundled" ?>
|
||||
<title>Calendar</title>
|
||||
<title>Calendário</title>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
<preface xml:id="intro.calendar">
|
||||
|
||||
@@ -3,8 +3,8 @@
|
||||
|
||||
<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="core"?>
|
||||
<title>Data e Hora</title>
|
||||
<titleabbrev>Data/Hora</titleabbrev>
|
||||
<title>Data e Horário</title>
|
||||
<titleabbrev>Data/Horário</titleabbrev>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
<preface xml:id="intro.datetime">
|
||||
@@ -56,7 +56,7 @@
|
||||
&reference.datetime.reference;
|
||||
|
||||
<article xml:id="datetime.error.tree">
|
||||
<title>Erros e Exceções de Data/Hora</title>
|
||||
<title>Erros e Exceções de Data/Horário</title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
<section xml:id="dateexception.intro">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
Classe pai das exceções de Data/Hora, para problemas que surgem devido a
|
||||
Classe pai das exceções de Data/Horário, para problemas que surgem devido a
|
||||
entradas do usuário ou argumentos texto em formato livre que precisam ser analisados.
|
||||
</para>
|
||||
<para>
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
<section xml:id="datemalformedstringexception.intro">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
Disparada quando uma string inválida de Data/Hora é detectada.
|
||||
Disparada quando uma string inválida de Data/Horário é detectada.
|
||||
</para>
|
||||
<para>
|
||||
Pode ser um valor para
|
||||
|
||||
@@ -9,11 +9,11 @@
|
||||
<section xml:id="dateobjecterror.intro">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
Disparada quando uma das classe de Data/Hora não foi corretamente
|
||||
Disparada quando uma das classe de Data/Horário não foi corretamente
|
||||
inicializada.
|
||||
</para>
|
||||
<para>
|
||||
Como as classes de Data/Hora não são finais, eles podem ser herdadas.
|
||||
Como as classes de Data/Horário não são finais, eles podem ser herdadas.
|
||||
Quando um construtor da classe pai não é chamado, este erro é disparado. Este é
|
||||
sempre um erro de programação.
|
||||
</para>
|
||||
|
||||
@@ -280,7 +280,7 @@
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry align="center"><emphasis>Data/Hora completa</emphasis></entry>
|
||||
<entry align="center"><emphasis>Data/Horário completos</emphasis></entry>
|
||||
<entry>---</entry>
|
||||
<entry>---</entry>
|
||||
</row>
|
||||
|
||||
@@ -315,7 +315,7 @@
|
||||
<entry><literal>-43200</literal> a <literal>50400</literal></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry align="center"><emphasis>Data/Hora completa</emphasis></entry>
|
||||
<entry align="center"><emphasis>Data/Horário completos</emphasis></entry>
|
||||
<entry>---</entry>
|
||||
<entry>---</entry>
|
||||
</row>
|
||||
@@ -331,7 +331,7 @@
|
||||
</row>
|
||||
<row>
|
||||
<entry><literal>U</literal></entry>
|
||||
<entry>Segundos desde a Era Unix (1 de janeiro de 1970 00:00:00 GMT)</entry>
|
||||
<entry>Segundos desde a Época Unix (1 de janeiro de 1970 00:00:00 GMT)</entry>
|
||||
<entry>Veja também <function>time</function></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
<para>
|
||||
Retorna o timestamp Unix correspondente aos argumentos informados.
|
||||
Este timestamp é um inteiro longo contendo o número de segundos
|
||||
entre a Era Unix (January 1 1970 00:00:00 GMT), e o tempo
|
||||
entre a Época Unix (January 1 1970 00:00:00 GMT), e o horário
|
||||
especificado.
|
||||
</para>
|
||||
<para>
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
&extension.runtime;
|
||||
<para>
|
||||
<table>
|
||||
<title>Opções de Configuração de Data/Hora</title>
|
||||
<title>Opções de Configuração de Data/Horário</title>
|
||||
<tgroup cols="4">
|
||||
<thead>
|
||||
<row>
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
|
||||
|
||||
<reference xml:id="ref.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>&Functions; de Data/Hora</title>
|
||||
<title>&Functions; de Data/Horário</title>
|
||||
|
||||
&reference.datetime.entities.functions;
|
||||
|
||||
|
||||
@@ -3,17 +3,17 @@
|
||||
|
||||
<book xml:id="book.dio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="pecl" ?>
|
||||
<title>IO Direto</title>
|
||||
<title>E/S Direta</title>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
<preface xml:id="intro.dio">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
O PHP oferece suporte às funções de I/O direto, conforme descrito no Padrão Posix
|
||||
(Seção 6), para realizar funções de I/O em um nível mais baixo do que as funções
|
||||
de I/O de fluxo da linguagem C
|
||||
O PHP oferece suporte às funções de E/S Direta, conforme descrito no Padrão Posix
|
||||
(Seção 6), para realizar funções de E/S em um nível mais baixo do que as funções
|
||||
de E/S de fluxo da linguagem C
|
||||
(<function>fopen</function>, <function>fread</function>,..). O uso
|
||||
das funções DIO deve ser considerado apenas quando é necessário o controle direto
|
||||
das funções de E/S Direta deve ser considerado apenas quando é necessário o controle direto
|
||||
de um dispositivo. Em todos os outros casos, as funções padrão do
|
||||
<link linkend="book.filesystem">sistema de arquivos</link> são mais
|
||||
do que adequadas.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
|
||||
|
||||
<reference xml:id="ref.dio" xmlns="http://docbook.org/ns/docbook">
|
||||
<title>IO Direto &Functions;</title>
|
||||
<title>&Functions; de E/S Direta</title>
|
||||
|
||||
&reference.dio.entities.functions;
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
<book xml:id="book.imagick" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="pecl" ?>
|
||||
<title>Processamento de Imagem (ImageMagick)</title>
|
||||
<title>Processamento de Imagem</title>
|
||||
<titleabbrev>ImageMagick</titleabbrev>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
|
||||
@@ -3,14 +3,14 @@
|
||||
|
||||
<book xml:id="book.pcntl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="bundled" ?>
|
||||
<title>Process Control</title>
|
||||
<title>Controle de Processos</title>
|
||||
<titleabbrev>PCNTL</titleabbrev>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
<preface xml:id="intro.pcntl">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
O suporte ao controle de processos em PHP implementa o estilo Unix de
|
||||
O suporte ao controle de processos no PHP implementa o estilo Unix de
|
||||
criação de processos, execução de programas, manipulação de sinais e
|
||||
encerramento de processos. O Controle de Processo não deve ser ativado em um
|
||||
ambiente de servidor web e resultados inesperados podem ocorrer se alguma
|
||||
@@ -27,11 +27,11 @@
|
||||
<para>
|
||||
PCNTL agora usa ticks como mecanismo de retorno de chamada de identificador de sinal, que é
|
||||
muito mais rápido que o mecanismo anterior. Esta mudança segue a mesma
|
||||
semântica do uso de "user ticks". Você usa a instrução <function>declare</function>
|
||||
para especificar os locais em seu programa onde os retornos de chamada
|
||||
semântica do uso de "user ticks". A instrução <function>declare</function> é usada
|
||||
para especificar os locais na aplicação onde as funções de retorno
|
||||
podem ocorrer. Isso permite minimizar a sobrecarga do tratamento de
|
||||
eventos assíncronos. No passado, compilar PHP com pcntl habilitado
|
||||
sempre incorreria nessa sobrecarga, independentemente de seu script usar
|
||||
eventos assíncronos. No passado, compilar o PHP com pcntl habilitado
|
||||
sempre incorreria nessa sobrecarga, independentemente do script usar
|
||||
pcntl ou não.
|
||||
</para>
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
<book xml:id="book.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<?phpdoc extension-membership="pecl" ?>
|
||||
<title>Rar Archiving</title>
|
||||
<title>Arquivamento Rar</title>
|
||||
<titleabbrev>Rar</titleabbrev>
|
||||
|
||||
<!-- {{{ preface -->
|
||||
|
||||
@@ -60,7 +60,7 @@
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
</simplelist>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
@@ -78,7 +78,7 @@ enum(Suit::Clubs)
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
<member><methodname>ReflectionEnum::getCases</methodname></member>
|
||||
<member><methodname>ReflectionEnum::hasCase</methodname></member>
|
||||
<member><methodname>ReflectionEnum::isBacked</methodname></member>
|
||||
|
||||
@@ -75,7 +75,7 @@ enum(Suit::Spades)
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
<member><methodname>ReflectionEnum::getCase</methodname></member>
|
||||
<member><methodname>ReflectionEnum::isBacked</methodname></member>
|
||||
</simplelist>
|
||||
|
||||
@@ -76,7 +76,7 @@ bool(false)
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
<member><methodname>ReflectionEnum::getCase</methodname></member>
|
||||
<member><methodname>ReflectionEnum::getCases</methodname></member>
|
||||
</simplelist>
|
||||
|
||||
@@ -63,7 +63,7 @@
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
<member><classname>ReflectionEnumUnitCase</classname></member>
|
||||
</simplelist>
|
||||
</para>
|
||||
|
||||
@@ -60,7 +60,7 @@
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><link linkend="language.enumerations">Enumerations</link></member>
|
||||
<member><link linkend="language.enumerations">Enumerações</link></member>
|
||||
<member><classname>ReflectionEnumBackedCase</classname></member>
|
||||
</simplelist>
|
||||
</para>
|
||||
|
||||
@@ -2,13 +2,13 @@
|
||||
<!-- EN-Revision: e93feee2870bb551cd11d625271b7f82da3ccb05 Maintainer: leonardolara Status: ready --><!-- CREDITS: diogo,ae,adiel,leonardolara -->
|
||||
<book xml:id="book.spl" xmlns="http://docbook.org/ns/docbook">
|
||||
<?phpdoc extension-membership="core" ?>
|
||||
<title>Standard PHP Library (SPL)</title>
|
||||
<title>Biblioteca Padrão PHP (SPL)</title>
|
||||
<titleabbrev>SPL</titleabbrev>
|
||||
|
||||
<preface xml:id="intro.spl" annotations="chunk:false">
|
||||
&reftitle.intro;
|
||||
<simpara>
|
||||
A extensão Standard PHP Library (SPL) define interfaces e classes
|
||||
A extensão SPL - Standard PHP Library (Biblioteca Padrão PHP) define interfaces e classes
|
||||
destinadas a resolver problemas comuns.
|
||||
</simpara>
|
||||
<simpara>
|
||||
|
||||
Reference in New Issue
Block a user