<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.variables.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'language.variables.variable.php',
    1 => '可変変数',
    2 => '可変変数',
  ),
  'up' => 
  array (
    0 => 'language.variables.php',
    1 => '変数',
  ),
  'prev' => 
  array (
    0 => 'language.variables.scope.php',
    1 => '変数のスコープ',
  ),
  'next' => 
  array (
    0 => 'language.variables.external.php',
    1 => '外部から来る変数',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/variables.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.variables.variable" class="sect1">
   <h2 class="title">可変変数</h2>

   <p class="simpara">
    変数名を可変にできると便利なことが時々あります。可変変数では、変数
    名を動的にセットし使用できます。通常の変数は、次のような命令でセッ
    トします。
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #DD0000">'hello'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <p class="simpara">
    可変変数は、変数の値をとり、変数の名前として扱います。上の例では、
    <em>hello</em> は、ドル記号を二つ使用することにより、
    変数の名前として使用することができます。つまり、
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">$</span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #DD0000">'world'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <p class="simpara">
    ここまでで、二つの変数が定義され、PHP シンボルツリーに定義されてい
    ます。これらは、&quot;hello&quot; を値とする<var class="varname">$a</var>と &quot;world&quot;
    を値とする<var class="varname">$hello</var>です。そこで、次の命令
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$a</span><span style="color: #DD0000"> </span><span style="color: #007700">{$</span><span style="color: #0000BB">$a</span><span style="color: #007700">}</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <p class="simpara">
    の出力は、次の命令と全く同じとなります。
   </p>

   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$a</span><span style="color: #DD0000"> </span><span style="color: #0000BB">$hello</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <p class="simpara">
    すなわち、両方共、<span class="computeroutput">hello world</span>を出
    力します。
   </p>

   <p class="simpara">
    可変変数を配列で使用する際には、曖昧さの問題を解決する必要がありま
    す。つまり、<var class="varname">$$a[1]</var>と書いた場合、
    <var class="varname">$a[1]</var>を変数として使用したいのか、
    <var class="varname">$$a</var>を変数とし [1] を変数の添え字としたいのかを、
    パーサーが知る必要があるのです。この曖昧さを解決するには、前者では
    <var class="varname">${$a[1]}</var>とし、後者では
    <var class="varname">${$a}[1]</var>とする構文を用います。
   </p>

   <p class="simpara">
    クラスのプロパティには、可変プロパティ名でアクセスすることができます。
    可変プロパティ名の解決は、呼び出し元のスコープで行われます。
    たとえば <var class="varname">$foo->$bar</var> のようにするとローカルスコープで
    <var class="varname">$bar</var> を調べ、その値を
    <var class="varname">$foo</var> のプロパティ名として使います。
    <var class="varname">$bar</var> が配列へのアクセスであっても同じです。
   </p>

   <p class="simpara">
    波括弧を使って、プロパティ名の区切りを明確にすることもできます。
    これが特に有用なのは、配列が格納されているプロパティにアクセスするときや
    プロパティ名が複数のパーツからなる場合、
    あるいはプロパティ名として無効な文字を含む場合
    (たとえば <span class="function"><a href="function.json-decode.php" class="function">json_decode()</a></span>
    や <a href="book.simplexml.php" class="link">SimpleXML</a> に由来するプロパティ)
    などです。
   </p>

   <p class="para">
    <div class="example" id="example-1">
     <p><strong>例1 可変プロパティの例</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">Foo </span><span style="color: #007700">{<br />    public </span><span style="color: #0000BB">$bar </span><span style="color: #007700">= </span><span style="color: #DD0000">'I am bar.'</span><span style="color: #007700">;<br />    public </span><span style="color: #0000BB">$arr </span><span style="color: #007700">= [</span><span style="color: #DD0000">'I am A.'</span><span style="color: #007700">, </span><span style="color: #DD0000">'I am B.'</span><span style="color: #007700">, </span><span style="color: #DD0000">'I am C.'</span><span style="color: #007700">];<br />    public </span><span style="color: #0000BB">$r   </span><span style="color: #007700">= </span><span style="color: #DD0000">'I am r.'</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">$foo </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$bar </span><span style="color: #007700">= </span><span style="color: #DD0000">'bar'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$baz </span><span style="color: #007700">= [</span><span style="color: #DD0000">'foo'</span><span style="color: #007700">, </span><span style="color: #DD0000">'bar'</span><span style="color: #007700">, </span><span style="color: #DD0000">'baz'</span><span style="color: #007700">, </span><span style="color: #DD0000">'quux'</span><span style="color: #007700">];<br />echo </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">$bar </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;{</span><span style="color: #0000BB">$baz</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]} . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$start </span><span style="color: #007700">= </span><span style="color: #DD0000">'b'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$end   </span><span style="color: #007700">= </span><span style="color: #DD0000">'ar'</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;{</span><span style="color: #0000BB">$start </span><span style="color: #007700">. </span><span style="color: #0000BB">$end</span><span style="color: #007700">} . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= </span><span style="color: #DD0000">'arr'</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;{</span><span style="color: #0000BB">$arr</span><span style="color: #007700">}[</span><span style="color: #0000BB">1</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <div class="example-contents"><p>上の例の出力は以下となります。</p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
I am bar.
I am bar.
I am bar.
I am r.
I am B.
</pre></div>
     </div>
    </div>
   </p>

   <div class="warning"><strong class="warning">警告</strong>
    <p class="simpara">
     関数やクラスメソッドの内部で、可変変数と PHP の
     <a href="language.variables.superglobals.php" class="link">
     スーパーグローバル配列</a> とを組み合わせては使用できないということに注意してください。
     <code class="literal">$this</code> も特別な変数であり、
     動的に参照することはできません。
    </p>
   </div>

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