1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Improve QProcess setStandardOutputFile description

Browse Source 
Fix links to OpenMode flags. While at it, make links explicit so
that future changes breaking implicit linking will cause errors.

Pick-to: 6.8
Task-number: QTBUG-131484
Change-Id: I20b80014eadcbcba6ebebab1ff4db4c345dd434a
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
(cherry picked from commit 4e85a4f401118f2f7330b673e45b4a0399825ef3)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Kai Köhne 2024-12-05 16:13:34 +01:00 committed by Qt Cherry-pick Bot
parent 5d2f40a14b
commit b70e61788f
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/corelib/io/qprocess.cpp
View File

@ -1492,22 +1492,22 @@ void QProcess::setStandardInputFile(const QString &fileName)
Redirects the process' standard output to the file \a Redirects the process' standard output to the file \a
fileName. When the redirection is in place, the standard output fileName. When the redirection is in place, the standard output
read channel is closed: reading from it using read() will always read channel is closed: reading from it using \l read() will always
fail, as will readAllStandardOutput(). fail, as will \l readAllStandardOutput().
To discard all standard output from the process, pass nullDevice() To discard all standard output from the process, pass \l nullDevice()
here. This is more efficient than simply never reading the standard here. This is more efficient than simply never reading the standard
output, as no QProcess buffers are filled. output, as no QProcess buffers are filled.
If the file \a fileName doesn't exist at the moment start() is If the file \a fileName doesn't exist at the moment \l start() is
called, it will be created. If it cannot be created, the starting called, it will be created. If it cannot be created, the starting
will fail. will fail.
If the file exists and \a mode is QIODevice::Truncate, the file If the file exists and \a mode is \ QIODeviceBase::Truncate, the file
will be truncated. Otherwise (if \a mode is QIODevice::Append), will be truncated. Otherwise (if \a mode is \l QIODeviceBase::Append),
the file will be appended to. the file will be appended to.
Calling setStandardOutputFile() after the process has started has Calling \l setStandardOutputFile() after the process has started has
no effect. no effect.
If \a fileName is an empty string, it stops redirecting the standard If \a fileName is an empty string, it stops redirecting the standard