Purpose
Creates a tag string and appends it to the current string.
Library
The signaling interface library (libsl.a).
C syntax
#include <sltag.h>
...
SL_RET_CODE sl_put_tag (
char * buffer,
int buffer_len,
char * tag,
char * value
);
Description
Uses tag and value to create a tag string and appends
it to buffer. If the tag label already exists in buffer the
function returns an error and buffer remains unchanged.
Parameters
- buffer
- A string containing one or more tag strings.
- buffer_len
- The total length of buffer, not just its current contents.
- tag
- A string containing a tag label
- value
- A string containing a tag value
Return values
- SLRC_OK
- Successful.
- SLRC_OVERFLOW
- Insufficient space in buffer to add the attribute substring.
- SLRC_DUPLICATE
- The tag string already exists in buffer.
- SLRC_NULL_PTR
- buffer,tag or value is a null pointer