rarruda Tue Dec 25 16:54:37 2001 EDT
Added files:
/phpdoc/pt_BR/functions overload.xml
Log:
Translated file. (definetly needs revision)
Index: phpdoc/pt_BR/functions/overload.xml
+++ phpdoc/pt_BR/functions/overload.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.overload">
<title>Object property and method call overloading</title>
<titleabbrev>Object overloading</titleabbrev>
<partintro id="overload.partintro">
&warn.experimental;
<para>
O prop�sito desta extens�o � permitir overload de propriedades
de acesso e metodos de objetos. Somente uma fun��o � definida
nesta extens�o, <function>overload</function> que recebe o
nome da classe que deve ter esta funcionalidade habilitada.
A classe especificada tem que definir os metodos para
ter esta funcionalidade: <literal>__get()</literal>,
<literal>__set()</literal> and <literal>__call()</literal>
respectivamente para get/set as propriedades, ou chamar um metodo.
Desta forma o overloading pode ser seletivo. Dentro destas fun��es
o overloading � disabilitado de forma que voc� possa acessar
propriedades do objeto normalmente.
</para>
<para>
Alguns exemplos simples da utiliza��o da fun��o
<function>overload</function>
<example>
<title>Overload de uma classe no PHP</title>
<programlisting role="php">
<![CDATA[
<?php
class OO
{
var $a = 111;
var $elem = array('b' => 9, 'c' => 42);
// Metodo callback para pegar uma propriedade
function __get($prop_name, &$prop_value)
{
if (isset($this->elem[$prop_name])) {
$prop_value = $this->elem[$prop_name];
return true;
} else {
return false;
}
}
// Metodo callback para definir uma propriedade
function __set($prop_name, $prop_value)
{
$this->elem[$prop_name] = $prop_value;
return true;
}
}
// Aqui n�s � feito o overload do objeto OO
overload('OO');
$o = new OO;
print "\$o->a: $o->a\n"; // print: $o->a:
print "\$o->b: $o->b\n"; // print: $o->b: 9
print "\$o->c: $o->c\n"; // print: $o->c: 42
print "\$o->d: $o->d\n"; // print: $o->d:
// adicionar um novo intem para o array $elem em OO
$o->x = 56;
// iniciar stdclass (� integrada no PHP 4)
// $var n�o � overloaded!
$val = new stdclass;
$val->prop = 555;
// Que "a" seja um array com o objeto $val dentro dele
// mas __set() o colocar� no array $elem
$o->a = array($val);
var_dump($o->a[0]->prop);
?>
]]>
</programlisting>
</example>
</para>
<warning>
<para>
Como esta � uma extens�o experimental, nem todas
as coisas funcionam. N�o existe ainda suporte para
<literal>__call()</literal> e voc� somente pode
fazer overload das opera��es get e set para
propriedades. Voc� n�o pode invocar as chamadas
originais da classe (antes de terem sido overloaded),
e <literal>__set()</literal> somente funciona
at� um n�vel de acesso de propriedades.
</para>
</warning>
</partintro>
<refentry id="function.overload">
<refnamediv>
<refname>overload</refname>
<refpurpose>
Habilitar overloading de chamadas de propriedade e metodo para classes
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<funcsynopsis>
<funcprototype>
<funcdef>void
<function>overload</function>
</funcdef>
<paramdef>string
<parameter>
<optional>class_name</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
A fun��o <function>overload</function> ir� habilitar overloading
de chamadas de propriedades e metodos para classes identificadas
por <parameter>class_name</parameter>.
<link linkend="overload.partintro">Veja um exemplo
na se��o introdut�ria desta parte</link>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
