| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 David Faure <faure@kde.org> |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the documentation of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:BSD$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** BSD License Usage |
| ** Alternatively, you may use this file under the terms of the BSD license |
| ** as follows: |
| ** |
| ** "Redistribution and use in source and binary forms, with or without |
| ** modification, are permitted provided that the following conditions are |
| ** met: |
| ** * Redistributions of source code must retain the above copyright |
| ** notice, this list of conditions and the following disclaimer. |
| ** * Redistributions in binary form must reproduce the above copyright |
| ** notice, this list of conditions and the following disclaimer in |
| ** the documentation and/or other materials provided with the |
| ** distribution. |
| ** * Neither the name of The Qt Company Ltd nor the names of its |
| ** contributors may be used to endorse or promote products derived |
| ** from this software without specific prior written permission. |
| ** |
| ** |
| ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #include <qcommandlineparser.h> |
| |
| int main(int argc, char **argv) |
| { |
| |
| { |
| QCommandLineParser parser; |
| //! [0] |
| bool verbose = parser.isSet("verbose"); |
| //! [0] |
| } |
| |
| { |
| //! [1] |
| QCoreApplication app(argc, argv); |
| QCommandLineParser parser; |
| QCommandLineOption verboseOption("verbose"); |
| parser.addOption(verboseOption); |
| parser.process(app); |
| bool verbose = parser.isSet(verboseOption); |
| //! [1] |
| } |
| |
| { |
| QCommandLineParser parser; |
| //! [2] |
| // Usage: image-editor file |
| // |
| // Arguments: |
| // file The file to open. |
| parser.addPositionalArgument("file", QCoreApplication::translate("main", "The file to open.")); |
| |
| // Usage: web-browser [urls...] |
| // |
| // Arguments: |
| // urls URLs to open, optionally. |
| parser.addPositionalArgument("urls", QCoreApplication::translate("main", "URLs to open, optionally."), "[urls...]"); |
| |
| // Usage: cp source destination |
| // |
| // Arguments: |
| // source Source file to copy. |
| // destination Destination directory. |
| parser.addPositionalArgument("source", QCoreApplication::translate("main", "Source file to copy.")); |
| parser.addPositionalArgument("destination", QCoreApplication::translate("main", "Destination directory.")); |
| //! [2] |
| } |
| |
| { |
| //! [3] |
| QCoreApplication app(argc, argv); |
| QCommandLineParser parser; |
| |
| parser.addPositionalArgument("command", "The command to execute."); |
| |
| // Call parse() to find out the positional arguments. |
| parser.parse(QCoreApplication::arguments()); |
| |
| const QStringList args = parser.positionalArguments(); |
| const QString command = args.isEmpty() ? QString() : args.first(); |
| if (command == "resize") { |
| parser.clearPositionalArguments(); |
| parser.addPositionalArgument("resize", "Resize the object to a new size.", "resize [resize_options]"); |
| parser.addOption(QCommandLineOption("size", "New size.", "new_size")); |
| parser.process(app); |
| // ... |
| } |
| |
| /* |
| This code results in context-dependent help: |
| |
| $ tool --help |
| Usage: tool command |
| |
| Arguments: |
| command The command to execute. |
| |
| $ tool resize --help |
| Usage: tool resize [resize_options] |
| |
| Options: |
| --size <size> New size. |
| |
| Arguments: |
| resize Resize the object to a new size. |
| */ |
| //! [3] |
| } |
| |
| { |
| //! [4] |
| QCommandLineParser parser; |
| parser.setApplicationDescription(QCoreApplication::translate("main", "The best application in the world")); |
| parser.addHelpOption(); |
| //! [4] |
| } |
| |
| } |