Purpose
Removes a tag (and its associated elements) from a buffer of collected
tag strings.
Library
The signaling interface library (libsl.a).
C syntax
#include <sltag.h>
...
SL_RET_CODE sl_remove_tag (
char * buffer,
char * tag
);
Description
Searches buffer for the tag label tag. If an occurrence
is found, the tag, with its values and attributes, is removed from buffer.
Parameters
- buffer
- A string containing one or more tag strings.
- tag
- A string containing a tag label.
Return values
- SLRC_OK
- Successful.
- SLRC_NOT_FOUND
- Could not find tag.
- SLRC_INVALID_TAG
- The tag string containing tag is syntactically incorrect, tag
value was not changed.
- SLRC_NULL_PTR
- buffer or tag_attr is a null pointer.