TSDuck Version 3.32-2820 (TSDuck - The MPEG Transport Stream Toolkit)
ts::ArgsWithPlugins Class Reference

Command line arguments for commands with plugins. More...

Inheritance diagram for ts::ArgsWithPlugins:
Collaboration diagram for ts::ArgsWithPlugins:

Public Types

enum  ArgType {
  NONE ,
  STRING ,
  FILENAME ,
  DIRECTORY ,
  HEXADATA ,
  INTEGER ,
  UNSIGNED ,
  POSITIVE ,
  UINT8 ,
  UINT16 ,
  UINT32 ,
  UINT63 ,
  PIDVAL ,
  INT8 ,
  INT16 ,
  INT32 ,
  INT64 ,
  ANUMBER ,
  TRISTATE
}
 Type of an argument or parameter. More...
 
enum  Flags {
  NO_ERROR_DISPLAY = 0x0001 ,
  NO_EXIT_ON_ERROR = 0x0002 ,
  NO_EXIT_ON_HELP = 0x0004 ,
  NO_EXIT_ON_VERSION = 0x0008 ,
  GATHER_PARAMETERS = 0x0010 ,
  HELP_ON_THIS = 0x0020 ,
  NO_DEBUG = 0x0040 ,
  NO_HELP = 0x0080 ,
  NO_VERBOSE = 0x0100 ,
  NO_VERSION = 0x0200 ,
  NO_CONFIG_FILE = 0x0400
}
 Args object flags, used in an or'ed mask. More...
 
enum  HelpFormat {
  HELP_NAME ,
  HELP_DESCRIPTION ,
  HELP_USAGE ,
  HELP_SYNTAX ,
  HELP_FULL ,
  HELP_OPTIONS
}
 Types of help formatting, for getHelpText() and predefined option --help. More...
 

Public Member Functions

 ArgsWithPlugins (size_t min_inputs=0, size_t max_inputs=UNLIMITED_COUNT, size_t min_plugins=0, size_t max_plugins=UNLIMITED_COUNT, size_t min_outputs=0, size_t max_outputs=UNLIMITED_COUNT, const UString &description=UString(), const UString &syntax=UString(), int flags=0)
 Constructor. More...
 
virtual bool analyze (const UString &app_name, const UStringVector &arguments, bool processRedirections=true) override
 Load command arguments and analyze them. More...
 
virtual bool analyze (const UString &command, bool processRedirections=true) override
 Load command arguments and analyze them. More...
 
virtual bool analyze (int argc, char *argv[], bool processRedirections=true) override
 Load command arguments and analyze them. More...
 
UString appName () const
 Get the application name from the last command line analysis. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
INT bitMaskValue (const UChar *name=nullptr, const INT &def_value=static_cast< INT >(0)) const
 Get an OR'ed of all values of an integer option in the last analyzed command line. More...
 
UString commandLine () const
 Get the full command line from the last command line analysis. More...
 
ArgscopyOptions (const Args &other, const bool replace=false)
 Copy all option definitions from another Args object into this one. More...
 
size_t count (const UChar *name=nullptr) const
 Check the number of occurences of an option in the last analyzed command line. More...
 
bool debug () const
 Check if debugging is active. More...
 
