alib::app::OptionDecl Class Reference

Description:

A declaration for an Option.

Construction is done by passing a custom enum element of an enum type equipped with ALib Enum Records of type EROptionDecl.

When bootstrapping, the method void DefineOptions()  has to be invoked for (each) enum type.

Definition at line 283 of file cliargtypes.hpp.

#include <cliargtypes.hpp>

Collaboration diagram for alib::app::OptionDecl:

Public Method Index:
template<typename TEnum>
	OptionDecl (TEnum element)
const Enum &	Element () const
const String &	HelpText ()
const String &	HelpUsageLine ()
const String &	Identifier ()
character	IdentifierChar ()
int	MinimumRecognitionLength ()
integer	QtyExpectedArgsFollowing ()
const String &	ShortcutReplacementString ()
const String &	ValueSeparator ()

Protected Field Index:
Enum	declElement
	The enumeration element given with construction.
EROptionDecl	record
	A copy (!) of the enum record.
ResourceInfo	resourceInfo
	The resource information of the enumeration type given with construction.

Field Details:

declElement

Enum alib::app::OptionDecl::declElement

protected

The enumeration element given with construction.

Definition at line 286 of file cliargtypes.hpp.

record

EROptionDecl alib::app::OptionDecl::record

protected

A copy (!) of the enum record.

Definition at line 289 of file cliargtypes.hpp.

resourceInfo

ResourceInfo alib::app::OptionDecl::resourceInfo

protected

The resource information of the enumeration type given with construction.

Definition at line 292 of file cliargtypes.hpp.

Constructor(s) / Destructor Details:

OptionDecl()

template<typename TEnum>

alib::app::OptionDecl::OptionDecl ( TEnum element )

inline

Templated constructor which takes an enum element of a custom type equipped with ALib Enum Records of type EROptionDecl.

Template Parameters

TEnum

C++ enum type equipped with corresponding ALib Enum Records.

Parameters

element

The enum element

Definition at line 302 of file cliargtypes.hpp.

Here is the call graph for this function:

Method Details:

Element()

const Enum & alib::app::OptionDecl::Element ( ) const

inline

Returns the type and integral value of the enumeration element used with construction.

Returns

The enumeration element used with construction.

Definition at line 312 of file cliargtypes.hpp.

HelpText()

const String & alib::app::OptionDecl::HelpText ( )

inline

Returns the help text. Loads the string from resourceInfo using resource name "TOptHlpNN", where NN is the enum element's integral value.

Returns

The help text.

Definition at line 356 of file cliargtypes.hpp.

Here is the call graph for this function:

HelpUsageLine()

const String & alib::app::OptionDecl::HelpUsageLine ( )

inline

Returns a formal description of the usage. Loads the string from resourceInfo using resource name "TOptUsgNN", where NN is the enum element's integral value.

Returns

The help text.

Definition at line 349 of file cliargtypes.hpp.

Here is the call graph for this function:

Identifier()

const String & alib::app::OptionDecl::Identifier ( )

inline

Returns the identifier of the option if double hyphen '–' is used.

Returns

The option identifier.

Definition at line 316 of file cliargtypes.hpp.

IdentifierChar()

character alib::app::OptionDecl::IdentifierChar ( )

inline

Returns the identifier of the option if single hyphen '-' is used.

Returns

The option identifier.

Definition at line 324 of file cliargtypes.hpp.

MinimumRecognitionLength()

int alib::app::OptionDecl::MinimumRecognitionLength ( )

inline

Returns the minimum parse length of the identifier if double hyphen '–' is used.

Returns

The minimum characters to satisfy the option.

Definition at line 320 of file cliargtypes.hpp.

QtyExpectedArgsFollowing()

integer alib::app::OptionDecl::QtyExpectedArgsFollowing ( )

inline

The number of CLI arguments to consume and store in ListMA< String, Recycling::Shared > Args with method bool Read(OptionDecl&, String&, const integer) .

Returns

The option identifier.

Definition at line 338 of file cliargtypes.hpp.

ShortcutReplacementString()

const String & alib::app::OptionDecl::ShortcutReplacementString ( )

inline

If an option is a shortcut to another one, this string replaces the argument given.

Returns

The option identifier.

Definition at line 342 of file cliargtypes.hpp.

ValueSeparator()

const String & alib::app::OptionDecl::ValueSeparator ( )

inline

An optional separator string (usually "="), that separates the parameter name from a parameter value.

Returns

The separator string.

Definition at line 333 of file cliargtypes.hpp.

---

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

• cliargtypes.hpp