int fetch_tag ( char *path_bos, char *tag_name, SS_TAG *tag )

char   *path_bos;    // path name of SilverScreen block, object or symbol

char   *tag_name;    // tag name

SS_TAG *tag;         // address of tag structure

Synopsis

#include "silver.h"

The fetch_tag function searches the SilverScreen database for a block, object or symbol with the name path_bos , containing a tag with the name tag_name . If such a BOS exists, then its tag contents are copied into the structure pointed to by tag .

Parameters

path is a null-terminated string containing the name of the block, object or symbol desired. tag_name is a null-terminated string containing the tag name desired. tag is the address of a tag structure (defined in silver.h) to receive the tag information.

Return Value

fetch_tag copies the tag information into tag if the search succeeds, and returns SS_SUCCESS (0); otherwise SS_NOTFOUND (-1) is returned.

See Also

The TAG script command is used to attach tagged data.  There is no SilverC function that attaches tags to entities.