stk_count is used to count the number of items in a stack.
The output is to the stk_count parameter file.
stk_count infile [count] [echo] [verbose]
The stk_count program takes an infile string as input. The infile
string can be defined in any variation that is accepted by the ASCDS
stack API. These variations include the use of @ and added directory
paths (ie. @/tmp/foo).
The output parameter is count. Count will hold the number of elements
found in the stack defined by infile.
The level of verbosity is defined by the verbose parameter. The user
can optionally set verbose from 0 (for not output) up to 3 (for the
most output.)
stk_count infile="one two three"
stk_count will build a stack from the string infile string "one two
three" and output the number of items in the stack. In this case the
number of stack items is 3.
stk_count infile="@file.lis foo"
stk_count will build a stack from the string infile string "@file.lis
foo" and output the number of items in the stack. If file.lis
contains 5 lines, the number of stack items will be 6.
stk_count infile="foo @/tmp/file.lis goo"
stk_count will build a stack from the string infile string "foo @file.lis
goo" and output the number of items in the stack. If /tmp/file.lis
contains 10 lines, the number of stack items will be 12.
Parameter=infile (file required filetype=input stacks=yes)
The string used to build a stack.
The infile string can be defined in any variation that is accepted by
the ASCDS stack API. These variations include the use of @ and added
directory paths (ie. @/tmp/foo). Zero or more stacks may be used as input.
This is the tool output. Count holds the total number of elements derived
from the infile parameter.
Parameter=echo (boolean not required default=no)
Echo value to screen?
Determines if the retrieved value is printed to the screen
in addition to being stored in the parameter file.
Parameter=verbose (integer not required default=0 min=0 max=5)
Determines the level of output the user will see when the program is run.
Each level adds additional output.
0 - no output.
1 - shows non-hidden parameters.
2 - shows hidden parameters.
3 - gives the user information about which stage of the program is executing.
|
![[CIAO Logo]](../imgs/ciao_logo_navbar.gif){kind=logo}