sl_get_tag

Purpose

Retrieves the tag value for a specified tag.

Library

The signaling interface library (libsl.a).

C syntax

#include <sltag.h>
...
SL_RET_CODE 	       sl_get_tag_value (
    char *	         buffer,
    char *	         tag,
    char *          destination,
    int             destination_len
);

Description

Searches buffer for the tag label tag. If found, the tag value is extracted from the tag string and written to destination.

Parameters

buffer: A string containing one or more tag strings.
tag: A string containing a tag label
destination: A string variable to which the tag value is copied.
destination_len: The total length ofdestination (the string capacity in bytes)

Return values

SLRC_OK: Successful.
SLRC_NOT_FOUND: Could not find tag.
SLRC_OVERFLOW: Insufficient space in destination to store the tag string.
SLRC_INVALID_TAG: The tag string containing tag is syntactically incorrect, tag value was not changed.
SLRC_NULL_PTR: buffer,tag or destination is a null pointer

sl_get_tag_value