break
break
(PHP 4, PHP 5, PHP 7)
break
ends execution of the current for
, foreach
, while
, do-while
or switch
structure.
break
accepts an optional numeric argument which tells it how many nested enclosing structures are to be broken out of. The default value is 1
, only the immediate enclosing structure is broken out of.
<?php
$arr = array('one', 'two', 'three', 'four', 'stop', 'five'
while (list(, $val) = each($arr)) {
if ($val == 'stop') {
break; /* You could also write 'break 1;' here. */
}
echo "$val<br />\n";
}
/* Using the optional argument. */
$i = 0;
while (++$i) {
switch ($i) {
case 5:
echo "At 5<br />\n";
break 1; /* Exit only the switch. */
case 10:
echo "At 10; quitting<br />\n";
break 2; /* Exit the switch and the while. */
default:
break;
}
}
?>
Version | Description |
---|---|
5.4.0 | break 0; is no longer valid. In previous versions it was interpreted the same as break 1;. |
5.4.0 | Removed the ability to pass in variables (e.g., $num = 2; break $num;) as the numerical argument. |
← foreach
continue →
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/control-structures.break.php