<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.oop5.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'uk',
  ),
  'this' => 
  array (
    0 => 'language.oop5.paamayim-nekudotayim.php',
    1 => 'Scope Resolution Operator (::)',
    2 => 'Scope Resolution Operator (::)',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Класи та об\'єкти',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.inheritance.php',
    1 => 'Object Inheritance',
  ),
  'next' => 
  array (
    0 => 'language.oop5.static.php',
    1 => 'Static Keyword',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'language/oop5/paamayim-nekudotayim.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.paamayim-nekudotayim" class="sect1">
 <h2 class="title">Scope Resolution Operator (::)</h2>

 <p class="para">
  The Scope Resolution Operator (also called Paamayim Nekudotayim) or in
  simpler terms, the double colon, is a token that allows access to
  a <a href="language.oop5.constants.php" class="link">constant</a>,
  <a href="language.oop5.static.php" class="link">static</a> property,
  or <a href="language.oop5.static.php" class="link">static</a> method
  of a class or one of its parents.
  Moreover, static properties or methods can be overriden via
  <a href="language.oop5.late-static-bindings.php" class="link">late static binding</a>.
 </p>

 <p class="para">
  When referencing these items from outside the class definition, use
  the name of the class.
 </p>

 <p class="para">
  It&#039;s possible to reference the class using a variable.
  The variable&#039;s value can not be a keyword (e.g. <code class="literal">self</code>,
  <code class="literal">parent</code> and <code class="literal">static</code>).
 </p>

 <p class="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&#039;s what the Zend team decided to call it.
  It actually does mean double-colon - in Hebrew!
 </p>

 <div class="example" id="example-1">
  <p><strong>Приклад #1 :: from outside the class definition</strong></p>
  <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">MyClass </span><span style="color: #007700">{<br />    const </span><span style="color: #0000BB">CONST_VALUE </span><span style="color: #007700">= </span><span style="color: #DD0000">'A constant value'</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">$classname </span><span style="color: #007700">= </span><span style="color: #DD0000">'MyClass'</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$classname</span><span style="color: #007700">::</span><span style="color: #0000BB">CONST_VALUE</span><span style="color: #007700">;<br /><br />echo </span><span style="color: #0000BB">MyClass</span><span style="color: #007700">::</span><span style="color: #0000BB">CONST_VALUE</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

 <p class="para">
  Three special keywords <var class="varname">self</var>, <var class="varname">parent</var> and
  <var class="varname">static</var> are used to access properties or methods from inside
  the class definition.
 </p>

 <div class="example" id="example-2">
  <p><strong>Приклад #2 :: from inside the class definition</strong></p>
  <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">MyClass </span><span style="color: #007700">{<br />    const </span><span style="color: #0000BB">CONST_VALUE </span><span style="color: #007700">= </span><span style="color: #DD0000">'A constant value'</span><span style="color: #007700">;<br />}<br /><br />class </span><span style="color: #0000BB">OtherClass </span><span style="color: #007700">extends </span><span style="color: #0000BB">MyClass<br /></span><span style="color: #007700">{<br />    public static </span><span style="color: #0000BB">$my_static </span><span style="color: #007700">= </span><span style="color: #DD0000">'static var'</span><span style="color: #007700">;<br /><br />    public static function </span><span style="color: #0000BB">doubleColon</span><span style="color: #007700">() {<br />        echo </span><span style="color: #0000BB">parent</span><span style="color: #007700">::</span><span style="color: #0000BB">CONST_VALUE </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />        echo </span><span style="color: #0000BB">self</span><span style="color: #007700">::</span><span style="color: #0000BB">$my_static </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">$classname </span><span style="color: #007700">= </span><span style="color: #DD0000">'OtherClass'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$classname</span><span style="color: #007700">::</span><span style="color: #0000BB">doubleColon</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">OtherClass</span><span style="color: #007700">::</span><span style="color: #0000BB">doubleColon</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

 <p class="para">
  When an extending class overrides the parent&#039;s definition of a method,
  PHP will not call the parent&#039;s method. It&#039;s up to the extended class
  on whether or not the parent&#039;s method is called. This also applies to <a href="language.oop5.decon.php" class="link">Constructors and Destructors</a>, <a href="language.oop5.overloading.php" class="link">Overloading</a>, and <a href="language.oop5.magic.php" class="link">Magic</a> method definitions.
 </p>

 <div class="example" id="example-3">
  <p><strong>Приклад #3 Calling a parent&#039;s method</strong></p>
  <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">MyClass<br /></span><span style="color: #007700">{<br />    protected function </span><span style="color: #0000BB">myFunc</span><span style="color: #007700">() {<br />        echo </span><span style="color: #DD0000">"MyClass::myFunc()\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">OtherClass </span><span style="color: #007700">extends </span><span style="color: #0000BB">MyClass<br /></span><span style="color: #007700">{<br />    </span><span style="color: #FF8000">// Override parent's definition<br />    </span><span style="color: #007700">public function </span><span style="color: #0000BB">myFunc</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #FF8000">// But still call the parent function<br />        </span><span style="color: #0000BB">parent</span><span style="color: #007700">::</span><span style="color: #0000BB">myFunc</span><span style="color: #007700">();<br />        echo </span><span style="color: #DD0000">"OtherClass::myFunc()\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">$class </span><span style="color: #007700">= new </span><span style="color: #0000BB">OtherClass</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$class</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">myFunc</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>
 <p class="para">
  See also <a href="language.oop5.basic.php#language.oop5.basic.class.this" class="link">some examples of
  static call trickery</a>.
 </p>

</div><?php manual_footer($setup); ?>