cvs: phpdoc-zh /language/oop5 abstract.xml cloning.xml constants.xml final.xml interfaces.xml iterations.xml magic.xml object-comparison.xml
overloading.xml
| From: | Hao Chen | Date: | Sat, 13 Dec 2008 03:45:30 +0000 |
| Subject: | cvs: phpdoc-zh /language/oop5 abstract.xml cloning.xml constants.xml final.xml interfaces.xml iterations.xml magic.xml object-comparison.xml overloading.xml |
||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-3048@lists.php.net to get a copy of this message | ||
haohappy Sat Dec 13 03:45:30 2008 UTC
Modified files:
/phpdoc-zh/language/oop5 abstract.xml cloning.xml constants.xml
final.xml interfaces.xml iterations.xml
magic.xml object-comparison.xml
overloading.xml
Log:
new files added
http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/abstract.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/abstract.xml diff -u /dev/null phpdoc-zh/language/oop5/abstract.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/abstract.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,103 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.15 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.abstract" xmlns="http://docbook.org/ns/docbook"> + <title>æ½è±¡ç±»</title> + + <para> + PHP5æ¯ææ½è±¡ç±»åæ½è±¡æ¹æ³ãæ½è±¡ç±»ä¸è½ç´æ¥è¢«å®ä¾åï¼ä½ å¿ é¡»å ç»§æ¿è¯¥æ½è±¡ç±»ï¼ç¶ååå®ä¾ååç±»ãæ½è±¡ç±»ä¸ + è³å°è¦å å«ä¸ä¸ªæ½è±¡æ¹æ³ãå¦æç±»æ¹æ³è¢«å£°æä¸ºæ½è±¡çï¼é£ä¹å ¶ä¸å°±ä¸è½å æ¬å ·ä½çåè½å®ç°ã + </para> + + <para> + ç»§æ¿ä¸ä¸ªæ½è±¡ç±»çæ¶åï¼åç±»å¿ é¡»å®ç°æ½è±¡ç±»ä¸çæææ½è±¡æ¹æ³ï¼å¦å¤ï¼è¿äºæ¹æ³ç<link linkend="language.oop5.visibility">å¯è§æ§</link> + å¿ é¡»åæ½è±¡ç±»ä¸ä¸æ ·ï¼æè æ´ä¸ºå®½æ¾ï¼ã妿æ½è±¡ç±»ä¸æä¸ªæ½è±¡æ¹æ³è¢«å£°æä¸ºprotectedï¼é£ä¹åç±»ä¸å®ç°çæ¹æ³å°±åºè¯¥å£°æä¸ºprotectedæè publicï¼èä¸ + è½å®ä¹ä¸ºprivateã + </para> + + <example> + <title>æ½è±¡ç±»ä»£ç 示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +abstract class AbstractClass +{ + // 强å¶è¦æ±åç±»å®ä¹è¿äºæ¹æ³ + abstract protected function getValue(); + abstract protected function prefixValue($prefix); + + // æ®éæ¹æ³ï¼éæ½è±¡æ¹æ³ï¼ + public function printOut() { + print $this->getValue() . "\n"; + } +} + +class ConcreteClass1 extends AbstractClass +{ + protected function getValue() { + return "ConcreteClass1"; + } + + public function prefixValue($prefix) { + return "{$prefix}ConcreteClass1"; + } +} + +class ConcreteClass2 extends AbstractClass +{ + public function getValue() { + return "ConcreteClass2"; + } + + public function prefixValue($prefix) { + return "{$prefix}ConcreteClass2"; + } +} + +$class1 = new ConcreteClass1; +$class1->printOut(); +echo $class1->prefixValue('FOO_') ."\n"; + +$class2 = new ConcreteClass2; +$class2->printOut(); +echo $class2->prefixValue('FOO_') ."\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +ConcreteClass1 +FOO_ConcreteClass1 +ConcreteClass2 +FOO_ConcreteClass2 +]]> + </screen> + </example> + + <para> + æ½è±¡ç±»çåç±»ä¸çæ®éæ¹æ³æ§è¡æ¹å¼åå ¶ä»ç±»ç¸åã + </para> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/cloning.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/cloning.xml diff -u /dev/null phpdoc-zh/language/oop5/cloning.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/cloning.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,143 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.cloning" xmlns="http://docbook.org/ns/docbook"> + <title>对象å¤å¶</title> + + <para> + å¨å¤æ°æ åµä¸ï¼æä»¬å¹¶ä¸éè¦å®å ¨å¤å¶ä¸ä¸ªå¯¹è±¡æ¥è·å¾å ¶ä¸å±æ§ã使ä¸ä¸ªæ åµä¸ç¡®å®éè¦ï¼å¦æä½ æä¸ä¸ª + GTKçªå£å¯¹è±¡ï¼è¯¥å¯¹è±¡ææçªå£ç¸å ³çèµæºãä½ å¯è½ä¼æ³å¤å¶ä¸ä¸ªæ°ççªå£ï¼ä¿æææå±æ§ä¸åæ¥ççªå£ç¸åï¼ + ä½å¿ é¡»æ¯ä¸ä¸ªæ°ç对象ï¼å ä¸ºå¦æä¸æ¯æ°ç对象ï¼é£ä¹ä¸ä¸ªçªå£ä¸çæ¹åå°±ä¼å½±åå°å¦ä¸ä¸ªçªå£ï¼ãè¿æä¸ç§æ åµï¼ + å¦æå¯¹è±¡Aä¸ä¿åç对象Bçå¼ç¨ï¼å½ä½ å¤å¶å¯¹è±¡Aæ¶ï¼ä½ æ³å ¶ä¸ä½¿ç¨ç对象ä¸åæ¯å¯¹è±¡Bèæ¯Bçä¸ä¸ªå¯æ¬ï¼é£ä¹ + ä½ å¿ é¡»å¾å°å¯¹è±¡Açä¸ä¸ªå¯æ¬ã + + </para> + + <para> + 对象å¤å¶å¯ä»¥éè¿cloneå ³é®åæ¥å®æï¼å¦æå¯¹è±¡ä¸åå¨__clone()æ¹æ³ï¼ä¼å 被è°ç¨ï¼ã对象ä¸ç + __clone()æ¹æ³ä¸è½ç´æ¥è°ç¨ã + </para> + + <informalexample> + <programlisting> +<![CDATA[ +$copy_of_object = clone $object; +]]> + </programlisting> + </informalexample> + + <para> + å½å¯¹è±¡è¢«å¤å¶åï¼PHP5ä¼å¯¹å¯¹è±¡çææå±æ§æ§è¡ä¸ä¸ªâæµ å¤å¶âï¼shallow copyï¼ãææç屿§ä¸çå¼ç¨ + ä»ç¶ä¸åï¼æå忥çåéã妿å®ä¹äº__clone()æ¹æ³ï¼åæ°å建ç对象ï¼å¤å¶çæç对象ï¼ä¸ç__clone()æ¹æ³ä¼è¢«è°ç¨ï¼ + å¯ç¨äºä¿®æ¹å±æ§çå¼ï¼å¦ææå¿ è¦çè¯ï¼ã + </para> + + <example> + <title>å¤å¶ä¸ä¸ªå¯¹è±¡</title> + <programlisting role="php"> +<![CDATA[ +<?php +class SubObject +{ + static $instances = 0; + public $instance; + + public function __construct() { + $this->instance = ++self::$instances; + } + + public function __clone() { + $this->instance = ++self::$instances; + } +} + +class MyCloneable +{ + public $object1; + public $object2; + + function __clone() + { + + // 强å¶å¤å¶ä¸ä»½this->objectï¼ å¦åä»ç¶æååä¸ä¸ªå¯¹è±¡ + $this->object1 = clone $this->object1; + } +} + +$obj = new MyCloneable(); + +$obj->object1 = new SubObject(); +$obj->object2 = new SubObject(); + +$obj2 = clone $obj; + + +print("Original Object:\n"); +print_r($obj); + +print("Cloned Object:\n"); +print_r($obj2); + +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Original Object: +MyCloneable Object +( + [object1] => SubObject Object + ( + [instance] => 1 + ) + + [object2] => SubObject Object + ( + [instance] => 2 + ) + +) +Cloned Object: +MyCloneable Object +( + [object1] => SubObject Object + ( + [instance] => 3 + ) + + [object2] => SubObject Object + ( + [instance] => 2 + ) + +) +]]> + + </screen> + + </example> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/constants.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/constants.xml diff -u /dev/null phpdoc-zh/language/oop5/constants.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/constants.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.17 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> + <title>类常é</title> + <para> + æä»¬å¯ä»¥å¨ç±»ä¸å®ä¹å¸¸éã常éçå¼å°å§ç»ä¿æä¸åãå¨å®ä¹å使ç¨å¸¸éçæ¶åä¸éè¦ä½¿ç¨<varname>$</varname>符å·ã + </para> + <para> + 常éçå¼å¿ é¡»æ¯ä¸ä¸ªå®å¼ï¼ä¸è½æ¯åéï¼ç±»å±æ§æå ¶å®æä½ï¼å¦å½æ°è°ç¨ï¼çç»æã + </para> + <para> + Its also possible for interfaces to have <literal>constants</literal>. Look at + the <link linkend="language.oop5.interfaces">interface documentation</link> for + examples. + + æ¥å£ï¼interfaceï¼ä¸ä¹å¯ä»¥å®ä¹å¸¸éã请æ¥ç<link linkend="language.oop5.interfaces">æ¥å£çææ¡£</link>è·å¾æ´å¤ç¤ºä¾ã + </para> + <para> + PHP5.3.0ä¹åï¼æä»¬å¯ä»¥ç¨ä¸ä¸ªå鿥卿è°ç¨ç±»ãä½è¯¥åéçå¼ä¸è½ä¸ºå ³é®å<literal>self</literal>, + <literal>parent</literal> æ<literal>static</literal>ã + </para> + <example> + <title>å®ä¹å使ç¨ä¸ä¸ªç±»å¸¸é</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyClass +{ + const constant = 'constant value'; + + function showConstant() { + echo self::constant . "\n"; + } +} + +echo MyClass::constant . "\n"; + +$classname = "MyClass"; +echo $classname::constant . "\n"; // PHP 5.3.0ä¹å + +$class = new MyClass(); +$class->showConstant(); + +echo $class::constant."\n"; // PHP 5.3.0ä¹å +?> +]]> + </programlisting> + </example> + + <example> + <title>éææ°æ®ç¤ºä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +class foo { + // PHP 5.3.0ä¹å + const bar = <<<'EOT' +bar +EOT; +} +?> +]]> + </programlisting> + <para> + åheredocsï¼å符串边ç符ï¼ä¸åï¼nowdocså¯ä»¥ç¨å¨ä»»ä½éææ°æ®ä¸ã + </para> + </example> + <note> + <para> + PHP 5.3.0èµ·PHPæ¯æNowdocåè½ã + </para> + </note> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/final.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/final.xml diff -u /dev/null phpdoc-zh/language/oop5/final.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/final.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook"> + <title>Finalå ³é®å</title> + <para> + PHP 5 æ°å¢äºä¸ä¸ª final å ³é®åã妿ç¶ç±»ä¸çæ¹æ³è¢«å£°æä¸ºfinalï¼ååç±»æ æ³è¦çè¯¥æ¹æ³ï¼ + 妿ä¸ä¸ªç±»è¢«å£°æä¸ºfinalï¼åä¸è½è¢«ç»§æ¿ã + </para> + + <example> + <title>Final æ¹æ³ç¤ºä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +class BaseClass { + public function test() { + echo "BaseClass::test() called\n"; + } + + final public function moreTesting() { + echo "BaseClass::moreTesting() called\n"; + } +} + +class ChildClass extends BaseClass { + public function moreTesting() { + echo "ChildClass::moreTesting() called\n"; + } +} +// 产ç Fatal error: Cannot override final method BaseClass::moreTesting() +?> +]]> + </programlisting> + </example> + + <example> + <title>Final 类示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +final class BaseClass { + public function test() { + echo "BaseClass::test() called\n"; + } + + // è¿éæ è®ºä½ æ¯å¦å°æ¹æ³å£°æä¸ºfinalï¼é½æ²¡æå ³ç³» + final public function moreTesting() { + echo "BaseClass::moreTesting() called\n"; + } +} + +class ChildClass extends BaseClass { +} +// 产ç Fatal error: Class ChildClass may not inherit from final class (BaseClass) +?> +]]> + </programlisting> + </example> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/interfaces.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/interfaces.xml diff -u /dev/null phpdoc-zh/language/oop5/interfaces.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/interfaces.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,221 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.14 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook"> + <title>æ¥å£</title> + <para> + ä½¿ç¨æ¥å£ï¼interfaceï¼ï¼ä½ å¯ä»¥æå®æä¸ªç±»å¿ é¡»å®ç°åªäºæ¹æ³ï¼ä½ä¸éè¦å®ä¹è¿äºæ¹æ³çå ·ä½å 容ã + </para> + <para> + æä»¬å¯ä»¥éè¿interfaceæ¥å®ä¹ä¸ä¸ªæ¥å£ï¼å°±åå®ä¹ä¸ä¸ªæ åçç±»ä¸æ ·ï¼ä½å ¶ä¸å®ä¹ææçæ¹æ³é½æ¯ç©ºçã + </para> + <para> + æ¥å£ä¸å®ä¹çæææ¹æ³é½å¿ é¡»æ¯publicï¼è¿æ¯æ¥å£çç¹æ§ã + </para> + <sect2 xml:id="language.oop5.interfaces.implements"> + <title><literal>å®ç°</literal></title> + <para> + è¦å®ç°ä¸ä¸ªæ¥å£ï¼å¯ä»¥ä½¿ç¨<literal>implements</literal>æä½ç¬¦ãç±»ä¸å¿ é¡»å®ç°æ¥å£ä¸å®ä¹çæææ¹æ³ï¼å¦å + 伿¥ä¸ä¸ªfatalé误ã妿è¦å®ç°å¤ä¸ªæ¥å£ï¼å¯ä»¥ç¨éå·æ¥åéå¤ä¸ªæ¥å£çåç§°ã + </para> + <note> + <para> + å®ç°å¤ä¸ªæ¥å£æ¶ï¼æ¥å£ä¸çæ¹æ³ä¸è½æéåã + </para> + </note> + <note> + <para> + æ¥å£ä¹å¯ä»¥ç»§æ¿ï¼éè¿ä½¿ç¨<literal>extends</literal>æä½ç¬¦ã + </para> + </note> + </sect2> + <sect2 xml:id="language.oop5.interfaces.constants"> + <title><literal>常é</literal></title> + <para> + æ¥å£ä¸ä¹å¯ä»¥å®ä¹å¸¸éãæ¥å£å¸¸éå<link linkend="language.oop5.constants">类常é</link>ç使ç¨å®å ¨ç¸åã + å®ä»¬é½æ¯å®å¼ï¼ä¸è½è¢«åç±»æåæ¥å£ä¿®æ¹ã + </para> + </sect2> + <sect2 xml:id="language.oop5.interfaces.examples"> + &reftitle.examples; + <example xml:id="language.oop5.interfaces.examples.ex1"> + <title>æ¥å£ä»£ç 示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// 声æä¸ä¸ª'iTemplate'æ¥å£ +interface iTemplate +{ + public function setVariable($name, $var); + public function getHtml($template); +} + + +// å®ç°æ¥å£ +// ä¸é¢çåæ³æ¯æ£ç¡®ç +class Template implements iTemplate +{ + private $vars = array(); + + public function setVariable($name, $var) + { + $this->vars[$name] = $var; + } + + public function getHtml($template) + { + foreach($this->vars as $name => $value) { + $template = str_replace('{' . $name . '}', $value, $template); + } + + return $template; + } +} + +// ä¸é¢çåæ³æ¯é误çï¼ä¼æ¥éï¼ +// Fatal error: Class BadTemplate contains 1 abstract methods +// and must therefore be declared abstract (iTemplate::getHtml) +class BadTemplate implements iTemplate +{ + private $vars = array(); + + public function setVariable($name, $var) + { + $this->vars[$name] = $var; + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex2"> + <title>Extendable Interfaces</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + public function foo(); +} + +interface b extends a +{ + public function baz(Baz $baz); +} + +// æ£ç¡®åæ³ +class c implements b +{ + public function foo() + { + } + + public function baz(Baz $baz) + { + } +} + +// éè¯¯åæ³ä¼å¯¼è´ä¸ä¸ªfatal error +class d implements b +{ + public function foo() + { + } + + public function baz(Foo $foo) + { + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex3"> + <title>å¤ä¸ªæ¥å£é´çç»§æ¿</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + public function foo(); +} + +interface b +{ + public function bar(); +} + +interface c extends a, b +{ + public function baz(); +} + +class d implements c +{ + public function foo() + { + } + + public function bar() + { + } + + public function baz() + { + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex4"> + <title>ä½¿ç¨æ¥å£å¸¸é</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + const b = 'Interface constant'; +} + +// è¾åºæ¥å£å¸¸é +echo a::b; + +// éè¯¯åæ³ï¼å 为常éçå¼ä¸è½è¢«ä¿®æ¹ãæ¥å£å¸¸éçæ¦å¿µåç±»å¸¸éæ¯ä¸æ ·çã +class b implements a +{ + const b = 'Class constant'; +} +?> +]]> + </programlisting> + </example> + <simpara> + ä½ ä¹å¯ä»¥çç<link linkend="language.operators.type">instanceof</link>å ³é®åçææ¡£ã + </simpara> + </sect2> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/iterations.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/iterations.xml diff -u /dev/null phpdoc-zh/language/oop5/iterations.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/iterations.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,258 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.13 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.iterations" xmlns="http://docbook.org/ns/docbook"> + <title>对象è¿ä»£</title> + <para> + + PHP 5 provides a way for objects to be defined so it is possible to iterate + through a list of items, with, for example a <link + linkend="control-structures.foreach">foreach</link> statement. By default, + all <link linkend="language.oop5.visibility">visible</link> properties will be used + for the iteration. + + PHP5æä¾äºä¸ç§è¿ä»£ï¼iterationï¼å¯¹è±¡çåè½ï¼å°±åä½¿ç¨æ°ç»é£æ ·ï¼å¯ä»¥éè¿<link linkend="control-structures.foreach">foreach</link> + æ¥éå对象ä¸ç屿§ãé»è®¤æ åµä¸ï¼å¨å¤é¨è¿ä»£åªè½å¾å°å¤é¨å¯è§ç屿§çå¼ã + </para> + + <example> + <title>ç®åç对象è¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyClass +{ + public $var1 = 'value 1'; + public $var2 = 'value 2'; + public $var3 = 'value 3'; + + protected $protected = 'protected var'; + private $private = 'private var'; + + function iterateVisible() { + echo "MyClass::iterateVisible:\n"; + foreach($this as $key => $value) { + print "$key => $value\n"; + } + } +} + +$class = new MyClass(); + +foreach($class as $key => $value) { + print "$key => $value\n"; +} +echo "\n"; + + +$class->iterateVisible(); + +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +var1 => value 1 +var2 => value 2 +var3 => value 3 + +MyClass::iterateVisible: +var1 => value 1 +var2 => value 2 +var3 => value 3 +protected => protected var +private => private var +]]> + </screen> + + </example> + + <para> + å¦ä¸æç¤º, the <link + linkend="control-structures.foreach">foreach</link> éåäºææ + <link linkend="language.oop5.visibility">å¯è§ç</link> 屿§. ä½ ä¹å¯ä»¥éè¿å®ç°PHP 5èªå¸¦ç + <varname>Iterator</varname>æ¥å£æ¥å®ç°è¿ä»£. 使ç¨Iteratoræ¥å£å¯ä»¥è®©å¯¹è±¡èªè¡å³å®å¦ä½è¿ä»£èªå·²ã + </para> + + <example> + <title>å®ç°Iteratoræ¥å£çè¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyIterator implements Iterator +{ + private $var = array(); + + public function __construct($array) + { + if (is_array($array)) { + $this->var = $array; + } + } + + public function rewind() { + echo "rewinding\n"; + reset($this->var); + } + + public function current() { + $var = current($this->var); + echo "current: $var\n"; + return $var; + } + + public function key() { + $var = key($this->var); + echo "key: $var\n"; + return $var; + } + + public function next() { + $var = next($this->var); + echo "next: $var\n"; + return $var; + } + + public function valid() { + $var = $this->current() !== false; + echo "valid: {$var}\n"; + return $var; + } +} + +$values = array(1,2,3); +$it = new MyIterator($values); + +foreach ($it as $a => $b) { + print "$a: $b\n"; +} +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +rewinding +current: 1 +valid: 1 +current: 1 +key: 0 +0: 1 +next: 2 +current: 2 +valid: 1 +current: 2 +key: 1 +1: 2 +next: 3 +current: 3 +valid: 1 +current: 3 +key: 2 +2: 3 +next: +current: +valid: +]]> + </screen> + + </example> + + <para> + ä½ ä¹å¯ä»¥è®©ç±»å®ç°<varname>IteratorAggregate</varname>æ¥å£ï¼è¿æ ·ä½ ç类就ä¸ç¨å¼ºå¶æ§å°å®ç° + <varname>Iterator</varname>æ¥å£ä¸çæææ¹æ³ã + </para> + + <example> + <title>éè¿IteratorAggregateæ¥å®ç°å¯¹è±¡è¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyCollection implements IteratorAggregate +{ + private $items = array(); + private $count = 0; + + // Required definition of interface IteratorAggregate + public function getIterator() { + return new MyIterator($this->items); + } + + public function add($value) { + $this->items[$this->count++] = $value; + } +} + +$coll = new MyCollection(); +$coll->add('value 1'); +$coll->add('value 2'); +$coll->add('value 3'); + +foreach ($coll as $key => $val) { + echo "key/value: [$key -> $val]\n\n"; +} +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +rewinding +current: value 1 +valid: 1 +current: value 1 +key: 0 +key/value: [0 -> value 1] + +next: value 2 +current: value 2 +valid: 1 +current: value 2 +key: 1 +key/value: [1 -> value 2] + +next: value 3 +current: value 3 +valid: 1 +current: value 3 +key: 2 +key/value: [2 -> value 3] + +next: +current: +valid: +]]> + </screen> + + </example> + + <note> + <para> + 请æ¥ç<link linkend="ref.spl">SPL Extension</link>äºè§£æ´å¤Iteratorç¸å ³ä¿¡æ¯ã + </para> + </note> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/magic.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/magic.xml diff -u /dev/null phpdoc-zh/language/oop5/magic.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/magic.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,215 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.20 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook"> + <title>éæ¯æ¹æ³</title> + <para> + <literal>__construct</literal>, + <literal>__destruct</literal> + (åç <link linkend="language.oop5.decon">æé æ¹æ³åæææ¹æ³</link>), + <literal>__call</literal>, + <literal>__callStatic</literal>, + <literal>__get</literal>, + <literal>__set</literal>, + <literal>__isset</literal>, + <literal>__unset</literal> + (åç <link linkend="language.oop5.overloading">éè½½</link>), + <literal>__sleep</literal>, + <literal>__wakeup</literal>, + <literal>__toString</literal>, + <literal>__set_state</literal> å + <link linkend="language.oop5.cloning">__clone</link> + çæ¹æ³å¨PHPä¸è¢«ç§°ä¸ºâéæ¯æ¹æ³âï¼Magic methodsï¼ã ä½ å¨å½åèªå·±çç±»æ¹æ³æ¶ä¸è½ä½¿ç¨è¿äºæ¹æ³åã + </para> + + <caution> + <simpara> + PHPæææä»¥__ï¼ä¸¤ä¸ªä¸å线ï¼å¼å¤´çç±»æ¹æ³å½æéæ¯æ¹æ³ãæä»¥ä½ å®ä¹èªå·±çç±»æ¹æ³æ¶ï¼ä¸è¦ä»¥ + __为åç¼ã + </simpara> + </caution> + + <sect2 xml:id="language.oop5.magic.sleep"> + <title><literal>__sleep</literal> å <literal>__wakeup</literal></title> + <para> + <function>serialize</function> 彿°ä¼æ£æ¥æ¯å¦åå¨ä¸ä¸ªéæ¯æ¹æ³ <literal>__sleep</literal>.妿åå¨ï¼__sleep()æ¹æ³ä¼å 被è°ç¨ï¼ + ç¶åææ§è¡åºååæä½ãè¿ä¸ªåè½å¯ä»¥ç¨äºæ¸ ç对象ï¼å¹¶è¿åä¸ä¸ªå å«å¯¹è±¡ä¸ææåéåç§°çæ°ç»ãå¦æè¯¥æ¹æ³ä¸è¿åä»»ä½å 容ï¼å&null;被åºååï¼å¯¼è´ + ä¸ä¸ªE_NOTICEé误ã + </para> + <para> + <literal>__sleep</literal>æ¹æ³å¸¸ç¨äºæäº¤æªæäº¤çæ°æ®ï¼æç±»ä¼¼çæä½ãåæ¶ï¼å¦æä½ æä¸äºå¾å¤§çå¯¹è±¡ï¼ +ä¸éè¦ä¿åï¼è¿ä¸ªåè½å°±å¾å¥½ç¨ã + + </para> + <para> + ä¸ä¹ç¸åï¼<function>unserialize</function>伿£æ¥æ¯å¦åå¨ä¸ä¸ª<literal>__wakeup</literal>æ¹æ³ã妿åå¨ï¼åä¼å è°ç¨ +<literal>__wakeup</literal>æ¹æ³ï¼é¢å åå¤å¯¹è±¡æ°æ®ã + </para> + <para> + <literal>__wakeup</literal>ç»å¸¸ç¨å¨ååºååæä½ä¸ï¼ä¾å¦éæ°å»ºç«æ°æ®åºè¿æ¥ï¼ææ§è¡å ¶å®åå§åæä½ã + </para> + <example> + <title>Sleep å wakeup</title> + <programlisting role="php"> +<![CDATA[ +<?php +class Connection { + protected $link; + private $server, $username, $password, $db; + + public function __construct($server, $username, $password, $db) + { + $this->server = $server; + $this->username = $username; + $this->password = $password; + $this->db = $db; + $this->connect(); + } + + private function connect() + { + $this->link = mysql_connect($this->server, $this->username, $this->password); + mysql_select_db($this->db, $this->link); + } + + public function __sleep() + { + return array('server', 'username', 'password', 'db'); + } + + public function __wakeup() + { + $this->connect(); + } +} +?> +]]> + </programlisting> + </example> + </sect2> + + <sect2 xml:id="language.oop5.magic.tostring"> + <title><literal>__toString</literal></title> + <para> + The <literal>__toString</literal> method allows a class to decide + how it will react when it is converted to a string. + + <literal>__toString</literal> æ¹æ³å¯ä»¥è®©ä¸ä¸ªç±»å³å®å®å¦ä½è½¬æ¢æä¸ä¸ªå符串ã + </para> + <example> + <title>ç®å示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Declare a simple class +class TestClass +{ + public $foo; + + public function __construct($foo) { + $this->foo = $foo; + } + + public function __toString() { + return $this->foo; + } +} + +$class = new TestClass('Hello'); +echo $class; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Hello +]]> + </screen> + </example> + <para> + å¨PHP 5.2.0ä¹åï¼<literal>__toString</literal>æ¹æ³åªæç»å使ç¨<function>echo</function> æ <function>print</function>æ¶ +æè½çæãPHP 5.2.0ä¹åï¼åå¯ä»¥å¨ä»»ä½å符串ç¯å¢çæï¼ä¾å¦éè¿<function>printf</function>ï¼ä½¿ç¨<literal>%s</literal>修饰符ï¼ï¼ä½ +ä¸è½ç¨äºéå符串ç¯å¢ï¼å¦ä½¿ç¨<literal>%d</literal>修饰符ï¼ãä»PHP 5.2.0ï¼å¦æå°ä¸ä¸ªæªå®ä¹<literal>__toString</literal>æ¹æ³ç对象 +转æ¢ä¸ºå符串ï¼ä¼æ¥åºä¸ä¸ª<constant>E_RECOVERABLE_ERROR</constant>é误ã + + </para> + </sect2> + + <sect2 xml:id="language.oop5.magic.set-state"> + <title><literal>__set_state</literal></title> + <para> + å½è°ç¨<function>var_export</function>æ¶ï¼è¿ä¸ª<link linkend="language.oop5.static">éæ</link> æ¹æ³ä¼è¢«è°ç¨ï¼èªPHP 5.1.0èµ·ææï¼ã + </para> + <para> + æ¬æ¹æ³çå¯ä¸åæ°æ¯ä¸ä¸ªæ°ç»ï¼å ¶ä¸å 嫿<literal>array('property' => value, ...)</literal>æ ¼å¼æåçç±»å±æ§ã + </para> + <example> + <title>Using <literal>__set_state</literal> (PHP 5.1.0åæ´é«çæ¬æ¯æ)</title> + <programlisting role="php"> +<![CDATA[ +<?php + +class A +{ + public $var1; + public $var2; + + public static function __set_state($an_array) // As of PHP 5.1.0 + { + $obj = new A; + $obj->var1 = $an_array['var1']; + $obj->var2 = $an_array['var2']; + return $obj; + } +} + +$a = new A; +$a->var1 = 5; +$a->var2 = 'foo'; + +eval('$b = ' . var_export($a, true) . ';'); // $b = A::__set_state(array( + // 'var1' => 5, + // 'var2' => 'foo', + // )); +var_dump($b); + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +object(A)#2 (2) { + ["var1"]=> + int(5) + ["var2"]=> + string(3) "foo" +} +]]> + </screen> + </example> + </sect2> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/object-comparison.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/object-comparison.xml diff -u /dev/null phpdoc-zh/language/oop5/object-comparison.xml:1.4 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/object-comparison.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,125 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.4 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook"> + <title>对象æ¯è¾</title> + <para> + PHP5ä¸ç对象æ¯è¾ï¼object comparisonï¼è¦æ¯PHP4ä¸å¤æï¼ä¹æ¯å ¶å®ä¸è¬çé¢å对象è¯è¨å¤æã + </para> + <para> + å½ä½¿ç¨å¯¹æ¯æä½ç¬¦(<literal>==</literal>)æ¯è¾ä¸¤ä¸ªå¯¹è±¡åéæ¶ï¼æ¯è¾çå忝ï¼å¦æä¸¤ä¸ªå¯¹è±¡ç屿§å屿§å¼ + é½ç¸çï¼èä¸ä¸¤ä¸ªå¯¹è±¡æ¯åä¸ä¸ªç±»çå®ä¾ï¼é£ä¹è¿ä¸¤ä¸ªå¯¹è±¡åéç¸çã + </para> + <para> + èå¦æä½¿ç¨å ¨çæä½ç¬¦(<literal>===</literal>)ï¼è¿ä¸¤ä¸ªå¯¹è±¡åéä¸å®è¦æåæä¸ªç±»çåä¸ä¸ªå®ä¾ï¼å³åä¸ä¸ªå¯¹è±¡ï¼ã + </para> + <para> + éè¿ä¸é¢ç示ä¾ä½ å¯ä»¥ç解以ä¸ååã + <example> + <title>PHP 5ç对象æ¯è¾</title> + <programlisting role='php'> +<![CDATA[ +<?php +function bool2str($bool) +{ + if ($bool === false) { + return 'FALSE'; + } else { + return 'TRUE'; + } +} + +function compareObjects(&$o1, &$o2) +{ + echo 'o1 == o2 : ' . bool2str($o1 == $o2) . "\n"; + echo 'o1 != o2 : ' . bool2str($o1 != $o2) . "\n"; + echo 'o1 === o2 : ' . bool2str($o1 === $o2) . "\n"; + echo 'o1 !== o2 : ' . bool2str($o1 !== $o2) . "\n"; +} + +class Flag +{ + public $flag; + + function Flag($flag = true) { + $this->flag = $flag; + } +} + +class OtherFlag +{ + public $flag; + + function OtherFlag($flag = true) { + $this->flag = $flag; + } +} + +$o = new Flag(); +$p = new Flag(); +$q = $o; +$r = new OtherFlag(); + +echo "Two instances of the same class\n"; +compareObjects($o, $p); + +echo "\nTwo references to the same instance\n"; +compareObjects($o, $q); + +echo "\nInstances of two different classes\n"; +compareObjects($o, $r); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Two instances of the same class +o1 == o2 : TRUE +o1 != o2 : FALSE +o1 === o2 : FALSE +o1 !== o2 : TRUE + +Two references to the same instance +o1 == o2 : TRUE +o1 != o2 : FALSE +o1 === o2 : TRUE +o1 !== o2 : FALSE + +Instances of two different classes +o1 == o2 : FALSE +o1 != o2 : TRUE +o1 === o2 : FALSE +o1 !== o2 : TRUE +]]> + </screen> +</example> +</para> +<note> +<para> +PHPæ©å±ä¸å¯ä»¥èªè¡å®ä¹å¯¹è±¡æ¯è¾çååã +</para> +</note> +</sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/overloading.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/overloading.xml diff -u /dev/null phpdoc-zh/language/oop5/overloading.xml:1.4 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/overloading.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,315 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.4 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.32 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook"> + <title>éè½½</title> + + <para> + PHPææä¾ç<quote>éè½½</quote>ï¼overloadingï¼æ¯æå¨æå°<quote>å建</quote>ç±»å±æ§åæ¹æ³ãæä»¬æ¯éè¿ + éæ¯æ¹æ³ï¼magic methodsï¼æ¥å®ç°çã + </para> + + <para> + å½è°ç¨å½åç¯å¢ä¸æªå®ä¹æä¸å¯è§çç±»å±æ§ææ¹æ³æ¶ï¼éè½½æ¹æ³ä¼è¢«è°ç¨ãæ¬èåé¢å°ä½¿ç¨ + <quote>ä¸å¯è®¿é®æåï¼inaccessible membersï¼</quote>å<quote>ä¸å¯è®¿é®æ¹æ³ï¼inaccessible + methodsï¼</quote>æ¥ç§°å¼è¿äºæªå®ä¹æä¸å¯è§çç±»å±æ§ææ¹æ³ã + </para> + + <para> + ææçéè½½æ¹æ³é½å¿ 须被声æä¸º<literal>public</literal>ã + </para> + + <note> + <para> + è¿äºéæ¯æ¹æ³çåæ°é½ä¸è½ <link linkend="functions.arguments.by-reference">éè¿å¼ç¨ä¼ é</link>ã + </para> + </note> + + <note> + <para> + PHPä¸ç<quote>éè½½</quote>ä¸å ¶å®ç»å¤§å¤æ°é¢å对象è¯è¨ä¸åãä¼ ç»ç<quote>éè½½</quote>æ¯ç¨äºæä¾å¤ä¸ªååç + ç±»æ¹æ³ï¼ä½åæ¹æ³çåæ°ç±»åå个æ°ä¸åã + </para> + </note> + + + <sect2 xml:id="language.oop5.overloading.changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + æ°å¢ <literal>__isset()</literal> å <literal>__unset()</literal>ä¸¤ä¸ªéæ¯æ¹æ³. + </entry> + </row> + <row> + <entry>5.3.0</entry> + <entry> + æ°å¢ <literal>__callStatic()</literal>éæ¯æ¹æ³. + å¯è§æ§æªè®¾ç½®ä¸ºpublicææªå£°æä¸ºstaticçæ¶åä¼äº§çä¸ä¸ªè¦å + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </sect2> + + + <sect2 xml:id="language.oop5.overloading.members"> + <title>屿§éè½½</title> + + <methodsynopsis> + <type>void</type><methodname>__set</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>__get</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>__isset</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>__unset</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + + <para> + å¨ç»æªå®ä¹çåéèµå¼æ¶ï¼<literal>__set()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + è¯»åæªå®ä¹çåéç弿¶ï¼<literal>__get()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¯¹æªå®ä¹çåéè°ç¨<function>isset</function> æ <function>empty</function>æ¶ï¼<literal>__isset()</literal> + ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¯¹æªå®ä¹çåéè°ç¨<function>unset</function>æ¶ï¼<literal>__unset()</literal> + ä¼è¢«è°ç¨ã + </para> + + <para> + The <varname>$name</varname> argument is the name of the + member being interacted with. The <literal>__set()</literal> + method's <varname>$value</varname> argument specifies the + value the <varname>$name</varname>'ed member should be set + to. + + åæ°<varname>$name</varname>æ¯æè¦æä½çåéåç§°ã<literal>__set()</literal> + æ¹æ³ç<varname>$value</varname> åæ°æå®äº<varname>$name</varname>åéçå¼ã + </para> + + <para> + 屿§éè½½åªè½å¨å¯¹è±¡ä¸è¿è¡ãå¨éææ¹æ³ä¸ï¼è¿äºéæ¯æ¹æ³å°ä¸ä¼è¢«è°ç¨ãæä»¥è¿äºæ¹æ³é½ä¸è½è¢« + 声æä¸º<link linkend="language.oop5.static">static</link>ã + </para> + + <example> + <title>使ç¨__get, __set, __isset å __unset è¿è¡éè½½</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MemberTest { + /** 被éè½½çæ°æ®ä¿å卿¤ */ + private $data = array(); + + + /** éè½½ä¸è½è¢«ç¨å¨å·²ç»å®ä¹ç屿§ */ + public $declared = 1; + + /** åªæä»ç±»å¤é¨è®¿é®è¿ä¸ªå±æ§æ¶ï¼éè½½æä¼åç */ + private $hidden = 2; + + public function __set($name, $value) { + echo "Setting '$name' to '$value'\n"; + $this->data[$name] = $value; + } + + public function __get($name) { + echo "Getting '$name'\n"; + if (array_key_exists($name, $this->data)) { + return $this->data[$name]; + } + + $trace = debug_backtrace(); + trigger_error( + 'Undefined property via __get(): ' . $name . + ' in ' . $trace[0]['file'] . + ' on line ' . $trace[0]['line'], + E_USER_NOTICE); + return null; + } + + /** PHP 5.1.0ä¹åçæ¬ */ + public function __isset($name) { + echo "Is '$name' set?\n"; + return isset($this->data[$name]); + } + + /** PHP 5.1.0ä¹åçæ¬ */ + public function __unset($name) { + echo "Unsetting '$name'\n"; + unset($this->data[$name]); + } + + /** ééæ¯æ¹æ³ */ + public function getHidden() { + return $this->hidden; + } +} + + +echo "<pre>\n"; + +$obj = new MemberTest; + +$obj->a = 1; +echo $obj->a . "\n\n"; + +var_dump(isset($obj->a)); +unset($obj->a); +var_dump(isset($obj->a)); +echo "\n"; + +echo $obj->declared . "\n\n"; + +echo "Let's experiment with the private property named 'hidden':\n"; +echo "Privates are visible inside the class, so __get() not used...\n"; +echo $obj->getHidden() . "\n"; +echo "Privates not visible outside of class, so __get() is used...\n"; +echo $obj->hidden . "\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Setting 'a' to '1' +Getting 'a' +1 + +Is 'a' set? +bool(true) +Unsetting 'a' +Is 'a' set? +bool(false) + +1 + +Let's experiment with the private property named 'hidden': +Privates are visible inside the class, so __get() not used... +2 +Privates not visible outside of class, so __get() is used... +Getting 'hidden' + + +Notice: Undefined property via __get(): hidden in <file> on line 70 in <file> on line 29 +]]> + </screen> + + </example> + </sect2> + + <sect2 xml:id="language.oop5.overloading.methods"> + <title>æ¹æ³éè½½</title> + + <methodsynopsis> + <type>mixed</type><methodname>__call</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>array</type><parameter>arguments</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>__callStatic</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>array</type><parameter>arguments</parameter></methodparam> + </methodsynopsis> + + <para> + å½è°ç¨ä¸ä¸ªä¸å¯è®¿é®æ¹æ³ï¼å¦æªå®ä¹ï¼æè ä¸å¯è§ï¼æ¶ï¼<literal>__call()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¨éææ¹æ³ä¸è°ç¨ä¸ä¸ªä¸å¯è®¿é®æ¹æ³ï¼å¦æªå®ä¹ï¼æè ä¸å¯è§ï¼æ¶ï¼<literal>__callStatic()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> +<varname>$name</varname>åæ°æ¯è¦è°ç¨çæ¹æ³åç§°ã<varname>$arguments</varname>åæ°æ¯ä¸ä¸ªæ°ç»ï¼å å«çè¦ä¼ éç»æ¹æ³çåæ°ã + </para> + + <example> + <title>ä½¿ç¨ __call å ___callStatic è°ç¨å¯¹è±¡ä¸çæ¹æ³</title> + <programlisting role="php"> + <![CDATA[ +<?php +class MethodTest { + public function __call($name, $arguments) { + // 注æ: $name åºå大å°å + echo "Calling object method '$name' " + . implode(', ', $arguments). "\n"; + } + + /** PHP 5.3.0ä¹åçæ¬ */ + public static function __callStatic($name, $arguments) { + // Note: value of $name is case sensitive. + echo "Calling static method '$name' " + . implode(', ', $arguments). "\n"; + } +} + +$obj = new MethodTest; +$obj->runTest('in object context'); + +MethodTest::runTest('in static context'); // PHP 5.3.0ä¹åçæ¬ +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Calling object method 'runTest' in object context +Calling static method 'runTest' in static context +]]> + </screen> + </example> + + </sect2> + + </sect1> + +<!-- 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 +-->
http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/abstract.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/abstract.xml diff -u /dev/null phpdoc-zh/language/oop5/abstract.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/abstract.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,103 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.15 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.abstract" xmlns="http://docbook.org/ns/docbook"> + <title>æ½è±¡ç±»</title> + + <para> + PHP5æ¯ææ½è±¡ç±»åæ½è±¡æ¹æ³ãæ½è±¡ç±»ä¸è½ç´æ¥è¢«å®ä¾åï¼ä½ å¿ é¡»å ç»§æ¿è¯¥æ½è±¡ç±»ï¼ç¶ååå®ä¾ååç±»ãæ½è±¡ç±»ä¸ + è³å°è¦å å«ä¸ä¸ªæ½è±¡æ¹æ³ãå¦æç±»æ¹æ³è¢«å£°æä¸ºæ½è±¡çï¼é£ä¹å ¶ä¸å°±ä¸è½å æ¬å ·ä½çåè½å®ç°ã + </para> + + <para> + ç»§æ¿ä¸ä¸ªæ½è±¡ç±»çæ¶åï¼åç±»å¿ é¡»å®ç°æ½è±¡ç±»ä¸çæææ½è±¡æ¹æ³ï¼å¦å¤ï¼è¿äºæ¹æ³ç<link linkend="language.oop5.visibility">å¯è§æ§</link> + å¿ é¡»åæ½è±¡ç±»ä¸ä¸æ ·ï¼æè æ´ä¸ºå®½æ¾ï¼ã妿æ½è±¡ç±»ä¸æä¸ªæ½è±¡æ¹æ³è¢«å£°æä¸ºprotectedï¼é£ä¹åç±»ä¸å®ç°çæ¹æ³å°±åºè¯¥å£°æä¸ºprotectedæè publicï¼èä¸ + è½å®ä¹ä¸ºprivateã + </para> + + <example> + <title>æ½è±¡ç±»ä»£ç 示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +abstract class AbstractClass +{ + // 强å¶è¦æ±åç±»å®ä¹è¿äºæ¹æ³ + abstract protected function getValue(); + abstract protected function prefixValue($prefix); + + // æ®éæ¹æ³ï¼éæ½è±¡æ¹æ³ï¼ + public function printOut() { + print $this->getValue() . "\n"; + } +} + +class ConcreteClass1 extends AbstractClass +{ + protected function getValue() { + return "ConcreteClass1"; + } + + public function prefixValue($prefix) { + return "{$prefix}ConcreteClass1"; + } +} + +class ConcreteClass2 extends AbstractClass +{ + public function getValue() { + return "ConcreteClass2"; + } + + public function prefixValue($prefix) { + return "{$prefix}ConcreteClass2"; + } +} + +$class1 = new ConcreteClass1; +$class1->printOut(); +echo $class1->prefixValue('FOO_') ."\n"; + +$class2 = new ConcreteClass2; +$class2->printOut(); +echo $class2->prefixValue('FOO_') ."\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +ConcreteClass1 +FOO_ConcreteClass1 +ConcreteClass2 +FOO_ConcreteClass2 +]]> + </screen> + </example> + + <para> + æ½è±¡ç±»çåç±»ä¸çæ®éæ¹æ³æ§è¡æ¹å¼åå ¶ä»ç±»ç¸åã + </para> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/cloning.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/cloning.xml diff -u /dev/null phpdoc-zh/language/oop5/cloning.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/cloning.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,143 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.cloning" xmlns="http://docbook.org/ns/docbook"> + <title>对象å¤å¶</title> + + <para> + å¨å¤æ°æ åµä¸ï¼æä»¬å¹¶ä¸éè¦å®å ¨å¤å¶ä¸ä¸ªå¯¹è±¡æ¥è·å¾å ¶ä¸å±æ§ã使ä¸ä¸ªæ åµä¸ç¡®å®éè¦ï¼å¦æä½ æä¸ä¸ª + GTKçªå£å¯¹è±¡ï¼è¯¥å¯¹è±¡ææçªå£ç¸å ³çèµæºãä½ å¯è½ä¼æ³å¤å¶ä¸ä¸ªæ°ççªå£ï¼ä¿æææå±æ§ä¸åæ¥ççªå£ç¸åï¼ + ä½å¿ é¡»æ¯ä¸ä¸ªæ°ç对象ï¼å ä¸ºå¦æä¸æ¯æ°ç对象ï¼é£ä¹ä¸ä¸ªçªå£ä¸çæ¹åå°±ä¼å½±åå°å¦ä¸ä¸ªçªå£ï¼ãè¿æä¸ç§æ åµï¼ + å¦æå¯¹è±¡Aä¸ä¿åç对象Bçå¼ç¨ï¼å½ä½ å¤å¶å¯¹è±¡Aæ¶ï¼ä½ æ³å ¶ä¸ä½¿ç¨ç对象ä¸åæ¯å¯¹è±¡Bèæ¯Bçä¸ä¸ªå¯æ¬ï¼é£ä¹ + ä½ å¿ é¡»å¾å°å¯¹è±¡Açä¸ä¸ªå¯æ¬ã + + </para> + + <para> + 对象å¤å¶å¯ä»¥éè¿cloneå ³é®åæ¥å®æï¼å¦æå¯¹è±¡ä¸åå¨__clone()æ¹æ³ï¼ä¼å 被è°ç¨ï¼ã对象ä¸ç + __clone()æ¹æ³ä¸è½ç´æ¥è°ç¨ã + </para> + + <informalexample> + <programlisting> +<![CDATA[ +$copy_of_object = clone $object; +]]> + </programlisting> + </informalexample> + + <para> + å½å¯¹è±¡è¢«å¤å¶åï¼PHP5ä¼å¯¹å¯¹è±¡çææå±æ§æ§è¡ä¸ä¸ªâæµ å¤å¶âï¼shallow copyï¼ãææç屿§ä¸çå¼ç¨ + ä»ç¶ä¸åï¼æå忥çåéã妿å®ä¹äº__clone()æ¹æ³ï¼åæ°å建ç对象ï¼å¤å¶çæç对象ï¼ä¸ç__clone()æ¹æ³ä¼è¢«è°ç¨ï¼ + å¯ç¨äºä¿®æ¹å±æ§çå¼ï¼å¦ææå¿ è¦çè¯ï¼ã + </para> + + <example> + <title>å¤å¶ä¸ä¸ªå¯¹è±¡</title> + <programlisting role="php"> +<![CDATA[ +<?php +class SubObject +{ + static $instances = 0; + public $instance; + + public function __construct() { + $this->instance = ++self::$instances; + } + + public function __clone() { + $this->instance = ++self::$instances; + } +} + +class MyCloneable +{ + public $object1; + public $object2; + + function __clone() + { + + // 强å¶å¤å¶ä¸ä»½this->objectï¼ å¦åä»ç¶æååä¸ä¸ªå¯¹è±¡ + $this->object1 = clone $this->object1; + } +} + +$obj = new MyCloneable(); + +$obj->object1 = new SubObject(); +$obj->object2 = new SubObject(); + +$obj2 = clone $obj; + + +print("Original Object:\n"); +print_r($obj); + +print("Cloned Object:\n"); +print_r($obj2); + +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Original Object: +MyCloneable Object +( + [object1] => SubObject Object + ( + [instance] => 1 + ) + + [object2] => SubObject Object + ( + [instance] => 2 + ) + +) +Cloned Object: +MyCloneable Object +( + [object1] => SubObject Object + ( + [instance] => 3 + ) + + [object2] => SubObject Object + ( + [instance] => 2 + ) + +) +]]> + + </screen> + + </example> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/constants.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/constants.xml diff -u /dev/null phpdoc-zh/language/oop5/constants.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/constants.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.17 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> + <title>类常é</title> + <para> + æä»¬å¯ä»¥å¨ç±»ä¸å®ä¹å¸¸éã常éçå¼å°å§ç»ä¿æä¸åãå¨å®ä¹å使ç¨å¸¸éçæ¶åä¸éè¦ä½¿ç¨<varname>$</varname>符å·ã + </para> + <para> + 常éçå¼å¿ é¡»æ¯ä¸ä¸ªå®å¼ï¼ä¸è½æ¯åéï¼ç±»å±æ§æå ¶å®æä½ï¼å¦å½æ°è°ç¨ï¼çç»æã + </para> + <para> + Its also possible for interfaces to have <literal>constants</literal>. Look at + the <link linkend="language.oop5.interfaces">interface documentation</link> for + examples. + + æ¥å£ï¼interfaceï¼ä¸ä¹å¯ä»¥å®ä¹å¸¸éã请æ¥ç<link linkend="language.oop5.interfaces">æ¥å£çææ¡£</link>è·å¾æ´å¤ç¤ºä¾ã + </para> + <para> + PHP5.3.0ä¹åï¼æä»¬å¯ä»¥ç¨ä¸ä¸ªå鿥卿è°ç¨ç±»ãä½è¯¥åéçå¼ä¸è½ä¸ºå ³é®å<literal>self</literal>, + <literal>parent</literal> æ<literal>static</literal>ã + </para> + <example> + <title>å®ä¹å使ç¨ä¸ä¸ªç±»å¸¸é</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyClass +{ + const constant = 'constant value'; + + function showConstant() { + echo self::constant . "\n"; + } +} + +echo MyClass::constant . "\n"; + +$classname = "MyClass"; +echo $classname::constant . "\n"; // PHP 5.3.0ä¹å + +$class = new MyClass(); +$class->showConstant(); + +echo $class::constant."\n"; // PHP 5.3.0ä¹å +?> +]]> + </programlisting> + </example> + + <example> + <title>éææ°æ®ç¤ºä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +class foo { + // PHP 5.3.0ä¹å + const bar = <<<'EOT' +bar +EOT; +} +?> +]]> + </programlisting> + <para> + åheredocsï¼å符串边ç符ï¼ä¸åï¼nowdocså¯ä»¥ç¨å¨ä»»ä½éææ°æ®ä¸ã + </para> + </example> + <note> + <para> + PHP 5.3.0èµ·PHPæ¯æNowdocåè½ã + </para> + </note> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/final.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/final.xml diff -u /dev/null phpdoc-zh/language/oop5/final.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/final.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook"> + <title>Finalå ³é®å</title> + <para> + PHP 5 æ°å¢äºä¸ä¸ª final å ³é®åã妿ç¶ç±»ä¸çæ¹æ³è¢«å£°æä¸ºfinalï¼ååç±»æ æ³è¦çè¯¥æ¹æ³ï¼ + 妿ä¸ä¸ªç±»è¢«å£°æä¸ºfinalï¼åä¸è½è¢«ç»§æ¿ã + </para> + + <example> + <title>Final æ¹æ³ç¤ºä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +class BaseClass { + public function test() { + echo "BaseClass::test() called\n"; + } + + final public function moreTesting() { + echo "BaseClass::moreTesting() called\n"; + } +} + +class ChildClass extends BaseClass { + public function moreTesting() { + echo "ChildClass::moreTesting() called\n"; + } +} +// 产ç Fatal error: Cannot override final method BaseClass::moreTesting() +?> +]]> + </programlisting> + </example> + + <example> + <title>Final 类示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +final class BaseClass { + public function test() { + echo "BaseClass::test() called\n"; + } + + // è¿éæ è®ºä½ æ¯å¦å°æ¹æ³å£°æä¸ºfinalï¼é½æ²¡æå ³ç³» + final public function moreTesting() { + echo "BaseClass::moreTesting() called\n"; + } +} + +class ChildClass extends BaseClass { +} +// 产ç Fatal error: Class ChildClass may not inherit from final class (BaseClass) +?> +]]> + </programlisting> + </example> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/interfaces.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/interfaces.xml diff -u /dev/null phpdoc-zh/language/oop5/interfaces.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/interfaces.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,221 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.14 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook"> + <title>æ¥å£</title> + <para> + ä½¿ç¨æ¥å£ï¼interfaceï¼ï¼ä½ å¯ä»¥æå®æä¸ªç±»å¿ é¡»å®ç°åªäºæ¹æ³ï¼ä½ä¸éè¦å®ä¹è¿äºæ¹æ³çå ·ä½å 容ã + </para> + <para> + æä»¬å¯ä»¥éè¿interfaceæ¥å®ä¹ä¸ä¸ªæ¥å£ï¼å°±åå®ä¹ä¸ä¸ªæ åçç±»ä¸æ ·ï¼ä½å ¶ä¸å®ä¹ææçæ¹æ³é½æ¯ç©ºçã + </para> + <para> + æ¥å£ä¸å®ä¹çæææ¹æ³é½å¿ é¡»æ¯publicï¼è¿æ¯æ¥å£çç¹æ§ã + </para> + <sect2 xml:id="language.oop5.interfaces.implements"> + <title><literal>å®ç°</literal></title> + <para> + è¦å®ç°ä¸ä¸ªæ¥å£ï¼å¯ä»¥ä½¿ç¨<literal>implements</literal>æä½ç¬¦ãç±»ä¸å¿ é¡»å®ç°æ¥å£ä¸å®ä¹çæææ¹æ³ï¼å¦å + 伿¥ä¸ä¸ªfatalé误ã妿è¦å®ç°å¤ä¸ªæ¥å£ï¼å¯ä»¥ç¨éå·æ¥åéå¤ä¸ªæ¥å£çåç§°ã + </para> + <note> + <para> + å®ç°å¤ä¸ªæ¥å£æ¶ï¼æ¥å£ä¸çæ¹æ³ä¸è½æéåã + </para> + </note> + <note> + <para> + æ¥å£ä¹å¯ä»¥ç»§æ¿ï¼éè¿ä½¿ç¨<literal>extends</literal>æä½ç¬¦ã + </para> + </note> + </sect2> + <sect2 xml:id="language.oop5.interfaces.constants"> + <title><literal>常é</literal></title> + <para> + æ¥å£ä¸ä¹å¯ä»¥å®ä¹å¸¸éãæ¥å£å¸¸éå<link linkend="language.oop5.constants">类常é</link>ç使ç¨å®å ¨ç¸åã + å®ä»¬é½æ¯å®å¼ï¼ä¸è½è¢«åç±»æåæ¥å£ä¿®æ¹ã + </para> + </sect2> + <sect2 xml:id="language.oop5.interfaces.examples"> + &reftitle.examples; + <example xml:id="language.oop5.interfaces.examples.ex1"> + <title>æ¥å£ä»£ç 示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// 声æä¸ä¸ª'iTemplate'æ¥å£ +interface iTemplate +{ + public function setVariable($name, $var); + public function getHtml($template); +} + + +// å®ç°æ¥å£ +// ä¸é¢çåæ³æ¯æ£ç¡®ç +class Template implements iTemplate +{ + private $vars = array(); + + public function setVariable($name, $var) + { + $this->vars[$name] = $var; + } + + public function getHtml($template) + { + foreach($this->vars as $name => $value) { + $template = str_replace('{' . $name . '}', $value, $template); + } + + return $template; + } +} + +// ä¸é¢çåæ³æ¯é误çï¼ä¼æ¥éï¼ +// Fatal error: Class BadTemplate contains 1 abstract methods +// and must therefore be declared abstract (iTemplate::getHtml) +class BadTemplate implements iTemplate +{ + private $vars = array(); + + public function setVariable($name, $var) + { + $this->vars[$name] = $var; + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex2"> + <title>Extendable Interfaces</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + public function foo(); +} + +interface b extends a +{ + public function baz(Baz $baz); +} + +// æ£ç¡®åæ³ +class c implements b +{ + public function foo() + { + } + + public function baz(Baz $baz) + { + } +} + +// éè¯¯åæ³ä¼å¯¼è´ä¸ä¸ªfatal error +class d implements b +{ + public function foo() + { + } + + public function baz(Foo $foo) + { + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex3"> + <title>å¤ä¸ªæ¥å£é´çç»§æ¿</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + public function foo(); +} + +interface b +{ + public function bar(); +} + +interface c extends a, b +{ + public function baz(); +} + +class d implements c +{ + public function foo() + { + } + + public function bar() + { + } + + public function baz() + { + } +} +?> +]]> + </programlisting> + </example> + <example xml:id="language.oop5.interfaces.examples.ex4"> + <title>ä½¿ç¨æ¥å£å¸¸é</title> + <programlisting role="php"> +<![CDATA[ +<?php +interface a +{ + const b = 'Interface constant'; +} + +// è¾åºæ¥å£å¸¸é +echo a::b; + +// éè¯¯åæ³ï¼å 为常éçå¼ä¸è½è¢«ä¿®æ¹ãæ¥å£å¸¸éçæ¦å¿µåç±»å¸¸éæ¯ä¸æ ·çã +class b implements a +{ + const b = 'Class constant'; +} +?> +]]> + </programlisting> + </example> + <simpara> + ä½ ä¹å¯ä»¥çç<link linkend="language.operators.type">instanceof</link>å ³é®åçææ¡£ã + </simpara> + </sect2> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/iterations.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/iterations.xml diff -u /dev/null phpdoc-zh/language/oop5/iterations.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/iterations.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,258 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.13 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.iterations" xmlns="http://docbook.org/ns/docbook"> + <title>对象è¿ä»£</title> + <para> + + PHP 5 provides a way for objects to be defined so it is possible to iterate + through a list of items, with, for example a <link + linkend="control-structures.foreach">foreach</link> statement. By default, + all <link linkend="language.oop5.visibility">visible</link> properties will be used + for the iteration. + + PHP5æä¾äºä¸ç§è¿ä»£ï¼iterationï¼å¯¹è±¡çåè½ï¼å°±åä½¿ç¨æ°ç»é£æ ·ï¼å¯ä»¥éè¿<link linkend="control-structures.foreach">foreach</link> + æ¥éå对象ä¸ç屿§ãé»è®¤æ åµä¸ï¼å¨å¤é¨è¿ä»£åªè½å¾å°å¤é¨å¯è§ç屿§çå¼ã + </para> + + <example> + <title>ç®åç对象è¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyClass +{ + public $var1 = 'value 1'; + public $var2 = 'value 2'; + public $var3 = 'value 3'; + + protected $protected = 'protected var'; + private $private = 'private var'; + + function iterateVisible() { + echo "MyClass::iterateVisible:\n"; + foreach($this as $key => $value) { + print "$key => $value\n"; + } + } +} + +$class = new MyClass(); + +foreach($class as $key => $value) { + print "$key => $value\n"; +} +echo "\n"; + + +$class->iterateVisible(); + +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +var1 => value 1 +var2 => value 2 +var3 => value 3 + +MyClass::iterateVisible: +var1 => value 1 +var2 => value 2 +var3 => value 3 +protected => protected var +private => private var +]]> + </screen> + + </example> + + <para> + å¦ä¸æç¤º, the <link + linkend="control-structures.foreach">foreach</link> éåäºææ + <link linkend="language.oop5.visibility">å¯è§ç</link> 屿§. ä½ ä¹å¯ä»¥éè¿å®ç°PHP 5èªå¸¦ç + <varname>Iterator</varname>æ¥å£æ¥å®ç°è¿ä»£. 使ç¨Iteratoræ¥å£å¯ä»¥è®©å¯¹è±¡èªè¡å³å®å¦ä½è¿ä»£èªå·²ã + </para> + + <example> + <title>å®ç°Iteratoræ¥å£çè¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyIterator implements Iterator +{ + private $var = array(); + + public function __construct($array) + { + if (is_array($array)) { + $this->var = $array; + } + } + + public function rewind() { + echo "rewinding\n"; + reset($this->var); + } + + public function current() { + $var = current($this->var); + echo "current: $var\n"; + return $var; + } + + public function key() { + $var = key($this->var); + echo "key: $var\n"; + return $var; + } + + public function next() { + $var = next($this->var); + echo "next: $var\n"; + return $var; + } + + public function valid() { + $var = $this->current() !== false; + echo "valid: {$var}\n"; + return $var; + } +} + +$values = array(1,2,3); +$it = new MyIterator($values); + +foreach ($it as $a => $b) { + print "$a: $b\n"; +} +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +rewinding +current: 1 +valid: 1 +current: 1 +key: 0 +0: 1 +next: 2 +current: 2 +valid: 1 +current: 2 +key: 1 +1: 2 +next: 3 +current: 3 +valid: 1 +current: 3 +key: 2 +2: 3 +next: +current: +valid: +]]> + </screen> + + </example> + + <para> + ä½ ä¹å¯ä»¥è®©ç±»å®ç°<varname>IteratorAggregate</varname>æ¥å£ï¼è¿æ ·ä½ ç类就ä¸ç¨å¼ºå¶æ§å°å®ç° + <varname>Iterator</varname>æ¥å£ä¸çæææ¹æ³ã + </para> + + <example> + <title>éè¿IteratorAggregateæ¥å®ç°å¯¹è±¡è¿ä»£</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MyCollection implements IteratorAggregate +{ + private $items = array(); + private $count = 0; + + // Required definition of interface IteratorAggregate + public function getIterator() { + return new MyIterator($this->items); + } + + public function add($value) { + $this->items[$this->count++] = $value; + } +} + +$coll = new MyCollection(); +$coll->add('value 1'); +$coll->add('value 2'); +$coll->add('value 3'); + +foreach ($coll as $key => $val) { + echo "key/value: [$key -> $val]\n\n"; +} +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +rewinding +current: value 1 +valid: 1 +current: value 1 +key: 0 +key/value: [0 -> value 1] + +next: value 2 +current: value 2 +valid: 1 +current: value 2 +key: 1 +key/value: [1 -> value 2] + +next: value 3 +current: value 3 +valid: 1 +current: value 3 +key: 2 +key/value: [2 -> value 3] + +next: +current: +valid: +]]> + </screen> + + </example> + + <note> + <para> + 请æ¥ç<link linkend="ref.spl">SPL Extension</link>äºè§£æ´å¤Iteratorç¸å ³ä¿¡æ¯ã + </para> + </note> + + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/magic.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-zh/language/oop5/magic.xml diff -u /dev/null phpdoc-zh/language/oop5/magic.xml:1.3 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/magic.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,215 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.3 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.20 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook"> + <title>éæ¯æ¹æ³</title> + <para> + <literal>__construct</literal>, + <literal>__destruct</literal> + (åç <link linkend="language.oop5.decon">æé æ¹æ³åæææ¹æ³</link>), + <literal>__call</literal>, + <literal>__callStatic</literal>, + <literal>__get</literal>, + <literal>__set</literal>, + <literal>__isset</literal>, + <literal>__unset</literal> + (åç <link linkend="language.oop5.overloading">éè½½</link>), + <literal>__sleep</literal>, + <literal>__wakeup</literal>, + <literal>__toString</literal>, + <literal>__set_state</literal> å + <link linkend="language.oop5.cloning">__clone</link> + çæ¹æ³å¨PHPä¸è¢«ç§°ä¸ºâéæ¯æ¹æ³âï¼Magic methodsï¼ã ä½ å¨å½åèªå·±çç±»æ¹æ³æ¶ä¸è½ä½¿ç¨è¿äºæ¹æ³åã + </para> + + <caution> + <simpara> + PHPæææä»¥__ï¼ä¸¤ä¸ªä¸å线ï¼å¼å¤´çç±»æ¹æ³å½æéæ¯æ¹æ³ãæä»¥ä½ å®ä¹èªå·±çç±»æ¹æ³æ¶ï¼ä¸è¦ä»¥ + __为åç¼ã + </simpara> + </caution> + + <sect2 xml:id="language.oop5.magic.sleep"> + <title><literal>__sleep</literal> å <literal>__wakeup</literal></title> + <para> + <function>serialize</function> 彿°ä¼æ£æ¥æ¯å¦åå¨ä¸ä¸ªéæ¯æ¹æ³ <literal>__sleep</literal>.妿åå¨ï¼__sleep()æ¹æ³ä¼å 被è°ç¨ï¼ + ç¶åææ§è¡åºååæä½ãè¿ä¸ªåè½å¯ä»¥ç¨äºæ¸ ç对象ï¼å¹¶è¿åä¸ä¸ªå å«å¯¹è±¡ä¸ææåéåç§°çæ°ç»ãå¦æè¯¥æ¹æ³ä¸è¿åä»»ä½å 容ï¼å&null;被åºååï¼å¯¼è´ + ä¸ä¸ªE_NOTICEé误ã + </para> + <para> + <literal>__sleep</literal>æ¹æ³å¸¸ç¨äºæäº¤æªæäº¤çæ°æ®ï¼æç±»ä¼¼çæä½ãåæ¶ï¼å¦æä½ æä¸äºå¾å¤§çå¯¹è±¡ï¼ +ä¸éè¦ä¿åï¼è¿ä¸ªåè½å°±å¾å¥½ç¨ã + + </para> + <para> + ä¸ä¹ç¸åï¼<function>unserialize</function>伿£æ¥æ¯å¦åå¨ä¸ä¸ª<literal>__wakeup</literal>æ¹æ³ã妿åå¨ï¼åä¼å è°ç¨ +<literal>__wakeup</literal>æ¹æ³ï¼é¢å åå¤å¯¹è±¡æ°æ®ã + </para> + <para> + <literal>__wakeup</literal>ç»å¸¸ç¨å¨ååºååæä½ä¸ï¼ä¾å¦éæ°å»ºç«æ°æ®åºè¿æ¥ï¼ææ§è¡å ¶å®åå§åæä½ã + </para> + <example> + <title>Sleep å wakeup</title> + <programlisting role="php"> +<![CDATA[ +<?php +class Connection { + protected $link; + private $server, $username, $password, $db; + + public function __construct($server, $username, $password, $db) + { + $this->server = $server; + $this->username = $username; + $this->password = $password; + $this->db = $db; + $this->connect(); + } + + private function connect() + { + $this->link = mysql_connect($this->server, $this->username, $this->password); + mysql_select_db($this->db, $this->link); + } + + public function __sleep() + { + return array('server', 'username', 'password', 'db'); + } + + public function __wakeup() + { + $this->connect(); + } +} +?> +]]> + </programlisting> + </example> + </sect2> + + <sect2 xml:id="language.oop5.magic.tostring"> + <title><literal>__toString</literal></title> + <para> + The <literal>__toString</literal> method allows a class to decide + how it will react when it is converted to a string. + + <literal>__toString</literal> æ¹æ³å¯ä»¥è®©ä¸ä¸ªç±»å³å®å®å¦ä½è½¬æ¢æä¸ä¸ªå符串ã + </para> + <example> + <title>ç®å示ä¾</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Declare a simple class +class TestClass +{ + public $foo; + + public function __construct($foo) { + $this->foo = $foo; + } + + public function __toString() { + return $this->foo; + } +} + +$class = new TestClass('Hello'); +echo $class; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Hello +]]> + </screen> + </example> + <para> + å¨PHP 5.2.0ä¹åï¼<literal>__toString</literal>æ¹æ³åªæç»å使ç¨<function>echo</function> æ <function>print</function>æ¶ +æè½çæãPHP 5.2.0ä¹åï¼åå¯ä»¥å¨ä»»ä½å符串ç¯å¢çæï¼ä¾å¦éè¿<function>printf</function>ï¼ä½¿ç¨<literal>%s</literal>修饰符ï¼ï¼ä½ +ä¸è½ç¨äºéå符串ç¯å¢ï¼å¦ä½¿ç¨<literal>%d</literal>修饰符ï¼ãä»PHP 5.2.0ï¼å¦æå°ä¸ä¸ªæªå®ä¹<literal>__toString</literal>æ¹æ³ç对象 +转æ¢ä¸ºå符串ï¼ä¼æ¥åºä¸ä¸ª<constant>E_RECOVERABLE_ERROR</constant>é误ã + + </para> + </sect2> + + <sect2 xml:id="language.oop5.magic.set-state"> + <title><literal>__set_state</literal></title> + <para> + å½è°ç¨<function>var_export</function>æ¶ï¼è¿ä¸ª<link linkend="language.oop5.static">éæ</link> æ¹æ³ä¼è¢«è°ç¨ï¼èªPHP 5.1.0èµ·ææï¼ã + </para> + <para> + æ¬æ¹æ³çå¯ä¸åæ°æ¯ä¸ä¸ªæ°ç»ï¼å ¶ä¸å 嫿<literal>array('property' => value, ...)</literal>æ ¼å¼æåçç±»å±æ§ã + </para> + <example> + <title>Using <literal>__set_state</literal> (PHP 5.1.0åæ´é«çæ¬æ¯æ)</title> + <programlisting role="php"> +<![CDATA[ +<?php + +class A +{ + public $var1; + public $var2; + + public static function __set_state($an_array) // As of PHP 5.1.0 + { + $obj = new A; + $obj->var1 = $an_array['var1']; + $obj->var2 = $an_array['var2']; + return $obj; + } +} + +$a = new A; +$a->var1 = 5; +$a->var2 = 'foo'; + +eval('$b = ' . var_export($a, true) . ';'); // $b = A::__set_state(array( + // 'var1' => 5, + // 'var2' => 'foo', + // )); +var_dump($b); + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +object(A)#2 (2) { + ["var1"]=> + int(5) + ["var2"]=> + string(3) "foo" +} +]]> + </screen> + </example> + </sect2> + </sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/object-comparison.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/object-comparison.xml diff -u /dev/null phpdoc-zh/language/oop5/object-comparison.xml:1.4 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/object-comparison.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,125 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.4 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.6 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook"> + <title>对象æ¯è¾</title> + <para> + PHP5ä¸ç对象æ¯è¾ï¼object comparisonï¼è¦æ¯PHP4ä¸å¤æï¼ä¹æ¯å ¶å®ä¸è¬çé¢å对象è¯è¨å¤æã + </para> + <para> + å½ä½¿ç¨å¯¹æ¯æä½ç¬¦(<literal>==</literal>)æ¯è¾ä¸¤ä¸ªå¯¹è±¡åéæ¶ï¼æ¯è¾çå忝ï¼å¦æä¸¤ä¸ªå¯¹è±¡ç屿§å屿§å¼ + é½ç¸çï¼èä¸ä¸¤ä¸ªå¯¹è±¡æ¯åä¸ä¸ªç±»çå®ä¾ï¼é£ä¹è¿ä¸¤ä¸ªå¯¹è±¡åéç¸çã + </para> + <para> + èå¦æä½¿ç¨å ¨çæä½ç¬¦(<literal>===</literal>)ï¼è¿ä¸¤ä¸ªå¯¹è±¡åéä¸å®è¦æåæä¸ªç±»çåä¸ä¸ªå®ä¾ï¼å³åä¸ä¸ªå¯¹è±¡ï¼ã + </para> + <para> + éè¿ä¸é¢ç示ä¾ä½ å¯ä»¥ç解以ä¸ååã + <example> + <title>PHP 5ç对象æ¯è¾</title> + <programlisting role='php'> +<![CDATA[ +<?php +function bool2str($bool) +{ + if ($bool === false) { + return 'FALSE'; + } else { + return 'TRUE'; + } +} + +function compareObjects(&$o1, &$o2) +{ + echo 'o1 == o2 : ' . bool2str($o1 == $o2) . "\n"; + echo 'o1 != o2 : ' . bool2str($o1 != $o2) . "\n"; + echo 'o1 === o2 : ' . bool2str($o1 === $o2) . "\n"; + echo 'o1 !== o2 : ' . bool2str($o1 !== $o2) . "\n"; +} + +class Flag +{ + public $flag; + + function Flag($flag = true) { + $this->flag = $flag; + } +} + +class OtherFlag +{ + public $flag; + + function OtherFlag($flag = true) { + $this->flag = $flag; + } +} + +$o = new Flag(); +$p = new Flag(); +$q = $o; +$r = new OtherFlag(); + +echo "Two instances of the same class\n"; +compareObjects($o, $p); + +echo "\nTwo references to the same instance\n"; +compareObjects($o, $q); + +echo "\nInstances of two different classes\n"; +compareObjects($o, $r); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Two instances of the same class +o1 == o2 : TRUE +o1 != o2 : FALSE +o1 === o2 : FALSE +o1 !== o2 : TRUE + +Two references to the same instance +o1 == o2 : TRUE +o1 != o2 : FALSE +o1 === o2 : TRUE +o1 !== o2 : FALSE + +Instances of two different classes +o1 == o2 : FALSE +o1 != o2 : TRUE +o1 === o2 : FALSE +o1 !== o2 : TRUE +]]> + </screen> +</example> +</para> +<note> +<para> +PHPæ©å±ä¸å¯ä»¥èªè¡å®ä¹å¯¹è±¡æ¯è¾çååã +</para> +</note> +</sect1> + +<!-- 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 +--> http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/oop5/overloading.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-zh/language/oop5/overloading.xml diff -u /dev/null phpdoc-zh/language/oop5/overloading.xml:1.4 --- /dev/null Sat Dec 13 03:45:30 2008 +++ phpdoc-zh/language/oop5/overloading.xml Sat Dec 13 03:45:30 2008 @@ -0,0 +1,315 @@ +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.4 $ --> +<!-- $Author: haohappy $ --> +<!-- EN-Revision: 1.32 Maintainer: haohappy Status: ready --> + <sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook"> + <title>éè½½</title> + + <para> + PHPææä¾ç<quote>éè½½</quote>ï¼overloadingï¼æ¯æå¨æå°<quote>å建</quote>ç±»å±æ§åæ¹æ³ãæä»¬æ¯éè¿ + éæ¯æ¹æ³ï¼magic methodsï¼æ¥å®ç°çã + </para> + + <para> + å½è°ç¨å½åç¯å¢ä¸æªå®ä¹æä¸å¯è§çç±»å±æ§ææ¹æ³æ¶ï¼éè½½æ¹æ³ä¼è¢«è°ç¨ãæ¬èåé¢å°ä½¿ç¨ + <quote>ä¸å¯è®¿é®æåï¼inaccessible membersï¼</quote>å<quote>ä¸å¯è®¿é®æ¹æ³ï¼inaccessible + methodsï¼</quote>æ¥ç§°å¼è¿äºæªå®ä¹æä¸å¯è§çç±»å±æ§ææ¹æ³ã + </para> + + <para> + ææçéè½½æ¹æ³é½å¿ 须被声æä¸º<literal>public</literal>ã + </para> + + <note> + <para> + è¿äºéæ¯æ¹æ³çåæ°é½ä¸è½ <link linkend="functions.arguments.by-reference">éè¿å¼ç¨ä¼ é</link>ã + </para> + </note> + + <note> + <para> + PHPä¸ç<quote>éè½½</quote>ä¸å ¶å®ç»å¤§å¤æ°é¢å对象è¯è¨ä¸åãä¼ ç»ç<quote>éè½½</quote>æ¯ç¨äºæä¾å¤ä¸ªååç + ç±»æ¹æ³ï¼ä½åæ¹æ³çåæ°ç±»åå个æ°ä¸åã + </para> + </note> + + + <sect2 xml:id="language.oop5.overloading.changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + æ°å¢ <literal>__isset()</literal> å <literal>__unset()</literal>ä¸¤ä¸ªéæ¯æ¹æ³. + </entry> + </row> + <row> + <entry>5.3.0</entry> + <entry> + æ°å¢ <literal>__callStatic()</literal>éæ¯æ¹æ³. + å¯è§æ§æªè®¾ç½®ä¸ºpublicææªå£°æä¸ºstaticçæ¶åä¼äº§çä¸ä¸ªè¦å + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </sect2> + + + <sect2 xml:id="language.oop5.overloading.members"> + <title>屿§éè½½</title> + + <methodsynopsis> + <type>void</type><methodname>__set</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>__get</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>__isset</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>__unset</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + </methodsynopsis> + + <para> + å¨ç»æªå®ä¹çåéèµå¼æ¶ï¼<literal>__set()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + è¯»åæªå®ä¹çåéç弿¶ï¼<literal>__get()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¯¹æªå®ä¹çåéè°ç¨<function>isset</function> æ <function>empty</function>æ¶ï¼<literal>__isset()</literal> + ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¯¹æªå®ä¹çåéè°ç¨<function>unset</function>æ¶ï¼<literal>__unset()</literal> + ä¼è¢«è°ç¨ã + </para> + + <para> + The <varname>$name</varname> argument is the name of the + member being interacted with. The <literal>__set()</literal> + method's <varname>$value</varname> argument specifies the + value the <varname>$name</varname>'ed member should be set + to. + + åæ°<varname>$name</varname>æ¯æè¦æä½çåéåç§°ã<literal>__set()</literal> + æ¹æ³ç<varname>$value</varname> åæ°æå®äº<varname>$name</varname>åéçå¼ã + </para> + + <para> + 屿§éè½½åªè½å¨å¯¹è±¡ä¸è¿è¡ãå¨éææ¹æ³ä¸ï¼è¿äºéæ¯æ¹æ³å°ä¸ä¼è¢«è°ç¨ãæä»¥è¿äºæ¹æ³é½ä¸è½è¢« + 声æä¸º<link linkend="language.oop5.static">static</link>ã + </para> + + <example> + <title>使ç¨__get, __set, __isset å __unset è¿è¡éè½½</title> + <programlisting role="php"> +<![CDATA[ +<?php +class MemberTest { + /** 被éè½½çæ°æ®ä¿å卿¤ */ + private $data = array(); + + + /** éè½½ä¸è½è¢«ç¨å¨å·²ç»å®ä¹ç屿§ */ + public $declared = 1; + + /** åªæä»ç±»å¤é¨è®¿é®è¿ä¸ªå±æ§æ¶ï¼éè½½æä¼åç */ + private $hidden = 2; + + public function __set($name, $value) { + echo "Setting '$name' to '$value'\n"; + $this->data[$name] = $value; + } + + public function __get($name) { + echo "Getting '$name'\n"; + if (array_key_exists($name, $this->data)) { + return $this->data[$name]; + } + + $trace = debug_backtrace(); + trigger_error( + 'Undefined property via __get(): ' . $name . + ' in ' . $trace[0]['file'] . + ' on line ' . $trace[0]['line'], + E_USER_NOTICE); + return null; + } + + /** PHP 5.1.0ä¹åçæ¬ */ + public function __isset($name) { + echo "Is '$name' set?\n"; + return isset($this->data[$name]); + } + + /** PHP 5.1.0ä¹åçæ¬ */ + public function __unset($name) { + echo "Unsetting '$name'\n"; + unset($this->data[$name]); + } + + /** ééæ¯æ¹æ³ */ + public function getHidden() { + return $this->hidden; + } +} + + +echo "<pre>\n"; + +$obj = new MemberTest; + +$obj->a = 1; +echo $obj->a . "\n\n"; + +var_dump(isset($obj->a)); +unset($obj->a); +var_dump(isset($obj->a)); +echo "\n"; + +echo $obj->declared . "\n\n"; + +echo "Let's experiment with the private property named 'hidden':\n"; +echo "Privates are visible inside the class, so __get() not used...\n"; +echo $obj->getHidden() . "\n"; +echo "Privates not visible outside of class, so __get() is used...\n"; +echo $obj->hidden . "\n"; +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Setting 'a' to '1' +Getting 'a' +1 + +Is 'a' set? +bool(true) +Unsetting 'a' +Is 'a' set? +bool(false) + +1 + +Let's experiment with the private property named 'hidden': +Privates are visible inside the class, so __get() not used... +2 +Privates not visible outside of class, so __get() is used... +Getting 'hidden' + + +Notice: Undefined property via __get(): hidden in <file> on line 70 in <file> on line 29 +]]> + </screen> + + </example> + </sect2> + + <sect2 xml:id="language.oop5.overloading.methods"> + <title>æ¹æ³éè½½</title> + + <methodsynopsis> + <type>mixed</type><methodname>__call</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>array</type><parameter>arguments</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>__callStatic</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>array</type><parameter>arguments</parameter></methodparam> + </methodsynopsis> + + <para> + å½è°ç¨ä¸ä¸ªä¸å¯è®¿é®æ¹æ³ï¼å¦æªå®ä¹ï¼æè ä¸å¯è§ï¼æ¶ï¼<literal>__call()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> + å½å¨éææ¹æ³ä¸è°ç¨ä¸ä¸ªä¸å¯è®¿é®æ¹æ³ï¼å¦æªå®ä¹ï¼æè ä¸å¯è§ï¼æ¶ï¼<literal>__callStatic()</literal> ä¼è¢«è°ç¨ã + </para> + + <para> +<varname>$name</varname>åæ°æ¯è¦è°ç¨çæ¹æ³åç§°ã<varname>$arguments</varname>åæ°æ¯ä¸ä¸ªæ°ç»ï¼å å«çè¦ä¼ éç»æ¹æ³çåæ°ã + </para> + + <example> + <title>ä½¿ç¨ __call å ___callStatic è°ç¨å¯¹è±¡ä¸çæ¹æ³</title> + <programlisting role="php"> + <![CDATA[ +<?php +class MethodTest { + public function __call($name, $arguments) { + // 注æ: $name åºå大å°å + echo "Calling object method '$name' " + . implode(', ', $arguments). "\n"; + } + + /** PHP 5.3.0ä¹åçæ¬ */ + public static function __callStatic($name, $arguments) { + // Note: value of $name is case sensitive. + echo "Calling static method '$name' " + . implode(', ', $arguments). "\n"; + } +} + +$obj = new MethodTest; +$obj->runTest('in object context'); + +MethodTest::runTest('in static context'); // PHP 5.3.0ä¹åçæ¬ +?> +]]> + </programlisting> + &example.outputs; + <screen role="php"> +<![CDATA[ +Calling object method 'runTest' in object context +Calling static method 'runTest' in static context +]]> + </screen> + </example> + + </sect2> + + </sect1> + +<!-- 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 +-->