<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Duplicates a closure with a specific bound object and class scope</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="closure.construct.html">Closure::__construct</a></div>
<div class="next" style="text-align: right; float: right;"><a href="closure.bindto.html">Closure::bindTo</a></div>
<div class="up"><a href="class.closure.html">Closure</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="closure.bind" class="refentry">
<div class="refnamediv">
<h1 class="refname">Closure::bind</h1>
<p class="verinfo">(PHP 5 >= 5.4.0, PHP 7)</p><p class="refpurpose"><span class="refname">Closure::bind</span> — <span class="dc-title">
Duplicates a closure with a specific bound object and class scope
</span></p>
</div>
<div class="refsect1 description" id="refsect1-closure.bind-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="modifier">static</span> <span class="type"><a href="class.closure.html" class="type Closure">Closure</a></span> <span class="methodname"><strong>Closure::bind</strong></span>
( <span class="methodparam"><span class="type"><a href="class.closure.html" class="type Closure">Closure</a></span> <code class="parameter">$closure</code></span>
, <span class="methodparam"><span class="type">object</span> <code class="parameter">$newthis</code></span>
[, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$newscope</code>
<span class="initializer"> = "static"</span></span>
] )</div>
<p class="para rdfs-comment">
This method is a static version of <span class="methodname"><a href="closure.bindto.html" class="methodname">Closure::bindTo()</a></span>.
See the documentation of that method for more information.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-closure.bind-parameters">
<h3 class="title">Parameters</h3>
<dl>
<dt>
<code class="parameter">closure</code></dt>
<dd>
<p class="para">
The anonymous functions to bind.
</p>
</dd>
<dt>
<code class="parameter">newthis</code></dt>
<dd>
<p class="para">
The object to which the given anonymous function should be bound, or
<strong><code>NULL</code></strong> for the closure to be unbound.
</p>
</dd>
<dt>
<code class="parameter">newscope</code></dt>
<dd>
<p class="para">
The class scope to which associate the closure is to be associated, or
'static' to keep the current one. If an object is given, the type of the
object will be used instead. This determines the visibility of protected
and private methods of the bound object.
It is not allowed to pass (an object of) an internal class as this parameter.
</p>
</dd>
</dl>
</div>
<div class="refsect1 returnvalues" id="refsect1-closure.bind-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns a new <a href="class.closure.html" class="classname">Closure</a> object or <strong><code>FALSE</code></strong> on failure
</p>
</div>
<div class="refsect1 changelog" id="refsect1-closure.bind-changelog">
<h3 class="title">Changelog</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>Version</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>7.0.0</td>
<td>
<code class="parameter">newscope</code> can not be (an object of) an internal
class anymore, what was possible prior to this version.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-closure.bind-examples">
<h3 class="title">Examples</h3>
<div class="example" id="errorexception.example.error-handler">
<p><strong>Example #1 <span class="function"><strong>Closure::bind()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A </span><span style="color: #007700">{<br /> private static </span><span style="color: #0000BB">$sfoo </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /> private </span><span style="color: #0000BB">$ifoo </span><span style="color: #007700">= </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">$cl1 </span><span style="color: #007700">= static function() {<br /> return </span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">$sfoo</span><span style="color: #007700">;<br />};<br /></span><span style="color: #0000BB">$cl2 </span><span style="color: #007700">= function() {<br /> return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">ifoo</span><span style="color: #007700">;<br />};<br /><br /></span><span style="color: #0000BB">$bcl1 </span><span style="color: #007700">= </span><span style="color: #0000BB">Closure</span><span style="color: #007700">::</span><span style="color: #0000BB">bind</span><span style="color: #007700">(</span><span style="color: #0000BB">$cl1</span><span style="color: #007700">, </span><span style="color: #0000BB">null</span><span style="color: #007700">, </span><span style="color: #DD0000">'A'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$bcl2 </span><span style="color: #007700">= </span><span style="color: #0000BB">Closure</span><span style="color: #007700">::</span><span style="color: #0000BB">bind</span><span style="color: #007700">(</span><span style="color: #0000BB">$cl2</span><span style="color: #007700">, new </span><span style="color: #0000BB">A</span><span style="color: #007700">(), </span><span style="color: #DD0000">'A'</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$bcl1</span><span style="color: #007700">(), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$bcl2</span><span style="color: #007700">(), </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output
something similar to:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
1
2
</pre></div>
</div>
</div>
</div>
<div class="refsect1 seealso" id="refsect1-closure.bind-seealso">
<h3 class="title">See Also</h3>
<ul class="simplelist">
<li class="member"><a href="functions.anonymous.html" class="link">Anonymous functions</a></li>
<li class="member"><span class="methodname"><a href="closure.bindto.html" class="methodname" rel="rdfs-seeAlso">Closure::bindTo()</a> - Duplicates the closure with a new bound object and class scope</span></li>
</ul>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="closure.construct.html">Closure::__construct</a></div>
<div class="next" style="text-align: right; float: right;"><a href="closure.bindto.html">Closure::bindTo</a></div>
<div class="up"><a href="class.closure.html">Closure</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
