g_cumand(G;S;O;X)
Returns a boolean value indicating whether all values up to and including a particular row within a given group are true.
Function type
Vector only
Syntax
g_cumand(G;S;O;X)
t_cumand(X)
Input
Argument | Type | Description |
---|---|---|
G |
any | A space- or comma-separated list of column names Rows are in the same group
if their values for all of the columns listed in If If any of the columns listed in |
S |
integer | The name of a column in which every row evaluates to a 1 or 0, which determines
whether or not that row is selected to be included in the calculation If
If any of the values in
|
O |
integer | A space- or comma-separated list of column names that
determine the row order within a particular group If
If any of the values in |
X |
|
A column name Note: This column can only contain a 1 or
0 value (or is a computed column that evaluates to such)
for every row.
An N/A in |
Return Value
For every row in each group defined by G
and ordered by O
(and for those rows where S
=1, if specified),
g_cumand
returns an integer value of 1 if
all of the values in the column listed in X
within the rows up to and
including that row are equal to 1. If any of the values are equal to 0, this function
returns 0.
If no rows in a group have valid (non-N/A) values for X
, the result for
every row of the group is 1.
Sample Usage
<base table="pub.doc.samples.ref.func.g_func_time_series_and_or"/> <willbe name="g_cumand_1" value="g_cumand(state;include;order;value)"/> <willbe name="g_cumand_2" value="g_cumand(state city;include;order;value)"/>
Additional Information
- The
t_
version of this function defaults theG
argument and omits theS
argument. The default forG
is set at table load time based on the organization of the table.