dio_find_name_c

status.i4.v = dio_find_name_c(search_string.i1a.r, string_length.i4.v,
max_names.i4.v, returned_names.i1a.r
[,options.i4.v])
This routine finds device names which match a specified search
string. Percent (%) or asterisk (*) characters can be used as a
wildcard matching zero or more characters. The underscore (_)
character can be used as a wildcard matching exactly one character.
A set of characters for a single character location can also be
specified by enclosing the set of possible values within a pair of
square braces ([]). Either a range of characters can be specified
by inserting the minimum and maximum possible characters separated
by a dash (-) or a set of characters can be entered explicitly with
no separators. A set can be negated with a leading caret (^)
character inside the braces. Use of any type of wildcard character
at the beginning of the search string will greatly increase the
time taken by the search. If the status is equal to the number of
names requested, there may be more possible matches in the database.
search_string device name search string containing one or more
wildcard characters
string_length length of search string (If a value of zero is passed,
the length of the string will be determined by this
routine.)
max_names maximum number of names to return (Note: If a value
of zero is passed for this argument, only the count
of matching device names is returned.)
returned_names returned device names
(dio_get_terse_name_length characters per entry)
[options] device index retrieval options
(DIO_NAME_OPT_NONE -> no options selected,
DIO_NAME_OPT_ALLOW_OBSOLETE -> want device indices of
obsoleted and deleted
devices,
DIO_NAME_OPT_FULL_NAME -> retrieve information for
full names)
This function returns status values as follows:
DIO_MEMFAIL memory allocation failure
DIO_BADARG search string contains either single or
double quotes
otherwise number of returned (or matching) device names
This function requires the following include files:
cnsparam_h, diolib_h, acnet_errors_h
Related functions:
dio_dev_name(_c), dio_device_index(_c), dio_name_to_index,
dio_full_name_to_terse_name_c, dio_terse_name_to_full_name_c,
dio_fermi_name_c, dio_name_to_fermi_name_c, dio_fermi_name_to_key_c
C/C++ usage:
static char search_string[] = "I:H1*";
char returned_names[MAX_NAMES][DEVICE_TERSE_NAME_LEN];
int status;
int string_length = 0;
int max_names = MAX_NAMES;
int options = DIO_NAME_OPT_NONE;
status = dio_find_name_c(search_string,string_length,max_names,
(char *) returned_names,options);