GlobalVariable :: create - Create Global variable

A global property with the name of the global variable will be created, i.e. global variable name will be set as property name in the global property handle(propertyDefinition().name()). Since name of the property cannot be changed for subordinated properties, a transient property will be created in this case and set to the property passed.

Global variables created are available in the thread in which they have been created, only. When a global variable with the given name already exists, the function replaces the variable with the property passed.

// fragment

GlobalVariable userName("userName");

GlobalVariable userAge("age");

userName.create(Value("Paul")); // creates a string variable

if ( !userAge.exist() ) // create only, when not yet created

userAge.create(Value(20)); // creates an integer variable

Return value: - internal feature (not documented) ( odaba::GlobalVariable & )

Implementation overview

Create global Variable from property handle
GlobalVariable :: create ( cProperty )
Create global Variable from value handle
GlobalVariable :: create ( cValue )

Implementation details

Create global Variable from property handle
odaba::GlobalVariable & GlobalVariable :: create ( odaba::Property &cProperty )

The property handle passed in cProperty is used as pattern for setting the global variable. When passing an invalid property handle, the function throws an exception.
- cProperty - Property reference
  A property handle refers to a (usually) opened property. Invalid properties may cause an exception.

to list

Create global Variable from value handle
odaba::GlobalVariable & GlobalVariable :: create ( odaba::Value &cValue )

The value handle passed in cValue is used as pattern for creating the global variable. When passing an invalid value handle, the function throws an exception.
- cValue - Value handle
  A value handle refers to a (usually) opened value. Invalid value handles may cause an exception.

to list

to top Comment