qprocess.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
- /****************************************************************************
- **
- ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
- ** Contact: Qt Software Information (qt-info@nokia.com)
- **
- ** This file is part of the QtCore module of the Qt Toolkit.
- **
- ** Commercial Usage
- ** Licensees holding valid Qt Commercial licenses may use this file in
- ** accordance with the Qt Commercial License Agreement provided with the
- ** Software or, alternatively, in accordance with the terms contained in
- ** a written agreement between you and Nokia.
- **
- **
- ** GNU General Public License Usage
- ** Alternatively, this file may be used under the terms of the GNU
- ** General Public License versions 2.0 or 3.0 as published by the Free
- ** Software Foundation and appearing in the file LICENSE.GPL included in
- ** the packaging of this file. Please review the following information
- ** to ensure GNU General Public Licensing requirements will be met:
- ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
- ** http://www.gnu.org/copyleft/gpl.html. In addition, as a special
- ** exception, Nokia gives you certain additional rights. These rights
- ** are described in the Nokia Qt GPL Exception version 1.3, included in
- ** the file GPL_EXCEPTION.txt in this package.
- **
- ** Qt for Windows(R) Licensees
- ** As a special exception, Nokia, as the sole copyright holder for Qt
- ** Designer, grants users of the Qt/Eclipse Integration plug-in the
- ** right for the Qt/Eclipse Integration to link to functionality
- ** provided by Qt Designer and its related libraries.
- **
- ** If you are unsure which license is appropriate for your use, please
- ** contact the sales department at qt-sales@nokia.com.
- **
- ****************************************************************************/
- #ifndef QPROCESS_H
- #define QPROCESS_H
- #include <QtCore/qiodevice.h>
- #include <QtCore/qstringlist.h>
- QT_BEGIN_HEADER
- QT_BEGIN_NAMESPACE
- QT_MODULE(Core)
- #ifndef QT_NO_PROCESS
- #if (!defined(Q_OS_WIN32) && !defined(Q_OS_WINCE)) || defined(qdoc)
- typedef qint64 Q_PID;
- #else
- QT_END_NAMESPACE
- typedef struct _PROCESS_INFORMATION *Q_PID;
- QT_BEGIN_NAMESPACE
- #endif
- class QProcessPrivate;
- class Q_CORE_EXPORT QProcess : public QIODevice
- {
- Q_OBJECT
- public:
- enum ProcessError {
- FailedToStart, //### file not found, resource error
- Crashed,
- Timedout,
- ReadError,
- WriteError,
- UnknownError
- };
- enum ProcessState {
- NotRunning,
- Starting,
- Running
- };
- enum ProcessChannel {
- StandardOutput,
- StandardError
- };
- enum ProcessChannelMode {
- SeparateChannels,
- MergedChannels,
- ForwardedChannels
- };
- enum ExitStatus {
- NormalExit,
- CrashExit
- };
- explicit QProcess(QObject *parent = 0);
- virtual ~QProcess();
- void start(const QString &program, const QStringList &arguments, OpenMode mode = ReadWrite);
- void start(const QString &program, OpenMode mode = ReadWrite);
- ProcessChannelMode readChannelMode() const;
- void setReadChannelMode(ProcessChannelMode mode);
- ProcessChannelMode processChannelMode() const;
- void setProcessChannelMode(ProcessChannelMode mode);
- ProcessChannel readChannel() const;
- void setReadChannel(ProcessChannel channel);
- void closeReadChannel(ProcessChannel channel);
- void closeWriteChannel();
- void setStandardInputFile(const QString &fileName);
- void setStandardOutputFile(const QString &fileName, OpenMode mode = Truncate);
- void setStandardErrorFile(const QString &fileName, OpenMode mode = Truncate);
- void setStandardOutputProcess(QProcess *destination);
- QString workingDirectory() const;
- void setWorkingDirectory(const QString &dir);
- void setEnvironment(const QStringList &environment);
- QStringList environment() const;
- QProcess::ProcessError error() const;
- QProcess::ProcessState state() const;
- // #### Qt 5: Q_PID is a pointer on Windows and a value on Unix
- Q_PID pid() const;
- bool waitForStarted(int msecs = 30000);
- bool waitForReadyRead(int msecs = 30000);
- bool waitForBytesWritten(int msecs = 30000);
- bool waitForFinished(int msecs = 30000);
- QByteArray readAllStandardOutput();
- QByteArray readAllStandardError();
- int exitCode() const;
- QProcess::ExitStatus exitStatus() const;
- // QIODevice
- qint64 bytesAvailable() const;
- qint64 bytesToWrite() const;
- bool isSequential() const;
- bool canReadLine() const;
- void close();
- bool atEnd() const;
- static int execute(const QString &program, const QStringList &arguments);
- static int execute(const QString &program);
- static bool startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory,
- qint64 *pid = 0);
- static bool startDetached(const QString &program, const QStringList &arguments);
- static bool startDetached(const QString &program);
- static QStringList systemEnvironment();
- public Q_SLOTS:
- void terminate();
- void kill();
- Q_SIGNALS:
- void started();
- void finished(int exitCode);
- void finished(int exitCode, QProcess::ExitStatus exitStatus);
- void error(QProcess::ProcessError error);
- void stateChanged(QProcess::ProcessState state);
- void readyReadStandardOutput();
- void readyReadStandardError();
- protected:
- void setProcessState(ProcessState state);
- virtual void setupChildProcess();
- // QIODevice
- qint64 readData(char *data, qint64 maxlen);
- qint64 writeData(const char *data, qint64 len);
- private:
- Q_DECLARE_PRIVATE(QProcess)
- Q_DISABLE_COPY(QProcess)
- Q_PRIVATE_SLOT(d_func(), bool _q_canReadStandardOutput())
- Q_PRIVATE_SLOT(d_func(), bool _q_canReadStandardError())
- Q_PRIVATE_SLOT(d_func(), bool _q_canWrite())
- Q_PRIVATE_SLOT(d_func(), bool _q_startupNotification())
- Q_PRIVATE_SLOT(d_func(), bool _q_processDied())
- Q_PRIVATE_SLOT(d_func(), void _q_notified())
- friend class QProcessManager;
- };
- #endif // QT_NO_PROCESS
- QT_END_NAMESPACE
- QT_END_HEADER
- #endif // QPROCESS_H