mirror of
https://github.com/Gator96100/ProxSpace.git
synced 2025-07-16 02:03:02 -07:00
279 lines
8.5 KiB
C++
279 lines
8.5 KiB
C++
/****************************************************************************
|
|
**
|
|
** Copyright (C) 2015 The Qt Company Ltd.
|
|
** Contact: http://www.qt.io/licensing/
|
|
**
|
|
** This file is part of the QtCore module of the Qt Toolkit.
|
|
**
|
|
** $QT_BEGIN_LICENSE:LGPL21$
|
|
** 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 http://www.qt.io/terms-conditions. For further
|
|
** information use the contact form at http://www.qt.io/contact-us.
|
|
**
|
|
** GNU Lesser General Public License Usage
|
|
** Alternatively, this file may be used under the terms of the GNU Lesser
|
|
** General Public License version 2.1 or version 3 as published by the Free
|
|
** Software Foundation and appearing in the file LICENSE.LGPLv21 and
|
|
** LICENSE.LGPLv3 included in the packaging of this file. Please review the
|
|
** following information to ensure the GNU Lesser General Public License
|
|
** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
|
|
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
|
|
**
|
|
** As a special exception, The Qt Company gives you certain additional
|
|
** rights. These rights are described in The Qt Company LGPL Exception
|
|
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
|
|
**
|
|
** $QT_END_LICENSE$
|
|
**
|
|
****************************************************************************/
|
|
|
|
#ifndef QPROCESS_H
|
|
#define QPROCESS_H
|
|
|
|
#include <QtCore/qiodevice.h>
|
|
#include <QtCore/qstringlist.h>
|
|
#include <QtCore/qshareddata.h>
|
|
|
|
QT_BEGIN_NAMESPACE
|
|
|
|
|
|
#ifndef QT_NO_PROCESS
|
|
|
|
#if !defined(Q_OS_WIN) || defined(Q_QDOC)
|
|
typedef qint64 Q_PID;
|
|
#else
|
|
QT_END_NAMESPACE
|
|
typedef struct _PROCESS_INFORMATION *Q_PID;
|
|
QT_BEGIN_NAMESPACE
|
|
#endif
|
|
|
|
class QProcessPrivate;
|
|
class QProcessEnvironmentPrivate;
|
|
|
|
class Q_CORE_EXPORT QProcessEnvironment
|
|
{
|
|
public:
|
|
QProcessEnvironment();
|
|
QProcessEnvironment(const QProcessEnvironment &other);
|
|
~QProcessEnvironment();
|
|
#ifdef Q_COMPILER_RVALUE_REFS
|
|
QProcessEnvironment &operator=(QProcessEnvironment && other) Q_DECL_NOTHROW { swap(other); return *this; }
|
|
#endif
|
|
QProcessEnvironment &operator=(const QProcessEnvironment &other);
|
|
|
|
void swap(QProcessEnvironment &other) Q_DECL_NOTHROW { qSwap(d, other.d); }
|
|
|
|
bool operator==(const QProcessEnvironment &other) const;
|
|
inline bool operator!=(const QProcessEnvironment &other) const
|
|
{ return !(*this == other); }
|
|
|
|
bool isEmpty() const;
|
|
void clear();
|
|
|
|
bool contains(const QString &name) const;
|
|
void insert(const QString &name, const QString &value);
|
|
void remove(const QString &name);
|
|
QString value(const QString &name, const QString &defaultValue = QString()) const;
|
|
|
|
QStringList toStringList() const;
|
|
|
|
QStringList keys() const;
|
|
|
|
void insert(const QProcessEnvironment &e);
|
|
|
|
static QProcessEnvironment systemEnvironment();
|
|
|
|
private:
|
|
friend class QProcessPrivate;
|
|
friend class QProcessEnvironmentPrivate;
|
|
QSharedDataPointer<QProcessEnvironmentPrivate> d;
|
|
};
|
|
|
|
Q_DECLARE_SHARED(QProcessEnvironment)
|
|
|
|
class Q_CORE_EXPORT QProcess : public QIODevice
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
enum ProcessError {
|
|
FailedToStart, //### file not found, resource error
|
|
Crashed,
|
|
Timedout,
|
|
ReadError,
|
|
WriteError,
|
|
UnknownError
|
|
};
|
|
Q_ENUM(ProcessError)
|
|
|
|
enum ProcessState {
|
|
NotRunning,
|
|
Starting,
|
|
Running
|
|
};
|
|
Q_ENUM(ProcessState)
|
|
|
|
enum ProcessChannel {
|
|
StandardOutput,
|
|
StandardError
|
|
};
|
|
Q_ENUM(ProcessChannel)
|
|
|
|
enum ProcessChannelMode {
|
|
SeparateChannels,
|
|
MergedChannels,
|
|
ForwardedChannels,
|
|
ForwardedOutputChannel,
|
|
ForwardedErrorChannel
|
|
};
|
|
Q_ENUM(ProcessChannelMode)
|
|
|
|
enum InputChannelMode {
|
|
ManagedInputChannel,
|
|
ForwardedInputChannel
|
|
};
|
|
Q_ENUM(InputChannelMode)
|
|
|
|
enum ExitStatus {
|
|
NormalExit,
|
|
CrashExit
|
|
};
|
|
Q_ENUM(ExitStatus)
|
|
|
|
explicit QProcess(QObject *parent = Q_NULLPTR);
|
|
virtual ~QProcess();
|
|
|
|
void start(const QString &program, const QStringList &arguments, OpenMode mode = ReadWrite);
|
|
#if !defined(QT_NO_PROCESS_COMBINED_ARGUMENT_START)
|
|
void start(const QString &command, OpenMode mode = ReadWrite);
|
|
#endif
|
|
void start(OpenMode mode = ReadWrite);
|
|
bool open(OpenMode mode = ReadWrite) Q_DECL_OVERRIDE;
|
|
|
|
QString program() const;
|
|
void setProgram(const QString &program);
|
|
|
|
QStringList arguments() const;
|
|
void setArguments(const QStringList & arguments);
|
|
|
|
ProcessChannelMode readChannelMode() const;
|
|
void setReadChannelMode(ProcessChannelMode mode);
|
|
ProcessChannelMode processChannelMode() const;
|
|
void setProcessChannelMode(ProcessChannelMode mode);
|
|
InputChannelMode inputChannelMode() const;
|
|
void setInputChannelMode(InputChannelMode 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);
|
|
|
|
#if defined(Q_OS_WIN)
|
|
QString nativeArguments() const;
|
|
void setNativeArguments(const QString &arguments);
|
|
#endif
|
|
|
|
QString workingDirectory() const;
|
|
void setWorkingDirectory(const QString &dir);
|
|
|
|
void setEnvironment(const QStringList &environment);
|
|
QStringList environment() const;
|
|
void setProcessEnvironment(const QProcessEnvironment &environment);
|
|
QProcessEnvironment processEnvironment() 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;
|
|
qint64 processId() const;
|
|
|
|
bool waitForStarted(int msecs = 30000);
|
|
bool waitForReadyRead(int msecs = 30000) Q_DECL_OVERRIDE;
|
|
bool waitForBytesWritten(int msecs = 30000) Q_DECL_OVERRIDE;
|
|
bool waitForFinished(int msecs = 30000);
|
|
|
|
QByteArray readAllStandardOutput();
|
|
QByteArray readAllStandardError();
|
|
|
|
int exitCode() const;
|
|
QProcess::ExitStatus exitStatus() const;
|
|
|
|
// QIODevice
|
|
qint64 bytesAvailable() const Q_DECL_OVERRIDE;
|
|
qint64 bytesToWrite() const Q_DECL_OVERRIDE;
|
|
bool isSequential() const Q_DECL_OVERRIDE;
|
|
bool canReadLine() const Q_DECL_OVERRIDE;
|
|
void close() Q_DECL_OVERRIDE;
|
|
bool atEnd() const Q_DECL_OVERRIDE;
|
|
|
|
static int execute(const QString &program, const QStringList &arguments);
|
|
static int execute(const QString &command);
|
|
|
|
static bool startDetached(const QString &program, const QStringList &arguments,
|
|
const QString &workingDirectory
|
|
#if defined(Q_QDOC)
|
|
= QString()
|
|
#endif
|
|
, qint64 *pid = Q_NULLPTR);
|
|
#if !defined(Q_QDOC)
|
|
static bool startDetached(const QString &program, const QStringList &arguments); // ### Qt6: merge overloads
|
|
#endif
|
|
static bool startDetached(const QString &command);
|
|
|
|
static QStringList systemEnvironment();
|
|
|
|
static QString nullDevice();
|
|
|
|
public Q_SLOTS:
|
|
void terminate();
|
|
void kill();
|
|
|
|
Q_SIGNALS:
|
|
void started(QPrivateSignal);
|
|
void finished(int exitCode); // ### Qt 6: merge the two signals with a default value
|
|
void finished(int exitCode, QProcess::ExitStatus exitStatus);
|
|
#if QT_DEPRECATED_SINCE(5,6)
|
|
void error(QProcess::ProcessError error);
|
|
#endif
|
|
void errorOccurred(QProcess::ProcessError error);
|
|
void stateChanged(QProcess::ProcessState state, QPrivateSignal);
|
|
|
|
void readyReadStandardOutput(QPrivateSignal);
|
|
void readyReadStandardError(QPrivateSignal);
|
|
|
|
protected:
|
|
void setProcessState(ProcessState state);
|
|
|
|
virtual void setupChildProcess();
|
|
|
|
// QIODevice
|
|
qint64 readData(char *data, qint64 maxlen) Q_DECL_OVERRIDE;
|
|
qint64 writeData(const char *data, qint64 len) Q_DECL_OVERRIDE;
|
|
|
|
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())
|
|
friend class QProcessManager;
|
|
};
|
|
|
|
#endif // QT_NO_PROCESS
|
|
|
|
QT_END_NAMESPACE
|
|
|
|
#endif // QPROCESS_H
|