action|rule when test action|rule unless test
You can use
unless to make any OmniMark rule or action conditional. The rule will not fire, the action will not be executed, if the condition following
when is false, or the condition following
unless is true.
The following rule will fire when "hello" occurs in the data only if "count" is greater than 12:
find "hello" when count > 12
The following action will be executed unless the variable "name" contains the string "Fred":
output name unless name = "Fred"
unless can also be used to make any block or looping structure conditional by placing them at the end of the structure:
do xml-parse document scan my-document output"%c" done unless my-flag
This is not particularly readable, however. It will usually be preferable to wrap the structure you want to make conditional in a do when or do unless block:
do unless my-flag do xml-parse document scan my-document output "%c" done done