XPRMgetdsoannotations
XPRMgetdsoannotations |
Purpose
Synopsis
int XPRMgetdsoannotations(XPRMdsolib dso, const char *prefix, const char **ann, int maxann);
Arguments
|
dso
|
Reference to a dynamic shared object loaded by Mosel
|
|
prefix
|
Filtering prefix
|
|
ann
|
Array of size
maxann where to store the annotations (can be
NULL)
|
|
maxann
|
Size of
ann (to get up to
maxann/2 annotations)
|
Return value
Size of the array required to get all annotations (two times the number of found annotations).
Further information
1. This function retrieves the annotations defined by a module using a prefix as a filter (
e.g. use
"doc." to get all the documentation annotations). The result is stored in the provided array: each annotation occupies 2 entries in the array (the first one for the name of the annotation and the following one for its value).
2. The returned value may exceed
maxann (but no more than
maxann entries are recorded in the array). To get the required size for
ann the function may be called with a
NULL array.
Related topics