Specialization of abstract interface class ConfigurationPlugin, which reads command line parameters from namespace globals alib::ARG_C and alib::ARG_VN / ARG_VW on request. Its priority value usually is Priority::CLI, which is higher than all other default plug-ins provided.
To recognize variables, the separation character '/'
of the configuration tree is converted to underscore character '_'
. For example, the ALib locale variable with path ALIB/LOCALE is recognized as ALIB_LOCALE
Variable names are insensitive in respect to character case.
Command line variables may be passed with either one hyphen ('-') or two ('–'). Both are accepted.
An application can specify one or more "default categories" by adding their string names to public field DefaultCategories. Variables of these categories are recognized by the plug-in also when given without the name prefix of category name and underscore '_'
.
Definition at line 67 of file plugins.mpp.
Public Field Index: | |
StringVectorMA | AlternativeArgs |
StringVectorMA | DefaultCategories |
uint8_t | QtyMandatoryHyphens = 0 |
uint8_t | QtyOptionalHyphens = 2 |
Public Method Index: | |
ALIB_DLL | CLIVariablesPlugin (MonoAllocator &ma, Priority pPriority=Priority::CLI) |
virtual | ~CLIVariablesPlugin () override |
Virtual Destructor. | |
virtual ALIB_DLL bool | Get (const String &name, AString &target) override |
virtual ALIB_DLL String | Name () const override |
![]() | |
virtual | ~ConfigurationPlugin () |
Virtual Destructor. | |
virtual const StringEscaper & | GetEscaper () const |
![]() | |
PrioritiesType | GetPriority () const |
Additional Inherited Members | |
![]() | |
using | PluginType |
This exposes the template parameter TPlugin to the outer world. | |
using | PrioritiesType |
This exposes the template parameter pTPlugin to the outer world. | |
![]() | |
StringEscaperStandard | stringEscaper |
![]() | |
PrioritiesType | priority |
The priority of this plug-in. | |
![]() | |
ConfigurationPlugin (Priority pPriority) | |
![]() | |
Plugin (PrioritiesType pPriority) | |
StringVectorMA alib::variables::CLIVariablesPlugin::AlternativeArgs |
If any value is added to this vector, its values are used as the source of command line arguments instead of using ALib namespace variables ARG_C and ARG_VN/ARG_VW.
This mechanic provides an alternative method to set the command line argument list.
Applications that have a dedicated (more sophisticated) CLI interface which performs more complex processing of CLI arguments, may collect any unrecognized CLI argument here to be duly recognized as a configuration variable instead
Definition at line 78 of file plugins.mpp.
StringVectorMA alib::variables::CLIVariablesPlugin::DefaultCategories |
An application can specify one or more "default categories" by adding a prefix of the variable path here. Variables of these "categories" are recognized by the plug-in also when given without this prefix.
Please note, that if ALib and ALox variables should be abbreviatable, for example that the locale can be given with –locale=de_DE.UTF-8 instead of –alib_locale=de_DE.UTF-8 this vector has to be populated during bootstrap phase PrepareConfig. See chapter 7. Customizing The Bootstrap Process for more information on how to customize ALib bootstrapping.
Definition at line 91 of file plugins.mpp.
uint8_t alib::variables::CLIVariablesPlugin::QtyMandatoryHyphens = 0 |
Determines whether zero, one or two introducing hyphen characters '-'
are mandatory. An command line argument is ignored if the number of leading hyphens is smaller than the value set here.
Defaults to 0
.
Definition at line 98 of file plugins.mpp.
uint8_t alib::variables::CLIVariablesPlugin::QtyOptionalHyphens = 2 |
Determines whether zero, one or two optional hyphen characters '-'
might be given. An command line argument is ignored if the number of leading hyphens is greater than the value set here.
Defaults to 2
.
Definition at line 105 of file plugins.mpp.
alib::variables::CLIVariablesPlugin::CLIVariablesPlugin | ( | MonoAllocator & | ma, |
Priority | pPriority = Priority::CLI ) |
Constructor.
ma | The monotonic allocator to use. This usually is the one of the configuration instance. |
pPriority | The priority that this plug-in uses. Defaults to CLI. |
Definition at line 41 of file plugins.cpp.
|
inlineoverridevirtual |
Virtual Destructor.
Definition at line 116 of file plugins.mpp.
|
overridevirtual |
Searches the variable in the command line parameters.
name | The name of the variable to retrieve. | |
[out] | target | A reference to the buffer to write the variable's exported value to. |
true
if variable was found, false
if not. Implements alib::variables::ConfigurationPlugin.
Definition at line 56 of file plugins.cpp.
|
overridevirtual |
Implements alib::variables::ConfigurationPlugin.
Definition at line 47 of file plugins.cpp.