<?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.switch.php',
    1 => 'switch',
    2 => 'switch',
  ),
  'up' => 
  array (
    0 => 'language.control-structures.php',
    1 => '制御構造',
  ),
  'prev' => 
  array (
    0 => 'control-structures.continue.php',
    1 => 'continue',
  ),
  'next' => 
  array (
    0 => 'control-structures.match.php',
    1 => 'match',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/control-structures/switch.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="control-structures.switch" class="sect1">
 <h2 class="title">switch</h2>
 <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p>
 <p class="simpara">
  <code class="literal">switch</code>文は、同じ式を用いてIF文を並べたのに似ています。
  同じ変数を異なる値と比較し、値に応じて異なったコードを実行したいと
  思うことがしばしばあるかと思います。
  <code class="literal">switch</code>文は、まさにこのためにあるのです。
 </p>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <span class="simpara">
   他の言語とは違って、
   <a href="control-structures.continue.php" class="link">continue</a>命令は
   <code class="literal">switch</code> にも適用され、<code class="literal">break</code>と同じ動作をします。
   ループの内部で <code class="literal">switch</code> を使用しており、
   外側のループの処理を続行させたい場合には、<code class="literal">continue 2</code>
   を使用してください。
  </span>
 </p></blockquote>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
   switch/case が行うのは、
   <a href="types.comparisons.php#types.comparisions-loose" class="link">緩やかな比較</a>
   であることに注意しましょう。
  </p>
 </p></blockquote>

 <p class="para">
  次の二つの例は、同じことを二つの異なった方法で書いたものです。
  一つは、<code class="literal">if</code> と <code class="literal">elseif</code>文を、
  もう一つは<code class="literal">switch</code>文を使っています。
  どちらも、出力は同じです。
  <div class="example" id="example-1">
   <p><strong>例1 <code class="literal">switch</code> 文の構造</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: #FF8000">// これが switch 文です:<br /><br /></span><span style="color: #007700">switch (</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">0</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは0に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは1に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは2に等しい"</span><span style="color: #007700">;<br />        break;<br />}<br /><br /></span><span style="color: #FF8000">// 上記は、下記と同じです:<br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">$i </span><span style="color: #007700">== </span><span style="color: #0000BB">0</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"iは0に等しい"</span><span style="color: #007700">;<br />} elseif (</span><span style="color: #0000BB">$i </span><span style="color: #007700">== </span><span style="color: #0000BB">1</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"iは1に等しい"</span><span style="color: #007700">;<br />} elseif (</span><span style="color: #0000BB">$i </span><span style="color: #007700">== </span><span style="color: #0000BB">2</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"iは2に等しい"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  失敗を避けるために<code class="literal">switch</code>文がどのように実行されるのかを
  理解することが重要です。
  <code class="literal">switch</code>文は、行毎に実行されます。
  (実際には、文毎に実行されます。)初めは、何も実行しません。
  <code class="literal">switch</code>式の値と同じ値として評価される式を有する
  <code class="literal">case</code>文が見つけられたときに初めてPHPにより
  命令の実行が行われます。
  PHPは<code class="literal">switch</code>ブロックの終わりまたは最初の
  <code class="literal">break</code>文まで実行を続けます。
  CASE文の終わりに<code class="literal">break</code>文を書かない場合は、PHPは
  次のCASE文を実行しつづけます。例えば、
  <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">switch (</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">0</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは0に等しい"</span><span style="color: #007700">;<br />    case </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは1に等しい"</span><span style="color: #007700">;<br />    case </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは2に等しい"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="simpara">
  ここで、<var class="varname">$i</var>が0に等しい場合は、PHPは全ての echo
  文を出力してしまいます!
  <var class="varname">$i</var>が1の場合、PHPは最後の二つの echo 文を出力します。
  <var class="varname">$i</var>が2に等しい場合のみ、&#039;期待した&#039;動作をし、
  &#039;iは2に等しい&#039;と表示します。
  このため (ある種の状況下では、BREAKを付加することを避けたいと
  思うかもしれませんが)、
  <code class="literal">break</code>文を忘れないようにすることが重要です。
 </p>
 <p class="simpara">
  <code class="literal">switch</code>文では、条件は1度だけ評価され、
  その結果が各<code class="literal">case</code>文と比較されます。
  <code class="literal">elseif</code>文では、条件は、再度評価されます。
  使用する条件が単純な比較処理よりも複雑な処理を行ったり、
  重い繰り返し処理を行う場合、<code class="literal">switch</code>の方が
  より処理が速い可能性があります。
 </p>
 <p class="para">
  caseに付随する文は、空とすることが可能です。
  この場合、次のcaseに付随する文に制御が移行します。
  <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">switch (</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">0</span><span style="color: #007700">:<br />    case </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />    case </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは3より小さいですが負ではありません"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">3</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは3です"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  <code class="literal">default</code> は、case 文の特別な場合です。これは他の全ての case
  にマッチしない場合に実行されます。例を以下に示します。
  <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">switch (</span><span style="color: #0000BB">$i</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">0</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは0に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは1に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは2に等しい"</span><span style="color: #007700">;<br />        break;<br />    default:<br />       echo </span><span style="color: #DD0000">"iは0,1,2に等しくない"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    複数の <code class="literal">default</code> を置くと、
    <strong><code><a href="errorfunc.constants.php#constant.e-compile-error">E_COMPILE_ERROR</a></code></strong> エラーが発生します。
   </span>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    技術的には、
    <code class="literal">default</code> は switch 文の中のどの位置でも置くことができます。
    <code class="literal">default</code> は他の case にマッチしなかった場合に使われるものです。
    しかし、規約上は最後に置くのが一番です。
   </span>
  </p></blockquote>
 </p>
 <p class="para">
  どの <code class="literal">case</code> にもマッチせず、
  <code class="literal">default</code> も存在しない場合、
  どのコードも実行されません。これは、
  どの <code class="literal">if</code> 文も true でなかった場合と同じです。
 </p>
 <p class="para">
  case に与える値は、式であっても構いません。
  しかし、式はそれ自体が実行され、
  その結果が switch に与えた値と緩やかに比較されます。
  これは、switch に与える値の複雑な評価には使えないということです。
  たとえば、以下の例を見てみましょう:
  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$target </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$start </span><span style="color: #007700">= </span><span style="color: #0000BB">3</span><span style="color: #007700">;<br />switch (</span><span style="color: #0000BB">$target</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"A"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"B"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">3</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"C"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">4</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"D"</span><span style="color: #007700">;<br />        break;<br />}<br /></span><span style="color: #FF8000">// "B" を出力します。<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  もっと複雑な比較を行うには、
  <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> をswitch文の値として指定するやり方が使えます。
  もしくは、<code class="literal">switch</code>文ではなく、
  <code class="literal">if</code>-<code class="literal">else</code>ブロックが使えます。
  <div class="informalexample">
   <div class="example-contents">
    <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$offset </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$start </span><span style="color: #007700">= </span><span style="color: #0000BB">3</span><span style="color: #007700">;<br />switch (</span><span style="color: #0000BB">true</span><span style="color: #007700">) {<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">$offset </span><span style="color: #007700">=== </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"A"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">$offset </span><span style="color: #007700">=== </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"B"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">$offset </span><span style="color: #007700">=== </span><span style="color: #0000BB">3</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"C"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">$start </span><span style="color: #007700">- </span><span style="color: #0000BB">$offset </span><span style="color: #007700">=== </span><span style="color: #0000BB">4</span><span style="color: #007700">:<br />        print </span><span style="color: #DD0000">"D"</span><span style="color: #007700">;<br />        break;<br />}<br /></span><span style="color: #FF8000">// "B" を出力します。<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  switch文の制御構造に関する別の構文がサポートされています。
  詳細は、<a href="control-structures.alternative-syntax.php" class="link">
  制御構造に関する別の構文</a>を参照ください。
  <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">switch (</span><span style="color: #0000BB">$i</span><span style="color: #007700">):<br />    case </span><span style="color: #0000BB">0</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは0に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">1</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは1に等しい"</span><span style="color: #007700">;<br />        break;<br />    case </span><span style="color: #0000BB">2</span><span style="color: #007700">:<br />        echo </span><span style="color: #DD0000">"iは2に等しい"</span><span style="color: #007700">;<br />        break;<br />    default:<br />        echo </span><span style="color: #DD0000">"iは0でも1でも2でもない"</span><span style="color: #007700">;<br />endswitch;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  case の最後はコロンではなくセミコロンとすることもできます。たとえば次のようになります。
  <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">switch(</span><span style="color: #0000BB">$beer</span><span style="color: #007700">)<br />{<br />    case </span><span style="color: #DD0000">'ツボルグ'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'カールスバーグ'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'ステラ'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'ハイネケン'</span><span style="color: #007700">;<br />        echo </span><span style="color: #DD0000">'いいっすねぇ'</span><span style="color: #007700">;<br />        break;<br />    default;<br />        echo </span><span style="color: #DD0000">'ほかのを選んでみませんか?'</span><span style="color: #007700">;<br />        break;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>

 <div class="sect2">
  <h3 class="title">参考</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="control-structures.match.php" class="link">match</a></li>
   </ul>
  </p>
 </div>
</div><?php manual_footer($setup); ?>