Editing WoW:API SecureCmdOptionParse

{{wowapi}} __NOTOC__

Evaluates macro options in the string and returns the appropriate sub-string or nil

<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->
 result = SecureCmdOptionParse(cmd)


== Arguments ==
<!-- List each argument, together with its type -->

:;cmd : String - the string to be parsed


== Returns ==
<!-- List each return value, together with its type -->

:;result : String - the selected sub-string or nil


== Example ==
<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory -->
 local result = SecureCmdOptionParse("[mod:alt] Alt is down; Alt is not down")

<big>'''Result'''</big>
<!-- If it helps, include example results here, though they are not required. You're allowed to cheat liberally since WoW isn't a command line language. -->

If the alt key is being held down when the above line is executed then result will be "Alt is down" otherwise it will be "Alt is not down"

Commands which don't meet any of the specified conditions will return nil.  For example

 local result = SecureCmdOptionParse("[nomod:alt] Alt is not down")

Will return nil if the alt key is held down while it's called and will return "Alt is not down" otherwise.

== Details ==
<!-- Details not appropriate for the main description can go here. 
     REMOVE the section if you're just going to restate the intro line! -->

: This command can be used to implement the same conditional processing that Blizzard's macro system uses.  It is the same API they use and so supports all the same conditionals.

: Note that item links can not be part of the commands because they contain square brackets [], which get interpreted by the parser as modifiers.