| /**************************************************************************** |
| ** |
| ** 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> |
| |
| //! [0] |
| int main(int argc, char *argv[]) |
| { |
| QCoreApplication app(argc, argv); |
| QCoreApplication::setApplicationName("my-copy-program"); |
| QCoreApplication::setApplicationVersion("1.0"); |
| |
| QCommandLineParser parser; |
| parser.setApplicationDescription("Test helper"); |
| parser.addHelpOption(); |
| parser.addVersionOption(); |
| parser.addPositionalArgument("source", QCoreApplication::translate("main", "Source file to copy.")); |
| parser.addPositionalArgument("destination", QCoreApplication::translate("main", "Destination directory.")); |
| |
| // A boolean option with a single name (-p) |
| QCommandLineOption showProgressOption("p", QCoreApplication::translate("main", "Show progress during copy")); |
| parser.addOption(showProgressOption); |
| |
| // A boolean option with multiple names (-f, --force) |
| QCommandLineOption forceOption(QStringList() << "f" << "force", |
| QCoreApplication::translate("main", "Overwrite existing files.")); |
| parser.addOption(forceOption); |
| |
| // An option with a value |
| QCommandLineOption targetDirectoryOption(QStringList() << "t" << "target-directory", |
| QCoreApplication::translate("main", "Copy all source files into <directory>."), |
| QCoreApplication::translate("main", "directory")); |
| parser.addOption(targetDirectoryOption); |
| |
| // Process the actual command line arguments given by the user |
| parser.process(app); |
| |
| const QStringList args = parser.positionalArguments(); |
| // source is args.at(0), destination is args.at(1) |
| |
| bool showProgress = parser.isSet(showProgressOption); |
| bool force = parser.isSet(forceOption); |
| QString targetDir = parser.value(targetDirectoryOption); |
| // ... |
| } |
| |
| //! [0] |
| |
| void f() { |
| //! [cxx11] |
| parser.addOptions({ |
| // A boolean option with a single name (-p) |
| {"p", |
| QCoreApplication::translate("main", "Show progress during copy")}, |
| // A boolean option with multiple names (-f, --force) |
| {{"f", "force"}, |
| QCoreApplication::translate("main", "Overwrite existing files.")}, |
| // An option with a value |
| {{"t", "target-directory"}, |
| QCoreApplication::translate("main", "Copy all source files into <directory>."), |
| QCoreApplication::translate("main", "directory")}, |
| }); |
| //! [cxx11] |
| } |