qprocess.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtCore module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QPROCESS_H
  38. #define QPROCESS_H
  39. #include <QtCore/qiodevice.h>
  40. #include <QtCore/qstringlist.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Core)
  44. #ifndef QT_NO_PROCESS
  45. #if (!defined(Q_OS_WIN32) && !defined(Q_OS_WINCE)) || defined(qdoc)
  46. typedef qint64 Q_PID;
  47. #else
  48. QT_END_NAMESPACE
  49. typedef struct _PROCESS_INFORMATION *Q_PID;
  50. QT_BEGIN_NAMESPACE
  51. #endif
  52. class QProcessPrivate;
  53. class Q_CORE_EXPORT QProcess : public QIODevice
  54. {
  55.     Q_OBJECT
  56. public:
  57.     enum ProcessError {
  58.         FailedToStart, //### file not found, resource error
  59.         Crashed,
  60.         Timedout,
  61.         ReadError,
  62.         WriteError,
  63.         UnknownError
  64.     };
  65.     enum ProcessState {
  66.         NotRunning,
  67.         Starting,
  68.         Running
  69.     };
  70.     enum ProcessChannel {
  71.         StandardOutput,
  72.         StandardError
  73.     };
  74.     enum ProcessChannelMode {
  75.         SeparateChannels,
  76.         MergedChannels,
  77.         ForwardedChannels
  78.     };
  79.     enum ExitStatus {
  80.         NormalExit,
  81.         CrashExit
  82.     };
  83.     explicit QProcess(QObject *parent = 0);
  84.     virtual ~QProcess();
  85.     void start(const QString &program, const QStringList &arguments, OpenMode mode = ReadWrite);
  86.     void start(const QString &program, OpenMode mode = ReadWrite);
  87.     ProcessChannelMode readChannelMode() const;
  88.     void setReadChannelMode(ProcessChannelMode mode);
  89.     ProcessChannelMode processChannelMode() const;
  90.     void setProcessChannelMode(ProcessChannelMode mode);
  91.     ProcessChannel readChannel() const;
  92.     void setReadChannel(ProcessChannel channel);
  93.     void closeReadChannel(ProcessChannel channel);
  94.     void closeWriteChannel();
  95.     void setStandardInputFile(const QString &fileName);
  96.     void setStandardOutputFile(const QString &fileName, OpenMode mode = Truncate);
  97.     void setStandardErrorFile(const QString &fileName, OpenMode mode = Truncate);
  98.     void setStandardOutputProcess(QProcess *destination);
  99.     QString workingDirectory() const;
  100.     void setWorkingDirectory(const QString &dir);
  101.     void setEnvironment(const QStringList &environment);
  102.     QStringList environment() const;
  103.     QProcess::ProcessError error() const;
  104.     QProcess::ProcessState state() const;
  105.     // #### Qt 5: Q_PID is a pointer on Windows and a value on Unix
  106.     Q_PID pid() const;
  107.     bool waitForStarted(int msecs = 30000);
  108.     bool waitForReadyRead(int msecs = 30000);
  109.     bool waitForBytesWritten(int msecs = 30000);
  110.     bool waitForFinished(int msecs = 30000);
  111.     QByteArray readAllStandardOutput();
  112.     QByteArray readAllStandardError();
  113.     int exitCode() const;
  114.     QProcess::ExitStatus exitStatus() const;
  115.     // QIODevice
  116.     qint64 bytesAvailable() const;
  117.     qint64 bytesToWrite() const;
  118.     bool isSequential() const;
  119.     bool canReadLine() const;
  120.     void close();
  121.     bool atEnd() const;
  122.     static int execute(const QString &program, const QStringList &arguments);
  123.     static int execute(const QString &program);
  124.     static bool startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory,
  125.                               qint64 *pid = 0);
  126.     static bool startDetached(const QString &program, const QStringList &arguments);
  127.     static bool startDetached(const QString &program);
  128.     static QStringList systemEnvironment();
  129. public Q_SLOTS:
  130.     void terminate();
  131.     void kill();
  132. Q_SIGNALS:
  133.     void started();
  134.     void finished(int exitCode);
  135.     void finished(int exitCode, QProcess::ExitStatus exitStatus);
  136.     void error(QProcess::ProcessError error);
  137.     void stateChanged(QProcess::ProcessState state);
  138.     void readyReadStandardOutput();
  139.     void readyReadStandardError();
  140. protected:
  141.     void setProcessState(ProcessState state);
  142.     virtual void setupChildProcess();
  143.     // QIODevice
  144.     qint64 readData(char *data, qint64 maxlen);
  145.     qint64 writeData(const char *data, qint64 len);
  146. private:
  147.     Q_DECLARE_PRIVATE(QProcess)
  148.     Q_DISABLE_COPY(QProcess)
  149.     Q_PRIVATE_SLOT(d_func(), bool _q_canReadStandardOutput())
  150.     Q_PRIVATE_SLOT(d_func(), bool _q_canReadStandardError())
  151.     Q_PRIVATE_SLOT(d_func(), bool _q_canWrite())
  152.     Q_PRIVATE_SLOT(d_func(), bool _q_startupNotification())
  153.     Q_PRIVATE_SLOT(d_func(), bool _q_processDied())
  154.     Q_PRIVATE_SLOT(d_func(), void _q_notified())
  155.     friend class QProcessManager;
  156. };
  157. #endif // QT_NO_PROCESS
  158. QT_END_NAMESPACE
  159. QT_END_HEADER
  160. #endif // QPROCESS_H