void debug (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a debug message with a printf-like interface. More...
 
void debug (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a debug message with a printf-like interface. More...
 
void debug (const UString &msg)
 Report a debug message. More...
 
void error (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report an error message with a printf-like interface. More...
 
void error (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report an error message with a printf-like interface. More...
 
void error (const UString &msg)
 Report an error message. More...
 
void exitOnError (bool force=false)
 Exit application when errors were reported in the last analyzed command line. More...
 
void fatal (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a fatal error message with a printf-like interface. More...
 
void fatal (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a fatal error message with a printf-like interface. More...
 
void fatal (const UString &msg)
 Report a fatal error message. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void getBitMaskValue (INT &value, const UChar *name=nullptr, const INT &def_value=static_cast< INT >(0)) const
 Get an OR'ed of all values of an integer option in the last analyzed command line. More...
 
void getCommandArgs (UStringVector &args) const
 Get the command line parameters from the last command line analysis. More...
 
const UStringgetDescription () const
 Get the description of the command. More...
 
int getFlags () const
 Get the option flags of the command. More...
 
virtual UString getHelpText (HelpFormat format, size_t line_width=DEFAULT_LINE_WIDTH) const override
 Get a formatted help text. More...
 
void getHexaValue (ByteBlock &value, const UChar *name=nullptr, const ByteBlock &def_value=ByteBlock(), size_t index=0) const
 Get the value of an hexadecimal option in the last analyzed command line. More...
 
template<typename INT , typename INT2 = INT, typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
void getIntValue (INT &value, const UChar *name=nullptr, const INT2 def_value=static_cast< INT2 >(0), size_t index=0) const
 Get the value of an integer option in the last analyzed command line. More...
 
template<std::size_t N>
void getIntValues (std::bitset< N > &values, const UChar *name=nullptr, bool defValue=false) const
 Get all occurences of an option as a bitmask of values. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void getIntValues (std::set< INT > &values, const UChar *name=nullptr) const
 Get all occurences of an integer option in a set of integers. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void getIntValues (std::vector< INT > &values, const UChar *name=nullptr) const
 Get all occurences of an integer option in a vector of integers. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
void getOptionalIntValue (Variable< INT > &value, const UChar *name=nullptr, bool clear_if_absent=false) const
 Get the value of an integer option in the last analyzed command line, only if present. More...
 
void getOptionalValue (Variable< UString > &value, const UChar *name=nullptr, bool clear_if_absent=false) const
 Get the value of an option in the last analyzed command line, only if present. More...
 
void getPlugin (PluginOptions &plugin, PluginType type, const UChar *def_value=u"", size_t index=0) const
 Get a plugin of a given type, after command line analysis. More...
 
void getPlugins (PluginOptionsVector &plugins, PluginType type) const
 Get all plugins of a given type, after command line analysis. More...
 
const UStringgetShell () const
 Get the "shell" string. More...
 
const UStringgetSyntax () const
 Get the syntax of the command. More...
 
void getTristateValue (Tristate &value, const UChar *name=nullptr, size_t index=0) const
 Get the value of tristate option in the last analyzed command line. More...
 
template<class NUMTYPE , typename INT1 , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value &&std::is_integral< INT1 >::value, int >::type = 0>
void getValue (NUMTYPE &value, const UChar *name, INT1 def_value, size_t index=0) const
 Get the value of an AbstractNumber option in the last analyzed command line. More...
 
template<class NUMTYPE , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value, int >::type = 0>
void getValue (NUMTYPE &value, const UChar *name=nullptr, const NUMTYPE &def_value=NUMTYPE(0), size_t index=0) const
 Get the value of an AbstractNumber option in the last analyzed command line. More...
 
void getValue (UString &value, const UChar *name=nullptr, const UChar *def_value=u"", size_t index=0) const
 Get the value of an option in the last analyzed command line. More...
 
void getValues (UStringVector &values, const UChar *name=nullptr) const
 Get all occurences of an option in a container of strings. More...
 
bool gotErrors () const
 Check if errors (or worse) were reported through this object. More...
 
Argshelp (const UChar *name, const UString &syntax, const UString &text)
 Add the help text of an existing option. More...
 
Argshelp (const UChar *name, const UString &text)
 Add the help text of an existing option. More...
 
ByteBlock hexaValue (const UChar *name=nullptr, const ByteBlock &def_value=ByteBlock(), size_t index=0) const
 Get the value of an hexadecimal option in the last analyzed command line. More...
 
void info (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report an informational message with a printf-like interface. More...
 
void info (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report an informational message with a printf-like interface. More...
 
void info (const UString &msg)
 Report an informational message. More...
 
template<typename INT , typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
INT intValue (const UChar *name=nullptr, const INT def_value=static_cast< INT >(0), size_t index=0) const
 Get the value of an integer option in the last analyzed command line. More...
 
void invalidate ()
 Force en error state in this object, as if an error was reported.
 
virtual void log (int severity, const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a message with an explicit severity and a printf-like interface. More...
 
virtual void log (int severity, const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a message with an explicit severity and a printf-like interface. More...
 
virtual void log (int severity, const UString &msg)
 Report a message with an explicit severity. More...
 
int maxSeverity () const
 Get maximum severity level. More...
 
template<class NUMTYPE , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value, int >::type = 0>
NUMTYPE numValue (const UChar *name=nullptr, const NUMTYPE &def_value=NUMTYPE(0), size_t index=0) const
 Get the value of an AbstractNumber option in the last analyzed command line. More...
 
Argsoption (const UChar *name, UChar short_name, const Enumeration &enumeration, size_t min_occur=0, size_t max_occur=0, bool optional=false)
 Add the definition of an option, the value being from an enumeration type. More...
 
template<class NUMTYPE , typename INT1 = int64_t, typename INT2 = int64_t, typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value &&std::is_integral< INT1 >::value &&std::is_integral< INT2 >::value, int >::type = 0>
Argsoption (const UChar *name, UChar short_name=0, size_t min_occur=0, size_t max_occur=0, INT1 min_value=std::numeric_limits< INT2 >::min(), INT2 max_value=std::numeric_limits< INT1 >::max(), bool optional=false)
 Add the definition of an option, the value being an instance of AbstractNumber. More...
 
Argsoption (const UChar *name=nullptr, UChar short_name=0, ArgType type=NONE, size_t min_occur=0, size_t max_occur=0, int64_t min_value=0, int64_t max_value=0, bool optional=false, size_t decimals=0)
 Add the definition of an option. More...
 
UString optionNames (const UChar *name, const UString &separator=u", ") const
 When an option has an Enumeration type, get a list of all valid names. More...
 
size_t pluginCount (PluginType type) const
 Get the number of plugins of a given type, after command line analysis. More...
 
bool present (const UChar *name=nullptr) const
 Check if an option is present in the last analyzed command line. More...
 
bool processArgsRedirection (UStringVector &args)
 Process argument redirection using '@' on a vector of strings. More...
 
virtual void raiseMaxSeverity (int level) override
 Raise maximum severity level. More...
 
ReportredirectReport (Report *report)
 Redirect report logging. More...
 
void resetErrors ()
 Reset the error indicator. More...
 
void setAppName (const UString &name)
 Set the initial application name (will be overwritten at next command analysis). More...
 
virtual void setDescription (const UString &description)
 Set the description of the command. More...
 
virtual void setFlags (int flags)
 Set the option flags of the command. More...
 
virtual void setIntro (const UString &intro)
 Set the introduction or preamble text for help description. More...
 
virtual void setMaxSeverity (int level)
 Set maximum severity level. More...
 
void setShell (const UString &shell)
 Set the "shell" string. More...
 
virtual void setSyntax (const UString &syntax) override
 Set the syntax of the command. More...
 
virtual void setTail (const UString &tail)
 Set the conclusion or tailing text for help description. More...
 
void severe (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a severe error message with a printf-like interface. More...
 
void severe (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a severe error message with a printf-like interface. More...
 
void severe (const UString &msg)
 Report a severe error message. More...
 
Tristate tristateValue (const UChar *name=nullptr, size_t index=0) const
 Get the value of tristate option in the last analyzed command line. More...
 
bool valid () const
 Check if options were correct during the last command line analysis. More...
 
UString value (const UChar *name=nullptr, const UChar *def_value=u"", size_t index=0) const
 Get the value of an option in the last analyzed command line. More...
 
bool verbose () const
 Check if verbose reporting is active. More...
 
void verbose (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a verbose message with a printf-like interface. More...
 
void verbose (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a verbose message with a printf-like interface. More...
 
void verbose (const UString &msg)
 Report a verbose message. More...
 
void warning (const UChar *fmt, std::initializer_list< ArgMixIn > args)
 Report a warning message with a printf-like interface. More...
 
void warning (const UString &fmt, std::initializer_list< ArgMixIn > args)
 Report a warning message with a printf-like interface. More...
 
void warning (const UString &msg)
 Report a warning message. More...
 

Static Public Member Functions

static UString GetAppName (int argc, char *argv[])
 Get the application name from a standard argc/argv pair. More...
 

Static Public Attributes

static constexpr size_t DEFAULT_LINE_WIDTH = 79
 Default line width for help texts.
 
static const Enumeration HelpFormatEnum
 Enumeration description of HelpFormat. More...
 
static const size_t UNLIMITED_COUNT
 Unlimited number of occurences. More...
 
static const int64_t UNLIMITED_VALUE
 Unlimited value. More...
 

Protected Member Functions

virtual void writeLog (int severity, const UString &message) override
 Actual message reporting method. More...
 

Protected Attributes

volatile int _max_severity
 Debug level is accessible to subclasses.
 

Detailed Description

Command line arguments for commands with plugins.

The command line is analyzed, keeping command-specific options and plugin descriptions apart.

The option --list-plugins is automatically added and processed.

Member Enumeration Documentation

◆ Flags

enum ts::Args::Flags
inherited

Args object flags, used in an or'ed mask.

Enumerator
NO_ERROR_DISPLAY 

Don't display errors.

NO_EXIT_ON_ERROR 

Don't terminate application on error.

NO_EXIT_ON_HELP 

Don't terminate application on --help.

NO_EXIT_ON_VERSION 

Don't terminate application on --version.

GATHER_PARAMETERS 

Specifies that all options must be placed before the parameters.

Once the first parameter is found, all subsequent elements on the command line are considered as parameters, even if they start with '-' or '--'.

HELP_ON_THIS 

Display help using info() on this object, not standard error.

NO_DEBUG 

No predefined option "--debug".

NO_HELP 

No predefined option "--help".

NO_VERBOSE 

No predefined option "--verbose".

NO_VERSION 

No predefined option "--version".

NO_CONFIG_FILE 

No default option from the configuration file.

◆ ArgType

enum ts::Args::ArgType
inherited

Type of an argument or parameter.

Enumerator
NONE 

Option without argument.

STRING 

Uninterpreted string argument.

FILENAME 

String argument which will be interpreted as a file name.

DIRECTORY 

String argument which will be interpreted as a directory name.

HEXADATA 

String argument which will be interpreted as a suite of hexadecimal digits.

INTEGER 

Integer argument, must set min & max values.

UNSIGNED 

Integer 0..unlimited.

POSITIVE 

Integer 1..unlimited.

UINT8 

Integer 0..0xFF.

UINT16 

Integer 0..0xFFFF.

UINT32 

Integer 0..0xFFFFFFFF.

UINT63 

63-bit unsigned (cannot represent 2^63 and higher).

PIDVAL 

Integer 0..0x1FFF (an MPEG PID value).

INT8 

Integer -128..127.

INT16 

Integer -32,768..32,767.

INT32 

Integer -2,147,483,648..2,147,483,647.

INT64 

64-bit signed.

ANUMBER 

A subclass of AbstractNumber.

TRISTATE 

Tristate value, ts::Maybe if absent.

◆ HelpFormat

enum ts::Args::HelpFormat
inherited

Types of help formatting, for getHelpText() and predefined option --help.

Enumerator
HELP_NAME 

Application name only.

HELP_DESCRIPTION 

One-line description.

HELP_USAGE 

Formatted command line syntax.

HELP_SYNTAX 

One-line command line syntax.

HELP_FULL 

Full help text.

HELP_OPTIONS 

Options names, one by line.

Constructor & Destructor Documentation

◆ ArgsWithPlugins()

ts::ArgsWithPlugins::ArgsWithPlugins ( size_t  min_inputs = 0,
size_t  max_inputs = UNLIMITED_COUNT,
size_t  min_plugins = 0,
size_t  max_plugins = UNLIMITED_COUNT,
size_t  min_outputs = 0,
size_t  max_outputs = UNLIMITED_COUNT,
const UString description = UString(),
const UString syntax = UString(),
int  flags = 0 
)

Constructor.

Parameters
[in]min_inputsMinimum number of input plugins.
[in]max_inputsMaximum number of input plugins.
[in]min_pluginsMinimum number of packet processor plugins.
[in]max_pluginsMaximum number of packet processor plugins.
[in]min_outputsMinimum number of output plugins.
[in]max_outputsMaximum number of output plugins.
[in]descriptionA short one-line description.
[in]syntaxA short one-line syntax summary.
[in]flagsAn or'ed mask of Flags values.

Member Function Documentation

◆ analyze() [1/3]

virtual bool ts::ArgsWithPlugins::analyze ( const UString command,
bool  processRedirections = true 
)
overridevirtual

Load command arguments and analyze them.

Normally, in case of error or if --help or --version is specified, the application is automatically terminated. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Parameters
[in]commandFull command line, with application name and parameters. Parameters are separated with spaces. Special characters and spaces must be escaped or quoted in the parameters.
[in]processRedirectionsIf true (the default), process command line arguments redirection. All lines with the form '@filename' are replaced by the content of filename.
Returns
By default, always return true or the application is automatically terminated in case of error. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Reimplemented from ts::Args.

◆ analyze() [2/3]

virtual bool ts::ArgsWithPlugins::analyze ( int  argc,
char *  argv[],
bool  processRedirections = true 
)
overridevirtual

Load command arguments and analyze them.

Normally, in case of error or if --help or --version is specified, the application is automatically terminated. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Parameters
[in]argcNumber of arguments from command line.
[in]argvArguments from command line. The application name is in argv[0]. The subsequent elements contain the arguments.
[in]processRedirectionsIf true (the default), process command line arguments redirection. All lines with the form '@filename' are replaced by the content of filename.
Returns
By default, always return true or the application is automatically terminated in case of error. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Reimplemented from ts::Args.

◆ analyze() [3/3]

virtual bool ts::ArgsWithPlugins::analyze ( const UString app_name,
const UStringVector arguments,
bool  processRedirections = true 
)
overridevirtual

Load command arguments and analyze them.

Normally, in case of error or if --help or --version is specified, the application is automatically terminated. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Parameters
[in]app_nameApplication name.
[in]argumentsArguments from command line.
[in]processRedirectionsIf true (the default), process command line arguments redirection. All lines with the form '@filename' are replaced by the content of filename.
Returns
By default, always return true or the application is automatically terminated in case of error. If some flags prevent the termination of the application, return true if the command is correct, false if the command is incorrect or --help or --version is specified.

Reimplemented from ts::Args.

◆ getHelpText()

virtual UString ts::ArgsWithPlugins::getHelpText ( HelpFormat  format,
size_t  line_width = DEFAULT_LINE_WIDTH 
) const
overridevirtual

Get a formatted help text.

Parameters
[in]formatRequested format of the help text.
[in]line_widthMaximum width of text lines.
Returns
The formatted help text.

Reimplemented from ts::Args.

◆ setSyntax()

virtual void ts::ArgsWithPlugins::setSyntax ( const UString syntax)
overridevirtual

Set the syntax of the command.

Parameters
[in]syntaxA short one-line syntax summary, e.g. "[options] filename ...".

Reimplemented from ts::Args.

◆ pluginCount()

size_t ts::ArgsWithPlugins::pluginCount ( PluginType  type) const

Get the number of plugins of a given type, after command line analysis.

Parameters
[in]typeType of plugin to find.
Returns
The number of plugins of that type.

◆ getPlugin()

void ts::ArgsWithPlugins::getPlugin ( PluginOptions plugin,
PluginType  type,
const UChar def_value = u"",
size_t  index = 0 
) const

Get a plugin of a given type, after command line analysis.

Parameters
[out]pluginReturned name and arguments of the plugin.
[in]typeType of plugin to find.
[in]def_valueThe plugin name to set in plugin if the plugin is not present.
[in]indexIndex of the plugin to find.

◆ getPlugins()

void ts::ArgsWithPlugins::getPlugins ( PluginOptionsVector plugins,
PluginType  type 
) const

Get all plugins of a given type, after command line analysis.

Parameters
[out]pluginsReturned name and arguments of the plugins.
[in]typeType of plugin to find.

◆ option() [1/3]

Args& ts::Args::option ( const UChar name = nullptr,
UChar  short_name = 0,
ArgType  type = NONE,
size_t  min_occur = 0,
size_t  max_occur = 0,
int64_t  min_value = 0,
int64_t  max_value = 0,
bool  optional = false,
size_t  decimals = 0 
)
inlineinherited

Add the definition of an option.

This method is typically invoked in the constructor of a subclass.

Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]short_nameOptional one letter short name.
[in]typeOption or parameter value type.
[in]min_occurMinimum number of occurences of this option on the command line, ignored if type is NONE.
[in]max_occurMaximum number of occurences, ignored if type is NONE, 0 means default (1 for an option, unlimited for a parameters).
[in]min_valueMinimum value for integer, minimum size for string and hexa data.
[in]max_valueMaximum value for integer, maximum size for string and hexa data.
[in]optionalWhen true, the option's value is optional.
[in]decimalsReference number of decimal digits. When decimals is greater than zero, the result is automatically adjusted by the corresponding power of ten. For instance, when decimals is 3, u"12" returns 12000, u"12.34" returns 12340 and "12.345678" returns 12345. All extra decimals are accepted but ignored.
Returns
A reference to this instance.

◆ option() [2/3]

Args& ts::Args::option ( const UChar name,
UChar  short_name,
const Enumeration enumeration,
size_t  min_occur = 0,
size_t  max_occur = 0,
bool  optional = false 
)
inlineinherited

Add the definition of an option, the value being from an enumeration type.

This method is typically invoked in the constructor of a subclass.

Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]short_nameOptional one letter short name.
[in]enumerationList of enumeration values. The command line parameter value can be a string describing an enumeration value or directly an integer value. In the application, the option's value is always the integer value of the enumeration value.
[in]min_occurMinimum number of occurences of this option on the command line.
[in]max_occurMaximum number of occurences. 0 means default : 1 for an option, unlimited for a parameters.
[in]optionalWhen true, the option's value is optional.
Returns
A reference to this instance.

◆ option() [3/3]

template<class NUMTYPE , typename INT1 = int64_t, typename INT2 = int64_t, typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value &&std::is_integral< INT1 >::value &&std::is_integral< INT2 >::value, int >::type = 0>
Args& ts::Args::option ( const UChar name,
UChar  short_name = 0,
size_t  min_occur = 0,
size_t  max_occur = 0,
INT1  min_value = std::numeric_limits<INT2>::min(),
INT2  max_value = std::numeric_limits<INT1>::max(),
bool  optional = false 
)
inlineinherited

Add the definition of an option, the value being an instance of AbstractNumber.

This method is typically invoked in the constructor of a subclass of Args.

Template Parameters
NUMTYPEA subclass of AbstractNumber.
Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]short_nameOptional one letter short name.
[in]min_occurMinimum number of occurences of this option on the command line.
[in]max_occurMaximum number of occurences. 0 means default : 1 for an option, unlimited for a parameters.
[in]min_valueMinimum value. Use an integer value, not a NUMTYPE value.
[in]max_valueMaximum value. Use an integer value, not a NUMTYPE value
[in]optionalWhen true, the option's value is optional.
Returns
A reference to this instance.

◆ help() [1/2]

Args& ts::Args::help ( const UChar name,
const UString syntax,
const UString text 
)
inherited

Add the help text of an existing option.

Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]syntaxString to display for the option value instead of the default "value". For instance: "address:port" "'string'".
[in]textHelp text. Unformatted, line breaks will be added automatically.
Returns
A reference to this instance.

◆ help() [2/2]

Args& ts::Args::help ( const UChar name,
const UString text 
)
inlineinherited

Add the help text of an existing option.

Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]textHelp text. Unformatted, line breaks will be added automatically.
Returns
A reference to this instance.

◆ optionNames()

UString ts::Args::optionNames ( const UChar name,
const UString separator = u", " 
) const
inherited

When an option has an Enumeration type, get a list of all valid names.

Parameters
[in]nameLong name of option. 0 or "" means a parameter, not an option.
[in]separatorThe separator to be used between values, a comma by default.
Returns
A comma-separated list of all possible names.
See also
Enumeration::nameList()

◆ copyOptions()

Args& ts::Args::copyOptions ( const Args other,
const bool  replace = false 
)
inherited

Copy all option definitions from another Args object into this one.

This method is typically invoked in the constructor of a subclass to import all option definitions of another instance.

Parameters
[in]otherAnother instance from which to get the options.
[in]replaceIf true, override duplicated options which were already declared in this object. If false (the default), duplicated options are ignored.
Returns
A reference to this object.

◆ setDescription()

virtual void ts::Args::setDescription ( const UString description)
virtualinherited

Set the description of the command.

Parameters
[in]descriptionA short one-line description, e.g. "Wonderful File Copier".

◆ setIntro()

virtual void ts::Args::setIntro ( const UString intro)
virtualinherited

Set the introduction or preamble text for help description.

Parameters
[in]introIntroduction text.

◆ setTail()

virtual void ts::Args::setTail ( const UString tail)
virtualinherited

Set the conclusion or tailing text for help description.

Parameters
[in]tailTailing text.

◆ setFlags()

virtual void ts::Args::setFlags ( int  flags)
virtualinherited

Set the option flags of the command.

Parameters
[in]flagsDefine various options, a combination of or'ed values from Flags.

◆ getDescription()

const UString& ts::Args::getDescription ( ) const
inlineinherited

Get the description of the command.

Returns
A short one-line description of the command.

◆ getSyntax()

const UString& ts::Args::getSyntax ( ) const
inlineinherited

Get the syntax of the command.

Returns
A short one-line syntax summary of the command.

◆ getFlags()

int ts::Args::getFlags ( ) const
inlineinherited

Get the option flags of the command.

Returns
A combination of or'ed values from Flags.

◆ setAppName()

void ts::Args::setAppName ( const UString name)
inlineinherited

Set the initial application name (will be overwritten at next command analysis).

Parameters
[in]nameApplication name string.

◆ setShell()

void ts::Args::setShell ( const UString shell)
inlineinherited

Set the "shell" string.

The shell string is an optional prefix for the syntax line as displayed by the --help predefined option. The shell name is displayed before the application name.

Parameters
[in]shellShell name string.

◆ getShell()

const UString& ts::Args::getShell ( ) const
inlineinherited

Get the "shell" string.

Returns
The shell name string.
See also
setShell()

◆ valid()

bool ts::Args::valid ( ) const
inlineinherited

Check if options were correct during the last command line analysis.

Returns
True if the last analyze() completed successfully.

◆ appName()

UString ts::Args::appName ( ) const
inlineinherited

Get the application name from the last command line analysis.

Returns
The application name from the last command line analysis.

◆ GetAppName()

static UString ts::Args::GetAppName ( int  argc,
char *  argv[] 
)
staticinherited

Get the application name from a standard argc/argv pair.

Parameters
[in]argcNumber of arguments from command line.
[in]argvArguments from command line.
Returns
The corresponding application name.

◆ getCommandArgs()

void ts::Args::getCommandArgs ( UStringVector args) const
inlineinherited

Get the command line parameters from the last command line analysis.

Parameters
[out]argsThe command parameters from the last command line analysis.

◆ commandLine()

UString ts::Args::commandLine ( ) const
inherited

Get the full command line from the last command line analysis.

Returns
The full command line from the last command line analysis. It contains the application name and arguments. Special characters are escaped or quoted.

◆ present()

bool ts::Args::present ( const UChar name = nullptr) const
inherited

Check if an option is present in the last analyzed command line.

Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
Returns
True if the corresponding option or parameter is present on the command line, false otherwise.

◆ count()

size_t ts::Args::count ( const UChar name = nullptr) const
inherited

Check the number of occurences of an option in the last analyzed command line.

Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
Returns
The number of occurences of the corresponding option or parameter in the command line.

◆ getValue() [1/3]

void ts::Args::getValue ( UString value,
const UChar name = nullptr,
const UChar def_value = u"",
size_t  index = 0 
) const
inherited

Get the value of an option in the last analyzed command line.

Parameters
[out]valueA string receiving the value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
[in]def_valueThe string to return in value if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ getValue() [2/3]

template<class NUMTYPE , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value, int >::type = 0>
void ts::Args::getValue ( NUMTYPE &  value,
const UChar name = nullptr,
const NUMTYPE &  def_value = NUMTYPE(0),
size_t  index = 0 
) const
inherited

Get the value of an AbstractNumber option in the last analyzed command line.

If the option has been declared with an AbstractNumber type in the syntax of the command, the validity of the supplied option value has been checked by the analyze() method. If analyze() did not fail, the option value is guaranteed to be in the declared range.

Template Parameters
NUMTYPEA subclass of AbstractNumber.
Parameters
[out]valueA variable receiving the value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ getValue() [3/3]

template<class NUMTYPE , typename INT1 , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value &&std::is_integral< INT1 >::value, int >::type = 0>
void ts::Args::getValue ( NUMTYPE &  value,
const UChar name,
INT1  def_value,
size_t  index = 0 
) const
inlineinherited

Get the value of an AbstractNumber option in the last analyzed command line.

If the option has been declared with an AbstractNumber type in the syntax of the command, the validity of the supplied option value has been checked by the analyze() method. If analyze() did not fail, the option value is guaranteed to be in the declared range.

Template Parameters
NUMTYPEA subclass of AbstractNumber.
Parameters
[out]valueA variable receiving the value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ value()

UString ts::Args::value ( const UChar name = nullptr,
const UChar def_value = u"",
size_t  index = 0 
) const
inherited

Get the value of an option in the last analyzed command line.

Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
[in]def_valueThe string to return if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.
Returns
The value of the option or parameter.

◆ getOptionalValue()

void ts::Args::getOptionalValue ( Variable< UString > &  value,
const UChar name = nullptr,
bool  clear_if_absent = false 
) const
inherited

Get the value of an option in the last analyzed command line, only if present.

Parameters
[in,out]valueA variable string receiving the value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
[in]clear_if_absentWhen the option is not present, the Variable object is cleared (set to uninitialized) when clear_if_absent it true. Otherwise, it is left unmodified.

◆ getValues()

void ts::Args::getValues ( UStringVector values,
const UChar name = nullptr 
) const
inherited

Get all occurences of an option in a container of strings.

Parameters
[out]valuesA container of strings receiving all values of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.

◆ getIntValue()

template<typename INT , typename INT2 = INT, typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
void ts::Args::getIntValue ( INT value,
const UChar name = nullptr,
const INT2  def_value = static_cast< INT2 >(0),
size_t  index = 0 
) const
inherited

Get the value of an integer option in the last analyzed command line.

If the option has been declared with an integer type in the syntax of the command, the validity of the supplied option value has been checked by the analyze() method. If analyze() did not fail, the option value is guaranteed to be in the declared range.

Template Parameters
INTAn integer or enumeration type for the result.
Parameters
[out]valueA variable receiving the integer value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ intValue()

template<typename INT , typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
INT ts::Args::intValue ( const UChar name = nullptr,
const INT  def_value = static_cast< INT >(0),
size_t  index = 0 
) const
inherited

Get the value of an integer option in the last analyzed command line.

Template Parameters
INTAn integer or enumeration type for the result.
Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.
Returns
The integer value of the option or parameter.

◆ getOptionalIntValue()

template<typename INT , typename std::enable_if< std::is_integral< INT >::value||std::is_enum< INT >::value >::type * = nullptr>
void ts::Args::getOptionalIntValue ( Variable< INT > &  value,
const UChar name = nullptr,
bool  clear_if_absent = false 
) const
inherited

Get the value of an integer option in the last analyzed command line, only if present.

Template Parameters
INTAn integer or enumeration type for the result.
Parameters
[in,out]valueA variable integer receiving the value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
[in]clear_if_absentWhen the option is not present, the Variable object is cleared (set to uninitialized) when clear_if_absent it true. Otherwise, it is left unmodified.

◆ getIntValues() [1/3]

template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void ts::Args::getIntValues ( std::vector< INT > &  values,
const UChar name = nullptr 
) const
inherited

Get all occurences of an integer option in a vector of integers.

Parameters
[out]valuesA container of integers receiving all values of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.

◆ getIntValues() [2/3]

template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void ts::Args::getIntValues ( std::set< INT > &  values,
const UChar name = nullptr 
) const
inherited

Get all occurences of an integer option in a set of integers.

Parameters
[out]valuesA container of integers receiving all values of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.

◆ getIntValues() [3/3]

template<std::size_t N>
void ts::Args::getIntValues ( std::bitset< N > &  values,
const UChar name = nullptr,
bool  defValue = false 
) const
inherited

Get all occurences of an option as a bitmask of values.

Parameters
[out]valuesA bitset receiving all values of the option or parameter. For each value of the option, the corresponding bit is set. Values which are out of range are ignored.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command, a fatal error is reported.
[in]defValueThe boolean to set in all values if the option or parameter is not present in the command line.

◆ bitMaskValue()

template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
INT ts::Args::bitMaskValue ( const UChar name = nullptr,
const INT def_value = static_cast< INT >(0) 
) const
inherited

Get an OR'ed of all values of an integer option in the last analyzed command line.

This method is typically useful when the values of an option are taken from an Enumeration and each value is a bit mask. When specifying several values, the result of this method is a mask of all specified options.

Template Parameters
INTAn integer type for the result.
Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line.
Returns
The OR'ed values of the integer option.

◆ getBitMaskValue()

template<typename INT , typename std::enable_if< std::is_integral< INT >::value >::type * = nullptr>
void ts::Args::getBitMaskValue ( INT value,
const UChar name = nullptr,
const INT def_value = static_cast< INT >(0) 
) const
inherited

Get an OR'ed of all values of an integer option in the last analyzed command line.

This method is typically useful when the values of an option are taken from an Enumeration and each value is a bit mask. When specifying several values, the result of this method is a mask of all specified options.

Template Parameters
INTAn integer type for the result.
Parameters
[out]valueA variable receiving the OR'ed values of the integer option.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line.

◆ getTristateValue()

void ts::Args::getTristateValue ( Tristate value,
const UChar name = nullptr,
size_t  index = 0 
) const
inherited

Get the value of tristate option in the last analyzed command line.

Parameters
[out]valueA variable receiving the tristate value of the option or parameter. The returned value is always one of the three valid Tristate values. When the option or parameter is not present in the command line or with fewer occurences than index, the returned value is Maybe. For options with optional values, if the the option is present without value, the returned value is TRUE.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ tristateValue()

Tristate ts::Args::tristateValue ( const UChar name = nullptr,
size_t  index = 0 
) const
inherited

Get the value of tristate option in the last analyzed command line.

Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]indexThe occurence of the option to return. Zero designates the first occurence.
Returns
The tristate value of the option or parameter. The returned value is always one of the three valid Tristate values. When the option or parameter is not present in the command line or with fewer occurences than index, the returned value is Maybe. For options with optional values, if the the option is present without value, the returned value is TRUE.

◆ getHexaValue()

void ts::Args::getHexaValue ( ByteBlock value,
const UChar name = nullptr,
const ByteBlock def_value = ByteBlock(),
size_t  index = 0 
) const
inherited

Get the value of an hexadecimal option in the last analyzed command line.

Parameters
[out]valueA variable receiving the decoded binary value of the option or parameter.
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe string to return if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.

◆ hexaValue()

ByteBlock ts::Args::hexaValue ( const UChar name = nullptr,
const ByteBlock def_value = ByteBlock(),
size_t  index = 0 
) const
inherited

Get the value of an hexadecimal option in the last analyzed command line.

Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe string to return if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.
Returns
The decoded binary value of the option or parameter.

◆ numValue()

template<class NUMTYPE , typename std::enable_if< std::is_base_of< AbstractNumber, NUMTYPE >::value, int >::type = 0>
NUMTYPE ts::Args::numValue ( const UChar name = nullptr,
const NUMTYPE &  def_value = NUMTYPE(0),
size_t  index = 0 
) const
inherited

Get the value of an AbstractNumber option in the last analyzed command line.

If the option has been declared with an AbstractNumber type in the syntax of the command, the validity of the supplied option value has been checked by the analyze() method. If analyze() did not fail, the option value is guaranteed to be in the declared range.

Template Parameters
NUMTYPEA subclass of AbstractNumber.
Parameters
[in]nameThe full name of the option. If the parameter is a null pointer or an empty string, this specifies a parameter, not an option. If the specified option was not declared in the syntax of the command or declared as a non-string type, a fatal error is reported.
[in]def_valueThe value to return in value if the option or parameter is not present in the command line or with fewer occurences than index.
[in]indexThe occurence of the option to return. Zero designates the first occurence.
Returns
The value of the option or parameter.

◆ exitOnError()

void ts::Args::exitOnError ( bool  force = false)
inherited

Exit application when errors were reported in the last analyzed command line.

Parameters
[in]forceIf true, ignore flag NO_EXIT_ON_ERROR and force application termination on error.

◆ redirectReport()

Report* ts::Args::redirectReport ( Report report)
inherited

Redirect report logging.

Parameters
[in]reportWhere to report errors. The redirection is cancelled if zero.
Returns
The previous redirected report.

◆ raiseMaxSeverity()

virtual void ts::Args::raiseMaxSeverity ( int  level)
overridevirtualinherited

Raise maximum severity level.

Parameters
[in]levelSet report at least to that level.

Reimplemented from ts::Report.

◆ processArgsRedirection()

bool ts::Args::processArgsRedirection ( UStringVector args)
inherited

Process argument redirection using '@' on a vector of strings.

Parameters
[in,out]argsA vector of strings. All lines of the form '@filename' are replaced by the content of the given file. A double '@@' at the beginning of a line is replaced by a single '@' without reading a file.
Returns
True on success, false on error (non existent file for instance). Errors are reported though this object.

◆ writeLog()

virtual void ts::Args::writeLog ( int  severity,
const UString msg 
)
overrideprotectedvirtualinherited

Actual message reporting method.

Must be implemented in actual classes. The method is called only when a message passed the severity filter. It is not necessary to recheck severity inside the method.

Parameters
[in]severityMessage severity.
[in]msgMessage text.

Implements ts::Report.

Reimplemented in ts::Plugin.

◆ setMaxSeverity()

virtual void ts::Report::setMaxSeverity ( int  level)
virtualinherited

Set maximum severity level.

Messages with higher severities are not reported.

Parameters
[in]levelSet report to that level.

Reimplemented in ts::ReportWithPrefix.

◆ maxSeverity()

int ts::Report::maxSeverity ( ) const
inlineinherited

Get maximum severity level.

Returns
Current maximum debug level.

◆ debug() [1/4]

bool ts::Report::debug ( ) const
inlineinherited

Check if debugging is active.

Returns
True if current reporting level is Debug or higher.

◆ debug() [2/4]

void ts::Report::debug ( const UString msg)
inlineinherited

Report a debug message.

Parameters
[in]msgMessage text.

◆ debug() [3/4]

void ts::Report::debug ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a debug message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ debug() [4/4]

void ts::Report::debug ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a debug message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ verbose() [1/4]

bool ts::Report::verbose ( ) const
inlineinherited

Check if verbose reporting is active.

Returns
True if current reporting level is Verbose or higher.

◆ verbose() [2/4]

void ts::Report::verbose ( const UString msg)
inlineinherited

Report a verbose message.

Parameters
[in]msgMessage text.

◆ verbose() [3/4]

void ts::Report::verbose ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a verbose message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ verbose() [4/4]

void ts::Report::verbose ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a verbose message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ log() [1/3]

virtual void ts::Report::log ( int  severity,
const UString msg 
)
virtualinherited

Report a message with an explicit severity.

This method is the central reporting point. If filters the severity and drops the message if severity is higher than maxSeverity().

Subclasses should override writeLog() to implement a specific reporting device. It is not necessary to override log() unless the subclass needs to implement a different severity filtering policy.

Parameters
[in]severityMessage severity.
[in]msgMessage text.

◆ log() [2/3]

virtual void ts::Report::log ( int  severity,
const UChar fmt,
std::initializer_list< ArgMixIn args 
)
virtualinherited

Report a message with an explicit severity and a printf-like interface.

Parameters
[in]severityMessage severity.
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ log() [3/3]

virtual void ts::Report::log ( int  severity,
const UString fmt,
std::initializer_list< ArgMixIn args 
)
virtualinherited

Report a message with an explicit severity and a printf-like interface.

Parameters
[in]severityMessage severity.
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ fatal() [1/3]

void ts::Report::fatal ( const UString msg)
inlineinherited

Report a fatal error message.

Parameters
[in]msgMessage text.

◆ fatal() [2/3]

void ts::Report::fatal ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a fatal error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ fatal() [3/3]

void ts::Report::fatal ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a fatal error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ severe() [1/3]

void ts::Report::severe ( const UString msg)
inlineinherited

Report a severe error message.

Parameters
[in]msgMessage text.

◆ severe() [2/3]

void ts::Report::severe ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a severe error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ severe() [3/3]

void ts::Report::severe ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a severe error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ error() [1/3]

void ts::Report::error ( const UString msg)
inlineinherited

Report an error message.

Parameters
[in]msgMessage text.

◆ error() [2/3]

void ts::Report::error ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report an error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ error() [3/3]

void ts::Report::error ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report an error message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ warning() [1/3]

void ts::Report::warning ( const UString msg)
inlineinherited

Report a warning message.

Parameters
[in]msgMessage text.

◆ warning() [2/3]

void ts::Report::warning ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a warning message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ warning() [3/3]

void ts::Report::warning ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report a warning message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ info() [1/3]

void ts::Report::info ( const UString msg)
inlineinherited

Report an informational message.

Parameters
[in]msgMessage text.

◆ info() [2/3]

void ts::Report::info ( const UChar fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report an informational message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ info() [3/3]

void ts::Report::info ( const UString fmt,
std::initializer_list< ArgMixIn args 
)
inlineinherited

Report an informational message with a printf-like interface.

Parameters
[in]fmtFormat string with embedded '%' sequences.
[in]argsList of arguments to substitute in the format string.
See also
UString::format()

◆ gotErrors()

bool ts::Report::gotErrors ( ) const
inlineinherited

Check if errors (or worse) were reported through this object.

Returns
True if errors (or worse) were reported through this object.

◆ resetErrors()

void ts::Report::resetErrors ( )
inlineinherited

Reset the error indicator.

See also
gotErrors()

Member Data Documentation

◆ UNLIMITED_COUNT

const size_t ts::Args::UNLIMITED_COUNT
staticinherited

Unlimited number of occurences.

To be used as value for parameter max_occur to indicate that there is no limit to the number of occurences of an option.

Warning: use only for max_occur (size_t ). Do not use for max_value (int64_t ) since size_t is uint64_t on 64-bit platforms.

◆ UNLIMITED_VALUE

const int64_t ts::Args::UNLIMITED_VALUE
staticinherited

Unlimited value.

To be used as value for parameter @ max_value to indicate that there is no limit to the parameter integer value.

◆ HelpFormatEnum

const Enumeration ts::Args::HelpFormatEnum
staticinherited

Enumeration description of HelpFormat.

Typically used to implement the --help command line option.


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