op_stat_invalid_set()
Abstract
Sets a statistic handle as invalid.
Syntax
op_stat_invalid_set (stat_handle_ptr)
| Argument | Type | Description |
|---|---|---|
stat_handle_ptr |
Stathandle* |
Statistic handle that identifies a global or local statistic. |
Return Type
void
No return value.
Example
StatHandle * shs = (StatHandle *)malloc(n * sizeof(StatHandle));
for (int i = 0; i < n; i++)
op_stat_invalid_set (&shs[i]);
Details
None.
Purpose
Provides a way to set a statistic handle as invalid. This is useful with dimensioned statistics if some statistic dimensions are being registered as needed, leaving others unused. This KP lets you set the unregistered statistic dimensions so that op_stat_valid() will report them as invalid.
Errors
None.
Reference
- Use the KP op_stat_invalid_get() to get an invalid statistic handle for a statistic
- Use the KP op_stat_reg() to obtain a statistic handle
- Use the KP op_stat_dim_size_get() to read the dimension size of a local or global statistic