cvs: phpdoc /pt_BR/functions overload.xml

From:	Renato Arruda	Date:	Tue, 25 Dec 2001 21:54:37 +0000
Subject:	cvs: phpdoc /pt_BR/functions overload.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969340332@lists.php.net to get a copy of this message

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"?>  <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>