QCommandLineOption

Inheritance diagram of PySide2.QtCore.QCommandLineOption

Note

This class was introduced in Qt 5.2.

Synopsis

Functions

Detailed Description

The PySide2.QtCore.QCommandLineOption class defines a possible command-line option.

This class is used to describe an option on the command line. It allows different ways of defining the same option with multiple aliases possible. It is also used to describe how the option is used - it may be a flag (e.g. -v ) or take a value (e.g. -o file ).

Examples:

QCommandLineOption verboseOption("verbose", "Verbose mode. Prints out more information.");
QCommandLineOption outputOption(QStringList() << "o" << "output", "Write generated data into <file>.", "file");
class PySide2.QtCore.QCommandLineOption(other)
class PySide2.QtCore.QCommandLineOption(name)
class PySide2.QtCore.QCommandLineOption(name, description[, valueName=""[, defaultValue=""]])
class PySide2.QtCore.QCommandLineOption(names)
class PySide2.QtCore.QCommandLineOption(names, description[, valueName=""[, defaultValue=""]])
Parameters:

Constructs a PySide2.QtCore.QCommandLineOption object that is a copy of the PySide2.QtCore.QCommandLineOption object other .

See also

PySide2.QtCore.QCommandLineOption.operator=()

Constructs a command line option object with the name name .

The name can be either short or long. If the name is one character in length, it is considered a short name. Option names must not be empty, must not start with a dash or a slash character, must not contain a = and cannot be repeated.

Constructs a command line option object with the given arguments.

The name of the option is set to name . The name can be either short or long. If the name is one character in length, it is considered a short name. Option names must not be empty, must not start with a dash or a slash character, must not contain a = and cannot be repeated.

The description is set to description . It is customary to add a “.” at the end of the description.

In addition, the valueName needs to be set if the option expects a value. The default value for the option is set to defaultValue .

In Qt versions before 5.4, this constructor was explicit . In Qt 5.4 and later, it no longer is and can be used for C++11-style uniform initialization:

QCommandLineParser parser;
parser.addOption({"verbose", "Verbose mode. Prints out more information."});

Constructs a command line option object with the names names .

This overload allows to set multiple names for the option, for instance o and output .

The names can be either short or long. Any name in the list that is one character in length is a short name. Option names must not be empty, must not start with a dash or a slash character, must not contain a = and cannot be repeated.

Constructs a command line option object with the given arguments.

This overload allows to set multiple names for the option, for instance o and output .

The names of the option are set to names . The names can be either short or long. Any name in the list that is one character in length is a short name. Option names must not be empty, must not start with a dash or a slash character, must not contain a = and cannot be repeated.

The description is set to description . It is customary to add a “.” at the end of the description.

In addition, the valueName needs to be set if the option expects a value. The default value for the option is set to defaultValue .

In Qt versions before 5.4, this constructor was explicit . In Qt 5.4 and later, it no longer is and can be used for C++11-style uniform initialization:

QCommandLineParser parser;
parser.addOption({{"o", "output"}, "Write generated data into <file>.", "file"});
PySide2.QtCore.QCommandLineOption.Flag
Constant Description
QCommandLineOption.HiddenFromHelp Hide this option in the user-visible help output. All options are visible by default. Setting this flag for a particular option makes it internal, i.e. not listed in the help output.
QCommandLineOption.ShortOptionStyle The option will always be understood as a short option, regardless of what was set by QCommandLineParser.setSingleDashWordOptionMode . This allows flags such as -DDEFINE=VALUE or -I/include/path to be interpreted as short flags even when the parser is in QCommandLineParser.ParseAsLongOptions mode.

Note

This enum was introduced in Qt 5.8.

PySide2.QtCore.QCommandLineOption.defaultValues()
Return type:list of strings

Returns the default values set for this option.

PySide2.QtCore.QCommandLineOption.description()
Return type:unicode

Returns the description set for this option.

PySide2.QtCore.QCommandLineOption.flags()
Return type:PySide2.QtCore.QCommandLineOption.Flags

Returns a set of flags that affect this command-line option.

See also

PySide2.QtCore.QCommandLineOption.setFlags() QCommandLineOption.Flags

PySide2.QtCore.QCommandLineOption.isHidden()
Return type:PySide2.QtCore.bool

Returns true if this option is omitted from the help output, false if the option is listed.

See also

PySide2.QtCore.QCommandLineOption.setHidden() QCommandLineOption.HiddenFromHelp

PySide2.QtCore.QCommandLineOption.names()
Return type:list of strings

Returns the names set for this option.

PySide2.QtCore.QCommandLineOption.setDefaultValue(defaultValue)
Parameters:defaultValue – unicode

Sets the default value used for this option to defaultValue .

The default value is used if the user of the application does not specify the option on the command line.

If defaultValue is empty, the option has no default values.

PySide2.QtCore.QCommandLineOption.setDefaultValues(defaultValues)
Parameters:defaultValues – list of strings

Sets the list of default values used for this option to defaultValues .

The default values are used if the user of the application does not specify the option on the command line.

PySide2.QtCore.QCommandLineOption.setDescription(description)
Parameters:description – unicode

Sets the description used for this option to description .

It is customary to add a “.” at the end of the description.

The description is used by QCommandLineParser.showHelp() .

PySide2.QtCore.QCommandLineOption.setFlags(aflags)
Parameters:aflagsPySide2.QtCore.QCommandLineOption.Flags

Set the set of flags that affect this command-line option to flags .

See also

PySide2.QtCore.QCommandLineOption.flags() QCommandLineOption.Flags

PySide2.QtCore.QCommandLineOption.setHidden(hidden)
Parameters:hiddenPySide2.QtCore.bool

Sets whether to hide this option in the user-visible help output.

All options are visible by default. Setting hide to true for a particular option makes it internal, i.e. not listed in the help output.

PySide2.QtCore.QCommandLineOption.setValueName(name)
Parameters:name – unicode

Sets the name of the expected value, for the documentation, to valueName .

Options without a value assigned have a boolean-like behavior: either the user specifies –option or they don’t.

Options with a value assigned need to set a name for the expected value, for the documentation of the option in the help output. An option with names o and output , and a value name of file will appear as -o, --output <file> .

Call QCommandLineParser.value() if you expect the option to be present only once, and QCommandLineParser.values() if you expect that option to be present multiple times.

PySide2.QtCore.QCommandLineOption.swap(other)
Parameters:otherPySide2.QtCore.QCommandLineOption

Swaps option other with this option. This operation is very fast and never fails.

PySide2.QtCore.QCommandLineOption.valueName()
Return type:unicode

Returns the name of the expected value.

If empty, the option doesn’t take a value.