Command Syntax

Gold commands are of the form:

<Object> [,<Object>...] <Action> [ [<Conjunction>] [<Open_Parenthesis>...] [<Object>.] <Name> <Operator> [<Object>.] <Value> [<Close_Parenthesis>...] ...]

The basic form of a command is <Object> <Action> [<Name><Operator><Value>]*. When an action is performed on more than one object, such as in a multi-object query, the objects are specified in a comma-separated list. Commands may accept zero or more predicates which may function as fields to return, conditions, update values, processing options, etc. Predicates, in their simplest form, are expressed as Name, Operator, Value tuples. Predicates may be combined via conjunctions with grouping specified with parentheses. When performing multi-object queries, names and values may need to be associated with their respective objects.

Valid conjunctions include:

&&

and

||

or

&!

and not

|!

or not

Open parentheses may be any number of literal open parentheses '('.

Name is the name of the condition, assignment, or option. When performing a multi-object query, a name may need to be prepended by its associated object separated by a period.

Valid operators include:

==

equals

<

less than

>

greater than

<=

less than or equal to

>=

greater than or equal to

!=

not equal to

~

matches

=

is assigned

+=

is incremented by

-=

is decremented by

:=

option

:!

not option

Value is the value of the selection list, condition, assignment, or option. When performing a multi-object query, a value may need to be prepended by its associated object (called the subject) separated by a period.

Close parentheses may be any number of literal closing parentheses ')'.