global initializer step More...

#include "ZFLevel.h"
#include "ZFCoreStaticRegister.h"
#include "ZFCoreArray.h"

Macros
#define	ZFFrameworkInitFinishCallbacks
	called when ZFFrameworkInit finished

#define	ZFFrameworkCleanupPrepareCallbacks
	called when ZFFrameworkInit finished

#define	ZFTOKEN_ZFFrameworkStateNotAvailable
	string tokens

#define	ZFTOKEN_ZFFrameworkStateInitRunning
	string tokens

#define	ZFTOKEN_ZFFrameworkStateAvailable
	string tokens

#define	ZFTOKEN_ZFFrameworkStateCleanupRunning
	string tokens

#define	ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL(Name, ZFLevel_)
	code block that will be executed when app start and stop

#define	ZF_GLOBAL_INITIALIZER_INIT(Name)
	see ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL

#define	ZF_GLOBAL_INITIALIZER_DESTROY(Name)
	see ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL

#define	ZF_GLOBAL_INITIALIZER_END(Name)
	see ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL

#define	ZF_GLOBAL_INITIALIZER_INSTANCE(Name)
	access the instance of the initializer

#define	ZF_GLOBAL_INITIALIZER_CLASS(Name)
	the class holder of the global initializer

Typedefs
typedef void(*	ZFFrameworkStateUpdateCallback) (void)
	see ZFFrameworkInit

Enumerations
enum	ZFFrameworkState { ZFFrameworkStateNotAvailable , ZFFrameworkStateInitRunning , ZFFrameworkStateAvailable , ZFFrameworkStateCleanupRunning }
	state for ZFFramework More...

Functions
void	ZFFrameworkInit (void)
	must be called in main thread before any access of ZFFramework member

void	ZFFrameworkCleanup (void)
	see ZFFrameworkInit

void	ZFFrameworkAssertInit (void)
	assert fail and output log if ZFFramework not initialized

ZFFrameworkState	ZFFrameworkStateCheck (void)
	get current state of ZFFramework

ZFFrameworkState	ZFFrameworkStateCheck (ZFLevel level)
	get current state of ZFFramework of specified level

Detailed Description

global initializer step

Macro Definition Documentation

◆ ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL

#define ZF_GLOBAL_INITIALIZER_INIT_WITH_LEVEL	(		Name,
			ZFLevel_ )

code block that will be executed when app start and stop

usage:

// in a *.cpp file
ZF_GLOBAL_INITIALIZER_INIT(SomeName)
: data('c') // you can init member here
{
    // code that will be executed when app start
}
ZF_GLOBAL_INITIALIZER_DESTROY(SomeName) {
    // code that will be executed when app stop
}
private:
    zfchar data; // you can add member here
private:
    void func() {} // you can add function here
ZF_GLOBAL_INITIALIZER_END(SomeName)

Warning: if you have more than one initializer with same level, the execute order of the code block is not ensured; init and destroy step is not one time, they'll be called each time ZFFrameworkInit/ZFFrameworkCleanup is called

Note: see ZF_STATIC_REGISTER_INIT for recommended usage

Enumeration Type Documentation

◆ ZFFrameworkState

enum ZFFrameworkState

state for ZFFramework

Enumerator
ZFFrameworkStateNotAvailable	not available
ZFFrameworkStateInitRunning	during init step (ZFFrameworkInit)
ZFFrameworkStateAvailable	available, init finished
ZFFrameworkStateCleanupRunning	during cleanup step (ZFFrameworkCleanup)

Function Documentation

◆ ZFFrameworkInit()

void ZFFrameworkInit ( void )

extern

must be called in main thread before any access of ZFFramework member

usually, this would been done by implementation of ZFFramework

ADVANCED:
if you want to dynamically load other libs written in ZFFramework after ZFFramework's main lib initialized:

you must manually call ZFFrameworkInit to initialize your newly loaded lib
when unload the additional lib, the ZF_GLOBAL_INITIALIZER_DESTROY's order is not ensured
ZFFrameworkInitFinishCallbacks and ZFFrameworkCleanupPrepareCallbacks won't be called when loading the additional lib

Macros

Typedefs

Enumerations