<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.control-structures.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'control-structures.for.php',
    1 => 'for',
    2 => 'for',
  ),
  'up' => 
  array (
    0 => 'language.control-structures.php',
    1 => '制御構造',
  ),
  'prev' => 
  array (
    0 => 'control-structures.do.while.php',
    1 => 'do-while',
  ),
  'next' => 
  array (
    0 => 'control-structures.foreach.php',
    1 => 'foreach',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/control-structures/for.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="control-structures.for" class="sect1">
 <h2 class="title">for</h2>
 <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p>
 <p class="para">
  <code class="literal">for</code> ループは、PHPで最も複雑なループです。
  <code class="literal">for</code> は、Cのforループと同様に動作します。
  <code class="literal">for</code>ループの構文は、次のようになります。
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
for (式1; 式2; 式3)
    文
</pre></div>
   </div>

  </div>
 </p>
 <p class="simpara">
  最初の式(<var class="varname">式1</var>)は、ループ開始時に無条件に
  評価(実行)されます。
 </p>
 <p class="simpara">
  各繰り返しの開始時に、<var class="varname">式2</var>が評価されます。
  その式の値が<strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>の場合、ループは継続され、括弧
  内の文が実行されます。値が<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>の場合、ループの
  実行は終了します。
 </p>
 <p class="simpara">
  各繰り返しの後、<var class="varname">式3</var>が評価(実行)されます。
 </p>
 <p class="simpara">
  各式は空にすることもできますし、複数の式をカンマで区切って指定することもできます。
  <var class="varname">式2</var> でカンマ区切りの式を使用すると、
  すべての式を評価します。しかし、結果として取得するのは最後の式の結果となります。
  <var class="varname">式2</var> を空にすると、無限実行ループになります
  (PHP は、この状態を C 言語のように暗黙の内に <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> とみなします)。
  この機能は、初心者が想像するよりもずっと便利です。
  <code class="literal">for</code> の式の結果ではなく条件付き
  <a href="control-structures.break.php" class="link"><code class="literal">break</code></a>
  文を使ってループを終了させたくなることもしばしばあります。
 </p>
 <p class="para">
  次の例について考えてみましょう。以下の例はすべて 1 から 10 までの数を表示します。
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
</span><span style="color: #007700">for (</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">; </span><span style="color: #0000BB">$i </span><span style="color: #007700">&lt;= </span><span style="color: #0000BB">10</span><span style="color: #007700">; </span><span style="color: #0000BB">$i</span><span style="color: #007700">++) {
    echo </span><span style="color: #0000BB">$i </span><span style="color: #007700">. </span><span style="color: #DD0000">" "</span><span style="color: #007700">;
}</span></code></pre></div>
   </div>

   <p class="simpara">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
1 2 3 4 5 6 7 8 9 10
</pre></div>
   </div>
  </div>
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
</span><span style="color: #007700">for (</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">; ; </span><span style="color: #0000BB">$i</span><span style="color: #007700">++) {
    if (</span><span style="color: #0000BB">$i </span><span style="color: #007700">&gt; </span><span style="color: #0000BB">10</span><span style="color: #007700">) {
        break;
    }
    echo </span><span style="color: #0000BB">$i </span><span style="color: #007700">. </span><span style="color: #DD0000">" "</span><span style="color: #007700">;
}</span></code></pre></div>
   </div>

   <p class="simpara">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
1 2 3 4 5 6 7 8 9 10
</pre></div>
   </div>
  </div>
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
$i </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;
for (; ; ) {
    if (</span><span style="color: #0000BB">$i </span><span style="color: #007700">&gt; </span><span style="color: #0000BB">10</span><span style="color: #007700">) {
        break;
    }
    echo </span><span style="color: #0000BB">$i </span><span style="color: #007700">. </span><span style="color: #DD0000">" "</span><span style="color: #007700">;
    </span><span style="color: #0000BB">$i</span><span style="color: #007700">++;
}</span></code></pre></div>
   </div>

   <p class="simpara">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
1 2 3 4 5 6 7 8 9 10
</pre></div>
   </div>
  </div>
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
</span><span style="color: #007700">for (</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">$j </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$i </span><span style="color: #007700">&lt;= </span><span style="color: #0000BB">10</span><span style="color: #007700">; </span><span style="color: #0000BB">$j </span><span style="color: #007700">+= </span><span style="color: #0000BB">$i</span><span style="color: #007700">, print </span><span style="color: #0000BB">$i </span><span style="color: #007700">. </span><span style="color: #DD0000">" "</span><span style="color: #007700">, </span><span style="color: #0000BB">$i</span><span style="color: #007700">++);</span></code></pre></div>
   </div>

   <p class="simpara">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
1 2 3 4 5 6 7 8 9 10
</pre></div>
   </div>
  </div>
 </p>
 <p class="simpara">
  もちろん、最初の例(もしくは 4番目の例)が最善であると考えられます。
  しかし、<code class="literal">for</code>ループにおいて空の式を使用できると、
  多くの場合、便利だということに気づかれるかと思います。
 </p>
 <p class="para">
  PHPは、<code class="literal">for</code>ループ用に&quot;コロン構文&quot;もサポートします。
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
for (式1; 式2; 式3):
    文;
    ...
endfor;
</pre></div>
   </div>

  </div>
 </p>
 <p class="simpara">
  <var class="varname">式2</var> と <var class="varname">式3</var> は、繰り返しのたびに評価されます。
  パフォーマンス上の問題を避けるため、ここには単純な式を使うことをお勧めします。
  たとえば、繰り返しの回数があらかじめわかっている場合は、
  <var class="varname">式2</var> で関数をコールするのではなく変数を使うほうがよいでしょう。
 </p>
 <p class="para">
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-non-interactive phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php

$people </span><span style="color: #007700">= [</span><span style="color: #DD0000">'Kalle'</span><span style="color: #007700">, </span><span style="color: #DD0000">'Pierre'</span><span style="color: #007700">];

</span><span style="color: #FF8000">// 悪い例: 繰り返しのたびに関数をコールしている
</span><span style="color: #007700">for(</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$i </span><span style="color: #007700">&lt; </span><span style="color: #0000BB">getIterationCount</span><span style="color: #007700">(</span><span style="color: #0000BB">$people</span><span style="color: #007700">); ++</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {
    </span><span style="color: #0000BB">$people</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">] .= </span><span style="color: #DD0000">' is cool'</span><span style="color: #007700">;
}

</span><span style="color: #FF8000">// よい例: 繰り返しの回数を変数に格納している
</span><span style="color: #007700">for(</span><span style="color: #0000BB">$i </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">, </span><span style="color: #0000BB">$peopleCount </span><span style="color: #007700">= </span><span style="color: #0000BB">getIterationCount</span><span style="color: #007700">(</span><span style="color: #0000BB">$people</span><span style="color: #007700">); </span><span style="color: #0000BB">$i </span><span style="color: #007700">&lt; </span><span style="color: #0000BB">$peopleCount</span><span style="color: #007700">; ++</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {
    </span><span style="color: #0000BB">$people</span><span style="color: #007700">[</span><span style="color: #0000BB">$i</span><span style="color: #007700">] .= </span><span style="color: #DD0000">' is cool'</span><span style="color: #007700">;
}</span></code></pre></div>
   </div>

  </div>
 </p>
 <p class="simpara">
  上の例の最初のループでは、関数が常に同じ値を返すにもかかわらず、
  繰り返しのたびにその関数をコールしています。
  2番目のループのようにその値を変数に格納しておけば、関数のコールは一度で済みます。
  ただし、繰り返しの回数が固定されることには注意してください。
  ループの中で配列を変更した場合、格納した値は配列の新しいサイズを反映しなくなります。
 </p>

 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="simpara">
   配列のサイズは配列自身が保持しています。
   つまり、ビルトイン関数 <span class="function"><a href="function.count.php" class="function">count()</a></span> をコールしても要素を数え上げる必要はなく、
   パフォーマンス上の問題は発生しません。
   ただし、配列全体をたどる <strong><code><a href="array.constants.php#constant.count-recursive">COUNT_RECURSIVE</a></code></strong> を指定した場合は当てはまりません。
   また、<span class="interfacename"><a href="class.countable.php" class="interfacename">Countable</a></span> を実装したオブジェクトに
   <span class="function"><a href="function.count.php" class="function">count()</a></span> を使う場合は、そのコールのコストが高くなる可能性があるため注意が必要です。
  </p>
 </p></blockquote>

 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="simpara">
   配列を反復処理する方法として、<code class="literal">for</code> ループは推奨されません。
   <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a> ループはこの用途のために設計されており、たいていの場合はより便利です。
  </p>
 </p></blockquote>
</div><?php manual_footer($setup); ?>