aciObjectGetTagValueWithDefault
Call the aciObjectGetTagValue
function to obtain the value associated with the first occurrence of a tag.
Syntax
aciError aciObjectGetTagValueWithDefault ( t_aciObject* pObject, char* szTagName, char** pszTagValue, char* szDefault)
Arguments
Arguments | Type/Description |
---|---|
pObject
|
t_aciObject* A pointer to an ACI_DATA type object. |
szTag
|
char* A pointer to the requested tag. |
pszTagValue
|
char** The contents associated with the tag. |
szDefault
|
char* A pointer to the default string. |
Discussion
This function finds the first occurrence of the specified szTagName
, extracts its character value and sets the pointer pszTagValue
to the memory space (allocated by this function) where it stores the character value. If there is no tag with the specified name or if that tag does not contain character data, pszTagValue
points to the szDefault
string.
Returns
An ACI error code.