cvs: phpdoc /en/language/oop5 constants.xml paamayim-nekudotayim.xml static.xml

From: Date: Sun, 21 Oct 2007 15:57:09 +0000
Subject: cvs: phpdoc /en/language/oop5 constants.xml paamayim-nekudotayim.xml static.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-254@lists.php.net to get a copy of this message
colder Sun Oct 21 15:57:09 2007 UTC Modified files: /phpdoc/en/language/oop5 constants.xml paamayim-nekudotayim.xml static.xml Log: Document dynamic access of static methods/constants/members http://cvs.php.net/viewvc.cgi/phpdoc/en/language/oop5/constants.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/language/oop5/constants.xml diff -u phpdoc/en/language/oop5/constants.xml:1.10 phpdoc/en/language/oop5/constants.xml:1.11 --- phpdoc/en/language/oop5/constants.xml:1.10 Wed Aug 15 15:41:29 2007 +++ phpdoc/en/language/oop5/constants.xml Sun Oct 21 15:57:09 2007 @@ -1,20 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> <title>Class Constants</title> <para> It is possible to define constant values on a per-class basis remaining the same and unchangeable. Constants differ from normal variables in that you - don't use the <varname>$</varname> symbol to declare or use them. Like - <link linkend="language.oop5.static">static</link> members, constant values - cannot be accessed from an instance of the object (using - <literal>$object::constant</literal>). + don't use the <varname>$</varname> symbol to declare or use them. </para> <para> The value must be a constant expression, not (for example) a variable, a class member, result of a mathematical operation or a function call. </para> + <para> + As of PHP 5.3.0, it's possible to reference the class using a variable. + </para> + <example> <title>Defining and using a constant</title> <programlisting role="php"> @@ -31,9 +32,13 @@ echo MyClass::constant . "\n"; +$classname = "MyClass"; +echo $classname::constant . "\n"; + $class = new MyClass(); $class->showConstant(); -// echo $class::constant; is not allowed + +echo $class::constant."\n"; ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc/en/language/oop5/paamayim-nekudotayim.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/language/oop5/paamayim-nekudotayim.xml diff -u phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.10 phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.11 --- phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.10 Wed Aug 15 15:41:29 2007 +++ phpdoc/en/language/oop5/paamayim-nekudotayim.xml Sun Oct 21 15:57:09 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <sect1 xml:id="language.oop5.paamayim-nekudotayim" xmlns="http://docbook.org/ns/docbook"> <title>Scope Resolution Operator (::)</title> @@ -17,6 +17,10 @@ </para> <para> + As of PHP 5.3.0, it's possible to reference the class using a variable. + </para> + + <para> Paamayim Nekudotayim would, at first, seem like a strange choice for naming a double-colon. However, while writing the Zend Engine 0.5 (which powers PHP 3), that's what the Zend team decided to call it. @@ -32,6 +36,9 @@ const CONST_VALUE = 'A constant value'; } +$classname = 'MyClass'; +echo $classname::CONST_VALUE; + echo MyClass::CONST_VALUE; ?> ]]> @@ -58,6 +65,9 @@ } } +$classname = 'OtherClass'; +echo $classname::doubleColon(); + OtherClass::doubleColon(); ?> ]]> http://cvs.php.net/viewvc.cgi/phpdoc/en/language/oop5/static.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/language/oop5/static.xml diff -u phpdoc/en/language/oop5/static.xml:1.13 phpdoc/en/language/oop5/static.xml:1.14 --- phpdoc/en/language/oop5/static.xml:1.13 Wed Aug 15 15:41:29 2007 +++ phpdoc/en/language/oop5/static.xml Sun Oct 21 15:57:09 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <sect1 xml:id="language.oop5.static" xmlns="http://docbook.org/ns/docbook"> <title>Static Keyword</title> @@ -32,6 +32,10 @@ Calling non-static methods statically generates an E_STRICT level warning. </para> + <para> + As of PHP 5.3.0, it's possible to reference the class using a variable. + </para> + <example> <title>Static member example</title> <programlisting role="php"> @@ -60,7 +64,9 @@ print $foo->staticValue() . "\n"; print $foo->my_static . "\n"; // Undefined "Property" my_static -// $foo::my_static is not possible +print $foo::$my_static . "\n"; +$classname = 'Foo'; +print $classname::$my_static . "\n"; print Bar::$my_static . "\n"; $bar = new Bar(); @@ -82,6 +88,8 @@ } Foo::aStaticMethod(); +$classname = 'Foo'; +$classname::aStaticMethod(); ?> ]]> </programlisting>

« previous php.doc.cvs (#254) next »