Identifier: unique_gstructure_name

Type

string

Description

A system-derived unique name to be used when creating gstructure objects.

The value of this identifier will change every time it is called, by incrementing an internal serial number, e.g.

Command> tell unique_gstructure_name
gst000001
Command> tell unique_gstructure_name
gst000002

Derived names are unique only within the current Fire session.

The same system of unique naming is used when creating gstructure objects without specifying a name, e.g.

gstructure ~test.mygst_t { string value }
~test.mygst_t

This will name the new object using the unique name rule. Using the unique_gstructure_name identifier has the advantage of knowing what unique name will be used, so the above code could also be written as follows:

gstructure ~test.mygst_t { string value }
string uniq=unique_gstructure_name
~test.mygst_t ^(uniq)

Notes

The value of this identifier cannot be changed.

See Also

Commands:

gstructure

Identifiers:

unique_compound_name (string)