Qt QCommandLineOption类
QCmandLineOption类定义了可能的命令行选项
头文件:
#include <QCmandLineOption>cmake:
find_package(Qt6 CPONENTS Core REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core)qmake:
QT += core引入:
Qt 5.2详细说明
该类用于描述命令行上的选项。它允许用不同的方式定义同一个选项,并可能使用多个别名。它也用于描述如何使用选项它可以是一个标志(例如v)或一个值(例如o file)。
例子:
1 QCmandLineOption verboseOption("verbose", "Verbose mode. Prints out more information."); 2 QCmandLineOption outputOption(QStringList() << "o" << "output", "Write generated data into <file>.", "file");公开类型
成员函数
QCmandLineOption
QCmandLineOption::QCmandLineOption(const QCmandLineOption &other)
构造一个QCmandLineOption对象,该对象是QCmandLineOption对象other的副本。
参见操作符 operator=().。
QCmandLineOption::QCmandLineOption(const QStringList &names, const QString &description, const QString &valueName = QString(), const QString &defaultValue = QString())
使用给定的参数构造一个命令行选项对象。
此重载允许为选项设置多个名称,例如o和output。
选项的名称设置为names。名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。
描述设置为description。通常在描述的最后加上一个“.”。
此外,如果该选项需要一个值,则需要设置valueName。该选项的默认值设置为defaultValue。
在5.4之前的Qt版本中,这个构造函数是explicit的。它不再是并且可以用于C ++ 11样式的统一初始化:
1 QCmandLineParser parser; 2 parser.addOption(, "Write generated data into <file>.", "file"});另请参见setDescription(),setValueName()和setDefaultValues()。
QCmandLineOption::QCmandLineOption(const QString &name, const QString &description, const QString &valueName = QString(), const QString &defaultValue = QString())
使用给定的参数构造一个命令行选项对象。
此重载允许为选项设置多个名称,例如o和output。
选项的名称设置为names。名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。
描述设置为description。通常在描述的最后加上一个“.”。
此外,如果该选项需要一个值,则需要设置valueName。该选项的默认值设置为defaultValue。
在5.4之前的Qt版本中,这个构造函数是explicit的。它不再是并且可以用于C ++ 11样式的统一初始化:
1 QCmandLineParser parser; 2 parser.addOption();另请参见setDescription(),setValueName()和setDefaultValues()。
QCmandLineOption::QCmandLineOption(const QStringList &names)
构造一个具有名称的命令行选项对象。
这个重载允许为选项设置多个名称,例如o和output。
名字可以短也可以长。列表中长度为一个字符的任何名称都是短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。
请参阅setDescription(), setValueName(),和setDefaultValues()。
QCmandLineOption::QCmandLineOption(const QString &name)
构造名称为name的命令行选项对象。
名称可以短也可以长。如果名称长度为一个字符,则认为它是一个短名称。选项名称不能为空,不能以破折号或斜杠开头,不能包含=并且不能重复。
请参阅setDescription(), setValueName(),和setDefaultValues()。
operator=
[since 5.2]
QCmandLineOption &QCmandLineOption::operator=(QCmandLineOption &&other)
移动其他对象到此QCmandLineOption实例。
此功能是在Qt 5.2中引入的。
QCmandLineOption &QCmandLineOption::operator=(const QCmandLineOption &other)
制作另一个对象的副本,并将其分配给此QCmandLineOption对象。
~QCmandLineOption
QCmandLineOption::~QCmandLineOption()
销毁命令行选项对象。
defaultValues
QStringList QCmandLineOption::defaultValues() const
返回为此选项设置的默认值。
参见setDefaultValues()。
description
QString QCmandLineOption::description() const
返回此选项的描述集。
参见setDescription()。
flags
[since 5.8]QCmandLineOption::Flags QCmandLineOption::flags() const
返回一组影响此命令行选项的标志。
这个函数是在Qt 5.8中引入的。
参见setFlags()和QCmandLineOption::Flags。
names
QStringList QCmandLineOption::names() const
返回为此选项设置的名称。
setDefaultValue
void QCmandLineOption::setDefaultValue(const QString &defaultValue)
将此选项的默认值设置为defaultValue。
如果应用程序的用户没有在命令行上指定该选项,则使用默认值。
如果defaultValue为空,则该选项没有缺省值。
请参阅defaultValues()和setDefaultValues()。
void QCmandLineOption::setDefaultValues(const QStringList &defaultValues)
将此选项使用的默认值列表设置为defaultValues。
如果应用程序的用户没有在命令行上指定该选项,则使用默认值。
请参阅defaultValues()和setDefaultValue()。
setDescription
void QCmandLineOption::setDescription(const QString &description)
将用于此选项的描述设置为description。
习惯上,在描述的最后加上一个“.”。
该描述由QCmandLineParser::showHelp()使用。
参见描述()。
setFlags
[since 5.8]void QCmandLineOption::setFlags(QCmandLineOption::Flags flags)
将影响此命令行选项的标志设置为flags。
这个函数是在Qt 5.8中引入的。
参见flags()和QCmandLineOption:: flags。
setValueName
void QCmandLineOption::setValueName(const QString &valueName)
将文档的期望值的名称设置为valueName。
没有分配值的选项具有类似布尔的行为:用户指定–option或不指定。
分配了值的选项需要为期望值设置名称,以便在帮助输出中记录该选项。名称为o和output且值名称为的选项file将显示为o, output 。
如果您希望该选项仅出现一次,则调用QCmandLineParser :: value();如果您希望该选项多次出现,则调用QCmandLineParser :: values()。
另请参见valueName()。
swap
void QCmandLineOption::swap(QCmandLineOption &other)
使用此选项交换其他选项。此操作非常快,并且永远不会失败。
valueName
QString QCmandLineOption::valueName() const
返回期望值的名称。
如果为空,则该选项不接受值。
参见setValueName()。
上一篇:Qt 通过ADS实现Beckhoff倍福TwinCAT通信
Qt