break)Terminate execution of a block within your processes scope
break will terminate execution of a block (eg
function, private, foreach,
if, etc).
break requires a parameter and that parameter is the
name of the caller block you wish to break out of. If it is a
function or private, then it will be the name
of that function or private. If it is an if or
foreach loop, then it will be if or
foreach (respectively).
break block-namefunction foo {
%[1..10] -> foreach i {
out $i
if { $i == 5 } then {
out "exit running function"
break foo
out "ended"
}
}
}Running the above code would output:
» foo
1
2
3
4
5
exit running functionbreak can be considered to exhibit the behavior of
return (from other languages) too
function example {
if { $USER == "root" } then {
err "Don't run this as root"
break example
}
# ... do something ...
}Though in this particular use case it is recommended that you use
return instead, the above code does illustrate how
break behaves.
break cannot escape the bounds of its scope (typically
the function it is running inside). For example, in the following code
we are calling break bar (which is a different function)
inside of the function foo:
function foo {
%[1..10] -> foreach i {
out $i
if { $i == 5 } then {
out "exit running function"
break bar
out "ended"
}
}
}
function bar {
foo
}Regardless of whether we run foo or bar,
both of those functions will raise the following error:
Error in `break` (7,17): no block found named `bar` within the scope of `foo`return): Exits current function scopeexit):
Exit murexforeach): Iterate through an arrayformap): Iterate through a map or other collection of
dataif):
Conditional statement to execute different blocks of code depending on
the result of the conditioncontinue): Terminate process of a block within a
caller functionout):
Print a string to the stdout with a trailing new line characterprivate): Define a private function blockfunction): Define a function blockThis document was generated from builtins/core/structs/break_doc.yaml.
This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.
Last built on Wed Jan 15 23:07:50 UTC 2025 against commit b4c4296b4c429617fd41527ea0efef33c52c15ef2b64972.
Current version is 6.4.2063 (develop) which has been verified against tests cases.