/*********************************************************************** Author: Zihan Chen (vczh) Licensed under https://github.com/vczh-libraries/License ***********************************************************************/

/// <summary>

/// Base type of all global storages.

/// A global storage stores multiple values using a name.

/// The "BEGIN_GLOBAL_STOREGE_CLASS" macro is recommended to create a global storage.

/// </summary>

/// <remarks>

/// All values are shared like global variables, but they are created at the first time when they need to be accessed.

/// <see cref="FinalizeGlobalStorage"/> is recommended after you don't need any global storages any more, it frees memory.

/// </remarks>

/// <example><![CDATA[

/// BEGIN_GLOBAL_STORAGE_CLASS(MyStorage)

/// Ptr<vint> data;

/// INITIALIZE_GLOBAL_STORAGE_CLASS

/// data = new vint(100);

/// FINALIZE_GLOBAL_STORAGE_CLASS

/// data = nullptr;

/// END_GLOBAL_STORAGE_CLASS(MyStorage)

///

/// int main()

/// {

/// // GetMyStorage is generated by defining MyStorage

/// Console::WriteLine(itow(*GetMyStorage().data.Obj()));

/// FinalizeGlobalStorage();

/// }

/// ]]></example>

/// <summary>Free all memories used by global storages.</summary>