ModuleSettings Class Reference

Query and set certain properties of the CppMicroServices library. More...

Public Types
typedef std::vector< std::string >	PathList

Static Public Member Functions
static std::string	CURRENT_MODULE_PATH ()
	Returns a special string which can be used as an argument for a AddAutoLoadPath() call. More...
static bool	IsThreadingSupportEnabled ()
static bool	IsServiceFactorySupportEnabled ()
static bool	IsAutoLoadingEnabled ()
static void	SetAutoLoadingEnabled (bool enable)
	Enable or disable auto-loading support. More...
static PathList	GetAutoLoadPaths ()
static void	SetAutoLoadPaths (const PathList &paths)
	Set a list of paths in the file-system from which modules should be auto-loaded. More...
static void	AddAutoLoadPath (const std::string &path)
	Add a path in the file-system to the list of paths from which modules will be auto-loaded. More...

Detailed Description

Query and set certain properties of the CppMicroServices library.

The following environment variables influence the runtime behavior of the CppMicroServices library:

• US_DISABLE_AUTOLOADING If set, auto-loading of modules is disabled.
• US_AUTOLOAD_PATHS A ':' (Unix) or ';' (Windows) separated list of paths from which modules should be auto-loaded.

Remarks

This class is thread safe.

Member Typedef Documentation

typedef std::vector<std::string> ModuleSettings::PathList

Member Function Documentation

static void ModuleSettings::AddAutoLoadPath ( const std::string &  path )

static

Add a path in the file-system to the list of paths from which modules will be auto-loaded.

Parameters

path	The additional absolute auto-load path in the file-system.

static std::string ModuleSettings::CURRENT_MODULE_PATH ( )

static

Returns a special string which can be used as an argument for a AddAutoLoadPath() call.

When a module is loaded and this string has been added as a path to the list of auto-load paths the CppMicroServices library will auto-load all modules from the currently being loaded module's auto-load directory.

Returns

A string to be used in AddAutoLoadPath().

Remarks

The returned string is contained in the default set of auto-load paths, unless a new set of paths is given by a call to SetAutoLoadPaths().

See Also

MicroServices_AutoLoading

US_INITIALIZE_MODULE

static PathList ModuleSettings::GetAutoLoadPaths ( )

static

Returns

A list of paths in the file-system from which modules will be auto-loaded.

static bool ModuleSettings::IsAutoLoadingEnabled ( )

static

Returns

true if support for module auto-loading is enabled, false otherwise.

Remarks

This method will always return false if support for auto-loading has not been configured into the CppMicroServices library or if it has been disabled by defining the US_DISABLE_AUTOLOADING environment variable.

static bool ModuleSettings::IsServiceFactorySupportEnabled ( )

static

Returns

true if support for service factories has been configured into the CppMicroServices library, false otherwise.

static bool ModuleSettings::IsThreadingSupportEnabled ( )

static

Returns

true if threading support has been configured into the CppMicroServices library, false otherwise.

static void ModuleSettings::SetAutoLoadingEnabled ( bool  enable )

static

Enable or disable auto-loading support.

Parameters

enable

If true, enable auto-loading support, disable it otherwise.

Remarks

Calling this method will have no effect if support for auto-loading has not been configured into the CppMicroServices library of it it has been disabled by defining the US_DISABLE_AUTOLOADING envrionment variable.

static void ModuleSettings::SetAutoLoadPaths ( const PathList &  paths )

static

Set a list of paths in the file-system from which modules should be auto-loaded.

Parameters

paths

A list of absolute file-system paths.