Doc #69853 [Csd]: break behavior unspecified when no argument is specified

Edit report at https://bugs.php.net/bug.php?id=69853&edit=1 ID: 69853 User updated by: chealer at gmail dot com Reported by: chealer at gmail dot com Summary: break behavior unspecified when no argument is specified Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Assigned To: cmb Block user comment: N Private report: N New Comment: Thank you very much to you, salathe. While the change does fix, I recommend to avoid referring to "the current loop", for 2 reasons: break does not only break from loops. When the behavior was unspecified, there are several current "loops", not just one. I would suggest: The default value is <literal>1</literal> (only break from the innermost enclosing structure). Previous Comments: ------------------------------------------------------------------------ [2015-06-27 20:26:15] salathe@php.net This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. ------------------------------------------------------------------------ [2015-06-27 20:25:06] salathe@php.net Automatic comment from SVN on behalf of salathe Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=337067 Log: clarify break behavior unspecified when no argument is specified (doc bug #69853) ------------------------------------------------------------------------ [2015-06-27 18:45:06] chealer at gmail dot com cmb, the sentence you quote is semantically invalid (there may be more than one current affected structure). As for the example, it cannot replace specification (as for any example). Besides, the break statement you mention is in a single affected structure. Thanks for reopening ------------------------------------------------------------------------ [2015-06-16 18:32:52] cmb@php.net In my opinion, the documentation is pretty clear about that issue: | break ends execution of the current for, foreach, while, | do-while or switch structure. Furthermore line 5 of the example is: | break; /* You could also write 'break 1;' here. */ ------------------------------------------------------------------------ [2015-06-16 18:14:56] chealer at gmail dot com Apologies, the result is the same, but the proper test should have read: <?php foreach(array(1, 2) as $iteration) { var_dump($iteration); foreach (array(1) as $dummy) { break; } } ?> ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at https://bugs.php.net/bug.php?id=69853 -- Edit this bug report at https://bugs.php.net/bug.php?id=69853&edit=1