DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_get_attribute_names - get a list of attributes from an object.

LIBRARY CALL

char **
kdms_get_attribute_names(
   kobject object,
   char   *segment,
   char   *filter,
   int     permanent,
   int    *number)

INPUT

OUTPUT

RETURN VALUE

an array of attribute names

DESCRIPTION

This function returns a list of attributes associated with the specified segment. If the segment is NULL, then it returns a list of the attributes for the object.

The allowable regular expression syntax is :

. Match any single character except newline

* Match the preceding character or range of characters 0 or more times. The matching includes items within a [...].

[...] or [^..] Matches any one character contained within the brackets. If the first character after the '[' is the ']', then it is included in the characters to match. If the first character after the '[' is a '^', then it will match all characters NOT included in the []. The '-' will indicate a range of characters. For example, [a-z] specifies all characters between and including the ascii values 'a' and 'z'. If the '-' follows the '[' or is right before the ']' then it is interpreted literally. ^ If this is the first character of the regular expression, it matches the beginning of the line. $ If this is the last character of the regular expression, it matches the end of the line.

\\ This escapes the meaning of a special character.

The array that is returned must be freed by the user using the call karray_free.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kdataman/src/attributes.c

SEE ALSO

kdataman(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.