ts::Features Class Reference

#include <tsFeatures.h>

Classes
class	Register

Public Types
using	GetVersionFunc = UString (*)()
using	index_t = Names::int_t
enum	Support {   ALWAYS ,   SUPPORTED ,   UNSUPPORTED }

Public Member Functions
std::list< std::pair< UString, UString > >	getAllVersions ()
UString	getVersion (const UString &option)
UString	getVersion (index_t index)
bool	isSupported (const UString &option)
bool	isSupported (index_t index)
index_t	registerFeature (const UString &option, const fs::path &library)
index_t	registerFeature (const UString &option, const UString &name, Support support, GetVersionFunc get_version)
const Names &	supportEnum () const
const Names &	versionEnum () const

Static Public Member Functions
static Features &	Instance ()
	Get the instance of the singleton of this class.

Detailed Description

Repository of dynamically registered features.

Member Typedef Documentation

index_t

using ts::Features::index_t = Names::int_t

Each feature is assigned a unique positive number.

GetVersionFunc

using ts::Features::GetVersionFunc = UString (*)()

Profile of a function return a version string for a feature.

Member Enumeration Documentation

Support

enum ts::Features::Support

Describe the level of support for a feature.

Enumerator
ALWAYS	Feature is always supported, may ask version but no need to ask if supported.
SUPPORTED	Optional feature, currently supported.
UNSUPPORTED	Optional feature, not supported.

Member Function Documentation

Instance()

Features & ts::Features::Instance ( )

static

Get the instance of the singleton of this class.

Returns

The instance of the singleton of this class.

registerFeature() [1/2]

index_t ts::Features::registerFeature	(	const UString &	option,
		const UString &	name,
		Support	support,
		GetVersionFunc	get_version )

Register a feature.

Parameters

[in]	option	Feature name as used in command line options.
[in]	name	Feature name as used on display.
[in]	support	Level of support.
[in]	get_version	Function returning the version of the feature. Can be null (no identified version).

Returns

An index for the feature, as used in isSupported() or getVersion().

registerFeature() [2/2]

index_t ts::Features::registerFeature	(	const UString &	option,
		const fs::path &	library )

Register a feature which is in another shared image. If a feature with the same option name is already registered, do nothing. Otherwise, the library name is stored for later usage. The first time the feature is searched, the shared library is loaded. If the load succeeds and the initialization of the shared image registered a feature with the same name, the feature becomes defined. Otherwise, the feature is definitely marked as unsupported.

Parameters

[in]	option	Feature name as used in command line options.
[in]	library	Name of a shared image (typically without directory).

Returns

An index for the feature, as used in isSupported() or getVersion().

supportEnum()

const Names & ts::Features::supportEnum ( ) const

inline

Enumeration of optional features. Typically used to implement the --support command line option.

Returns

A constant reference to the enumeration description. All integer values are positive. For a given feature which is both optional and versioned, the same integer value is returned by supportEnum() and versionEnum().

See also

versionEnum()

versionEnum()

const Names & ts::Features::versionEnum ( ) const

inline

Enumeration of versioned features. Typically used to implement the --version command line option.

Returns

A constant reference to the enumeration description. All integer values are positive. For a given feature which is both optional and versioned, the same integer value is returned by supportEnum() and versionEnum().

See also

supportEnum()

isSupported() [1/2]

bool ts::Features::isSupported

(

index_t

index

)

Check if a feature is supported.

Parameters

[in]

index

Index of the feature as returned in supportEnum().

Returns

True if the feature is supported.

isSupported() [2/2]

bool ts::Features::isSupported

(

const UString &

option

)

Check if a feature is supported.

Parameters

[in]

option

Command line option of the feature.

Returns

True if the feature is supported.

getVersion() [1/2]

UString ts::Features::getVersion

(

index_t

index

)

Get the version of a feature, if supported.

Parameters

[in]

index

Index of the feature as returned in versionEnum().

Returns

Feature version string. Empty string if the feature is not supported.

getVersion() [2/2]

UString ts::Features::getVersion

(

const UString &

option

)

Get the version of a feature, if supported.

Parameters

[in]

option

Command line option of the feature.

Returns

Feature version string. Empty string if the feature is not supported.

getAllVersions()

std::list< std::pair< UString, UString > > ts::Features::getAllVersions

(

)

Get the version of all features.

Returns

A list of string pairs: feature name, feature version.

---

The documentation for this class was generated from the following file:

• tsFeatures.h