cvs: phpdoc /en/language/oop5 constants.xml paamayim-nekudotayim.xml static.xml
| From: | Etienne Kneuss | 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>