<?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 => 'ru',
  ),
  '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' => 'ru',
    '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">continue 2</code> выполнение перейдёт к следующей итерации
   внешнего цикла, если блок <code class="literal">switch</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 /><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 /><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> выполняет
  строку за строкой, или точнее — выражение за выражением.
  В начале никакой код не выполняется. PHP начинает выполнение инструкции случаев,
  только когда находит инструкцию <code class="literal">case</code>, выражение которой
  вычисляется как значение, которое совпадает со значением выражения в инструкции <code class="literal">switch</code>.
  Тогда PHP или продолжает выполнять инструкции случаев до конца блока <code class="literal">switch</code>,
  даже если значение случая не совпадает со значением инструкции switch,
  или пока не увидит первую инструкцию <code class="literal">break</code>.
  PHP продолжит выполнять инструкции следующих случаев,
  если в конце списка инструкций случая не записали инструкцию <code class="literal">break</code>.
  Приведём пример:
  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<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 />    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 /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="simpara">
  PHP выполнит инструкцию echo каждого случая, если значение переменной <var class="varname">$i</var> равно 0!
  PHP выполнит инструкции echo двух последних случаев, если значение переменной <var class="varname">$i</var> равно 1.
  Код поведёт себя предсказуемо и выведет «Значение переменной $i равно 2», только если
  значение переменной <var class="varname">$i</var> равно 2. Поэтому лучше помнить об инструкциях
  <code class="literal">break</code>, даже если в конкретных обстоятельствах инструкции прерывания умышленно не указываются.
 </p>
 <p class="simpara">
  В инструкции <code class="literal">switch</code> условие вычисляется
  только один раз, а результат сравнивается со значением выражения каждой инструкции
  <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 /><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 /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  Инструкция <code class="literal">default</code> управляет случаями по умолчанию.
  Управление переходит к случаю по умолчанию при несовпадении значения выражения switch
  со значениями выражений других случаев.
  Приведём пример:
  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<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 />    default:<br />       echo </span><span style="color: #DD0000">"Значение переменной \$i не равно 0, 1 или 2"</span><span style="color: #007700">;<br />}<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">
    Многократные инструкции default вызовут ошибку уровня <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> разрешается указывать в произвольном месте списка случаев.
    Инструкции случая по умолчанию выполняются, только если ни один другой случай не совпал.
    Однако, по общему правилу, лучше расположить инструкцию по умолчанию в конце, как последнюю ветвь.
   </span>
  </p></blockquote>
 </p>
 <p class="para">
  Код не выполнится, как если бы ни одна инструкция <code class="literal">if</code> не оказалась истинной,
  если ни одна ветвь инструкций <code class="literal">case</code> не соответствует значению проверки
  и инструкцию <code class="literal">default</code> не указали.
 </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 /><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 /><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 /><br /></span><span style="color: #FF8000">// Код выведет "B"<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  Для более сложных сравнений в значении инструкции <code class="literal">switch</code> указывают значение <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>,
  или выполняют сравнения альтернативным способом — в блоках <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 /><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 /><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 /><br /></span><span style="color: #FF8000">// Код выведет "B"<br /><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 /><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 /><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 /><br /></span><span style="color: #007700">switch (</span><span style="color: #0000BB">$beer</span><span style="color: #007700">) {<br />    case </span><span style="color: #DD0000">'Tuborg'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'Carlsberg'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'Stella'</span><span style="color: #007700">;<br />    case </span><span style="color: #DD0000">'Heineken'</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 /><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); ?>