garr

Purpose:

Display array variables from shared memory with options to format output for quiet mode, units, and delimiters.

Enter:

garr [-q] [-u] [-d delim] [-h] [array] [:enum_str]

or

garr [array] [?int_var]

Where:

:

The : symbol designates that the following index is either a constant integer or an enum defined in the array_specs file.

?

The ? symbol designates that the following string is the label of an integer variable whose value will be used as an index.

-q

Optional. Specify -q (quiet) to only print values. 

-u

Optional. Specify -u to include units in the output.

-d delim

Optional. -Specify d delimiter to separate the values in quiet mode. Delimiter options are:

  • c is ‘,’
  • t is tab
  • s is space
  • n (default) is newline

array

Optional. Specify the array variable name.

-h

Optional. Specify -h to display help.

:enum_str

Optional. Specify the colon symbol followed by an enum string or integer to for the array index. 

?int_var

Optional. Specify the question mark symbol followed by an integer variable whose value will be used as an index.

Example:

garr
The above command displays all the array variables. It displays only the labels of their associated maximum range for each dimension. No values will be displayed.

garr my_vrbl
The above displays all the values for array variable <my_vrbl>

garr my_vrbl:TC15
The above displays all the values for array variable <my_vrbl> that are associated with enum <TC15>.

garr my_vrbl:TC15:STATUS
The above displays all the values for array variable `my_vrbl` that are associated with enums <TC15> and <STATUS>.

garr my_vrbl?indx1?indx2
The above displays all the values for array variable <my_vrbl> that are associated with the values in integer variables <indx1> and <indx2>

Notes:

If an enum string is entered as a dash, then any element associated with that enum will NOT BE DISPLAYED.

See Also:

CyFlex Variables, Units, and Computed Expressions, Array Variables