diff options
Diffstat (limited to 'src')
-rw-r--r-- | src/corelib/doc/snippets/code/src_corelib_io_qprocess.cpp | 6 | ||||
-rw-r--r-- | src/corelib/io/qprocess.cpp | 41 | ||||
-rw-r--r-- | src/corelib/io/qprocess.h | 1 |
3 files changed, 45 insertions, 3 deletions
diff --git a/src/corelib/doc/snippets/code/src_corelib_io_qprocess.cpp b/src/corelib/doc/snippets/code/src_corelib_io_qprocess.cpp index f6ea843ab6..3ec7791bd6 100644 --- a/src/corelib/doc/snippets/code/src_corelib_io_qprocess.cpp +++ b/src/corelib/doc/snippets/code/src_corelib_io_qprocess.cpp @@ -111,7 +111,7 @@ void runSandboxed(const QString &name, const QStringList &arguments) //! [5] QProcess process; -process.start("del /s *.txt"); +process.startCommand("del /s *.txt"); // same as process.start("del", QStringList() << "/s" << "*.txt"); ... //! [5] @@ -119,13 +119,13 @@ process.start("del /s *.txt"); //! [6] QProcess process; -process.start("dir \"My Documents\""); +process.startCommand("dir \"My Documents\""); //! [6] //! [7] QProcess process; -process.start("dir \"Epic 12\"\"\" Singles\""); +process.startCommand("dir \"Epic 12\"\"\" Singles\""); //! [7] diff --git a/src/corelib/io/qprocess.cpp b/src/corelib/io/qprocess.cpp index 483c99ed5f..4fdc94a202 100644 --- a/src/corelib/io/qprocess.cpp +++ b/src/corelib/io/qprocess.cpp @@ -2063,6 +2063,47 @@ void QProcess::start(OpenMode mode) } /*! + \since 6.0 + + Starts the command \a command in a new process. + The OpenMode is set to \a mode. + + \a command is a single string of text containing both the program name + and its arguments. The arguments are separated by one or more spaces. + For example: + + \snippet code/src_corelib_io_qprocess.cpp 5 + + Arguments containing spaces must be quoted to be correctly supplied to + the new process. For example: + + \snippet code/src_corelib_io_qprocess.cpp 6 + + Literal quotes in the \a command string are represented by triple quotes. + For example: + + \snippet code/src_corelib_io_qprocess.cpp 7 + + After the \a command string has been split and unquoted, this function + behaves like start(). + + On operating systems where the system API for passing command line + arguments to a subprocess natively uses a single string (Windows), one can + conceive command lines which cannot be passed via QProcess's portable + list-based API. In these rare cases you need to use setProgram() and + setNativeArguments() instead of this function. + + \sa splitCommand() + \sa start() + */ +void QProcess::startCommand(const QString &command, OpenMode mode) +{ + QStringList args = splitCommand(command); + const QString program = args.takeFirst(); + start(program, args, mode); +} + +/*! \since 5.10 Starts the program set by setProgram() with arguments set by setArguments() diff --git a/src/corelib/io/qprocess.h b/src/corelib/io/qprocess.h index 77980e012c..541086e1b0 100644 --- a/src/corelib/io/qprocess.h +++ b/src/corelib/io/qprocess.h @@ -160,6 +160,7 @@ public: void start(const QString &program, const QStringList &arguments = {}, OpenMode mode = ReadWrite); void start(OpenMode mode = ReadWrite); + void startCommand(const QString &command, OpenMode mode = ReadWrite); bool startDetached(qint64 *pid = nullptr); bool open(OpenMode mode = ReadWrite) override; |