IupGetGlobal

IUP - Portable User Interface

IupGetGlobal

Returns an attribute value from the global environment. The value can be returned from the driver or from the internal storage.

Parameters/Return

char *IupGetGlobal(const char *name); [in C]
iup.GetGlobal(name: string) -> value: string [in Lua]

name: name of the attribute.

This function returns the attribute’s value. If the attribute does not exist, NULL (nil in Lua) is returned.

Notes

This function’s return value is not necessarily the same one used by the application to define the attribute’s value. 

The subsequent call to the IupGetGlobal function may change the contents of the previously returned pointer, as this is an internal IUP buffer. The user is in charge of storing the value before calling IupGetGlobal again. This pointer must not be free either.

IupGetAttribute can also be used to get global attributes, just set the element to NULL.

See Also

IupGetAttribute, IupSetGlobal