get_logical_strings
length.i4.v = get_logical_strings(true_string.i1p.r,
false_string.i1p.r)
This routine returns the text strings associated with the
logical data type used by the 'numeric_to_ascii(_c)',
'ascii_to_numeric(_c)', '(window_)display_value(_c)', and
'(window_)input_value(_c)' routines. The values for these
strings can be set by a call to 'set_logical_strings'.
Since the memory to hold these strings is allocated by this
routine, the calling program should free this memory when
it is done using the strings. If a value of NULL is passed
for both arguments, only the length of the logical strings
will be returned.
true_string null-terminated ASCII text associated with a
value of TRUE
false_string null-terminated ASCII text associated with a
value of FALSE
This function returns status values as follows:
CBS_MEMFAIL dynamic memory allocation failure
otherwise length of logical test strings
This function requires the following include files:
cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h
Related functions:
set_logical_strings, get_enumerated_strings, set_enumerated_strings_c,
get_enumerated_string_array_c, set_enumerated_string_array_c,
ascii_to_numeric(_c), numeric_to_ascii(_c), create_user_data_type_c,
get_bit_mask_strings_c, set_bit_mask_strings_c,
window_display_value(_c), window_input_value(_c), winput(_c)
C/C++ usage:
char *true_string;
char *false_string;
int status;
status = get_logical_strings(&true_string,&false_string);