QProcess Class

멤버 함수 문서

[explicit] QProcess::QProcess(QObject *parent = nullptr)

주어진 parent 으로 QProcess 객체를 생성합니다.

[virtual noexcept] QProcess::~QProcess()

QProcess 객체를 파괴합니다(즉, 프로세스를 종료합니다).

이 함수는 프로세스가 종료될 때까지 반환되지 않습니다.

QStringList QProcess::arguments() const

프로세스가 마지막으로 시작된 명령줄 인수를 반환합니다.

setArguments() 및 start()도 참조하세요 .

[override virtual] qint64 QProcess::bytesToWrite() const

재구현합니다: QIODevice::bytesToWrite() const.

[since 6.0] std::function<void ()> QProcess::childProcessModifier() const

setChildProcessModifier()를 호출하여 이전에 설정한 수정자 함수를 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

setChildProcessModifier() 및 unixProcessParameters()도 참조하세요 .

[override virtual] void QProcess::close()

다시 구현합니다: QIODevice::close().

프로세스와의 모든 통신을 닫고 프로세스를 종료합니다. 이 함수를 호출하면 QProcess 더 이상 readyRead()을 전송하지 않으며 데이터를 더 이상 읽거나 쓸 수 없습니다.

void QProcess::closeReadChannel(QProcess::ProcessChannel channel)

읽기 채널을 닫습니다 channel. 이 함수를 호출하면 QProcess 은 더 이상 채널에서 데이터를 수신하지 않습니다. 이미 수신된 모든 데이터는 계속 읽을 수 있습니다.

프로세스의 출력에 관심이 없는 경우 메모리를 절약하려면 이 함수를 호출하세요.

closeWriteChannel() 및 setReadChannel()도 참조하세요 .

void QProcess::closeWriteChannel()

QProcess 의 쓰기 채널이 닫히도록 예약합니다. 프로세스에 모든 데이터가 쓰여지면 채널이 닫힙니다. 이 함수를 호출한 후에는 프로세스에 쓰려는 모든 시도가 실패합니다.

쓰기 채널을 닫는 것은 채널이 닫힐 때까지 입력 데이터를 읽는 프로그램에 필요합니다. 예를 들어 "more" 프로그램은 Unix와 Windows 모두에서 콘솔에 텍스트 데이터를 표시하는 데 사용됩니다. 하지만 QProcess 의 쓰기 채널이 닫힐 때까지 텍스트 데이터가 표시되지 않습니다. 예시:

QProcess more;
more.start("more");
more.write("Text to display");
more.closeWriteChannel();
// QProcess will emit readyRead() once "more" starts printing

start()가 호출되면 쓰기 채널이 암시적으로 열립니다.

closeReadChannel()도 참조하세요 .

QProcess::CreateProcessArgumentModifier QProcess::createProcessArgumentsModifier() const

이전에 설정한 CreateProcess 수정자 함수를 반환합니다.

setCreateProcessArgumentsModifier() 및 QProcess::CreateProcessArgumentModifier 을참조하세요 .

QProcess::ProcessError QProcess::error() const

마지막으로 발생한 오류 유형을 반환합니다.

state()도 참조하세요 .

[signal] void QProcess::errorOccurred(QProcess::ProcessError error)

이 신호는 프로세스에 오류가 발생할 때 발생합니다. 지정된 error 은 발생한 오류의 유형을 설명합니다.

[static] int QProcess::execute(const QString &program, const QStringList &arguments = {})

새 프로세스에서 arguments 인수를 사용하여 program 프로그램을 시작하고 완료될 때까지 기다린 다음 프로세스의 종료 코드를 반환합니다. 새 프로세스가 콘솔에 쓰는 모든 데이터는 호출 프로세스로 전달됩니다.

환경 및 작업 디렉터리는 호출 프로세스에서 상속됩니다.

인수 처리는 각각의 start() 오버로드와 동일합니다.

프로세스를 시작할 수 없으면 -2가 반환됩니다. 프로세스가 충돌하면 -1이 반환됩니다. 그렇지 않으면 프로세스의 종료 코드가 반환됩니다.

start()도 참조하세요 .

int QProcess::exitCode() const

마지막으로 완료된 프로세스의 종료 코드를 반환합니다.

exitStatus()가 NormalExit 을 반환하지 않는 한 이 값은 유효하지 않습니다.

QProcess::ExitStatus QProcess::exitStatus() const

마지막으로 종료된 프로세스의 종료 상태를 반환합니다.

Windows에서 프로세스가 다른 애플리케이션에서 TerminateProcess()로 종료된 경우에도 종료 코드가 0보다 작지 않으면 이 함수는 NormalExit 을 반환합니다.

[noexcept, since 6.7] void QProcess::failChildProcessModifier(const char *description, int error = 0)

이 함수는 setChildProcessModifier()와 함께 설정된 수정자 내에서 오류 조건이 발생했음을 나타내는 데 사용할 수 있습니다. 수정자가 이 함수를 호출하면 QProcess 은 부모 프로세스에서 QProcess::FailedToStart 코드와 함께 errorOccurred()을 내보냅니다. description 는 문제를 진단하는 데 도움이 되도록 errorString()에 일부 정보를 포함하는 데 사용할 수 있으며, 일반적으로 C 라이브러리 함수 perror() 와 유사하게 실패한 호출의 이름입니다. 또한 error 매개 변수는 텍스트 형식이 포함된 <errno.h> 오류 코드일 수도 있습니다.

예를 들어 자식 수정자는 이러한 방식으로 자식 프로세스에 대한 추가 파일 설명자를 준비할 수 있습니다:

process.setChildProcessModifier([fd, &process]() {
    if (dup2(fd, TargetFileDescriptor) < 0)
        process.failChildProcessModifier(errno, "aux comm channel");
});
process.start();

여기서 fd 은 현재 부모 프로세스에서 열려 있는 파일 설명자입니다. dup2() 시스템 호출에서 EBADF 조건이 발생한 경우 errorString() 프로세스는 "하위 프로세스 수정자가 오류를 보고했습니다: 보조 통신 채널: 잘못된 파일 설명자".

이 함수는 호출자에게 반환되지 않습니다. 하위 수정자를 제외한 다른 곳에서 올바른 QProcess 객체와 함께 사용하는 것은 정의되지 않은 동작입니다.

이 함수는 Qt 6.7에 도입되었습니다.

setChildProcessModifier() 및 setUnixProcessParameters()도 참조하세요 .

[signal] void QProcess::finished(int exitCode, QProcess::ExitStatus exitStatus = NormalExit)

exitCode 은 프로세스의 종료 코드(일반 종료에만 유효)이고 exitStatus 은 종료 상태입니다. 프로세스가 종료된 후에도 QProcess 의 버퍼는 그대로 유지됩니다. 프로세스가 완료되기 전에 썼을 수 있는 모든 데이터를 계속 읽을 수 있습니다.

exitStatus()도 참조하세요 .

QProcess::InputChannelMode QProcess::inputChannelMode() const

QProcess 표준 입력 채널의 채널 모드를 반환합니다.

setInputChannelMode() 및 InputChannelMode도 참조하세요 .

[override virtual] bool QProcess::isSequential() const

재구현합니다: QIODevice::isSequential() const.

[slot] void QProcess::kill()

현재 프로세스를 죽여 즉시 종료합니다.

Windows에서는 kill()이 TerminateProcess를 사용하고, Unix 및 macOS에서는 SIGKILL 신호가 프로세스에 전송됩니다.

terminate()도 참조하세요 .

QString QProcess::nativeArguments() const

프로그램에 대한 추가 기본 명령줄 인수를 반환합니다.

setNativeArguments()도 참조하세요 .

[static] QString QProcess::nullDevice()

운영 체제의 널 장치입니다.

반환된 파일 경로는 기본 디렉토리 구분 기호를 사용합니다.

QProcess::setStandardInputFile(), QProcess::setStandardOutputFile() 및 QProcess::setStandardErrorFile()도 참조하세요 .

[override virtual] bool QProcess::open(QIODeviceBase::OpenMode mode = ReadWrite)

다시 구현합니다: QIODevice::open(QIODeviceBase::OpenMode 모드).

setArguments()에 의해 설정된 인수를 사용하여 setProgram()에 의해 설정된 프로그램을 시작합니다. OpenMode는 mode 로 설정됩니다.

이 메서드는 start()의 별칭이며 QIODevice 에 정의된 인터페이스를 완전히 구현하기 위해서만 존재합니다.

프로그램이 시작되면 true 을 반환합니다.

start(), setProgram() 및 setArguments()도 참조하세요 .

QProcess::ProcessChannelMode QProcess::processChannelMode() const

QProcess 표준 출력 및 표준 오류 채널의 채널 모드를 반환합니다.

setProcessChannelMode(), ProcessChannelMode, setReadChannel()도 참조하세요 .

QProcessEnvironment QProcess::processEnvironment() const

QProcess 이 자식 프로세스에 전달할 환경을 반환합니다. setProcessEnvironment ()를 사용하여 설정된 환경이 없는 경우 이 메서드는 부모로부터 상속될 환경을 나타내는 객체를 반환합니다.

setProcessEnvironment(), QProcessEnvironment::inheritsFromParent() 및 Environment variables 를참조하세요 .

qint64 QProcess::processId() const

실행 중인 프로세스의 기본 프로세스 식별자가 있으면 반환합니다(사용 가능한 경우). 현재 실행 중인 프로세스가 없으면 0 가 반환됩니다.

QString QProcess::program() const

프로세스가 마지막으로 시작된 프로그램을 반환합니다.

setProgram() 및 start()도 참조하세요 .

QByteArray QProcess::readAllStandardError()

현재 읽기 채널에 관계없이 이 함수는 프로세스의 표준 오류에서 사용 가능한 모든 데이터를 QByteArray 로 반환합니다.

readyReadStandardError(), readAllStandardOutput(), readChannel() 및 setReadChannel()도 참조하세요 .

QByteArray QProcess::readAllStandardOutput()

현재 읽기 채널에 관계없이 이 함수는 프로세스의 표준 출력에서 사용 가능한 모든 데이터를 QByteArray 로 반환합니다.

readyReadStandardOutput(), readAllStandardError(), readChannel() 및 setReadChannel()도 참조하세요 .

QProcess::ProcessChannel QProcess::readChannel() const

QProcess 의 현재 읽기 채널을 반환합니다.

setReadChannel()도 참조하세요 .

[override virtual protected] qint64 QProcess::readData(char *data, qint64 maxlen)

다시 구현합니다: QIODevice::readData(문자 *데이터, qint64 maxSize).

[private signal] void QProcess::readyReadStandardError()

이 신호는 프로세스가 표준 오류 채널(stderr)을 통해 새 데이터를 사용할 수 있게 되었을 때 발생합니다. 현재 read channel 에 관계없이 전송됩니다.

readAllStandardError() 및 readChannel()도 참조하세요 .

[private signal] void QProcess::readyReadStandardOutput()

이 신호는 프로세스가 표준 출력 채널(stdout)을 통해 새 데이터를 사용할 수 있게 되었을 때 발생합니다. 현재 read channel 에 관계없이 전송됩니다.

readAllStandardOutput() 및 readChannel()도 참조하세요 .

void QProcess::setArguments(const QStringList &arguments)

프로세스를 시작할 때 호출된 프로그램에 전달할 arguments 을 설정합니다. 이 함수는 start() 전에 호출해야 합니다.

start(), setProgram() 및 arguments()도 참조하세요 .

[since 6.0] void QProcess::setChildProcessModifier(const std::function<void ()> &modifier)

자식 프로세스에 대해 modifier 함수를 설정합니다(Unix 시스템(macOS 포함, Windows의 경우 setCreateProcessArgumentsModifier() 참조). modifier 인수가 포함된 함수는 fork() 또는 vfork() 이 완료되고 QProcess 이 하위 프로세스에 대한 표준 파일 설명자를 설정한 후 하위 프로세스에서 호출되지만 start() 내에서 execve() 이전에는 호출되지 않습니다.

다음은 권한 없이 실행되도록 자식 프로세스를 설정하는 예제입니다:

void runSandboxed(const QString &name, const QStringList &arguments)
{
    QProcess proc;
    proc.setChildProcessModifier([] {
        // Drop all privileges in the child process, and enter
        // a chroot jail.
        ::setgroups(0, nullptr);
        ::chroot("/run/safedir");
        ::chdir("/");
        ::setgid(safeGid);
        ::setuid(safeUid);
        ::umask(077);
    });
    proc.start(name, arguments);
    proc.waitForFinished();
}

수정자 함수에 장애 조건이 발생하면 failChildProcessModifier()를 사용하여 QProcess 호출자에게 상황을 보고할 수 있습니다. 또는 _exit() 또는 abort() 과 같은 다른 방법을 사용하여 프로세스를 중지할 수도 있습니다.

모든 불필요한 파일 설명자를 닫거나 제어 TTY와의 연결을 끊는 등 하위 프로세스의 특정 속성은 실패를 감지하고 FailedToStart 상태를 보고할 수 있는 setUnixProcessParameters()를 사용하여 더 쉽게 달성할 수 있습니다. 이 수정자는 추가 파일 설명자를 설정하는 등 자식 프로세스의 일반적이지 않은 특정 속성을 변경하는 데 유용합니다. 자식 프로세스 수정자와 유닉스 프로세스 매개변수가 모두 설정되어 있으면 이러한 매개변수가 적용되기 전에 수정자가 실행됩니다.

이 함수는 Qt 6.0에 도입되었습니다.

childProcessModifier(), failChildProcessModifier() 및 setUnixProcessParameters()도 참조하십시오 .

void QProcess::setCreateProcessArgumentsModifier(QProcess::CreateProcessArgumentModifier modifier)

CreateProcess Win32 API 호출에 대해 modifier 을 설정합니다. 이전에 설정한 것을 제거하려면 QProcess::CreateProcessArgumentModifier() 을 전달합니다.

createProcessArgumentsModifier(), QProcess::CreateProcessArgumentModifier, setChildProcessModifier()도 참조하세요 .

void QProcess::setInputChannelMode(QProcess::InputChannelMode mode)

QProcess 표준 입력 채널의 채널 모드를 지정된 mode 으로 설정합니다. 이 모드는 다음에 start()가 호출될 때 사용됩니다.

inputChannelMode() 및 InputChannelMode도 참조하세요 .

void QProcess::setNativeArguments(const QString &arguments)

이 함수는 과부하된 함수입니다.

프로그램에 대한 추가 기본 명령줄 arguments 을 설정합니다.

arguments 명령줄을 하위 프로세스에 전달하기 위한 시스템 API가 기본적으로 단일 문자열을 사용하는 운영 체제에서는 QProcess 의 이식 가능한 목록 기반 API를 통해 전달할 수 없는 명령줄을 구상할 수 있습니다. 이러한 경우 이 함수를 사용하여 일반적인 인수 목록에서 구성된 문자열에 공백을 구분하는 문자열을 추가하는 문자열을 설정해야 합니다.

nativeArguments()도 참조하세요 .

void QProcess::setProcessChannelMode(QProcess::ProcessChannelMode mode)

QProcess 표준 출력 및 표준 오류 채널의 채널 모드를 지정된 mode 으로 설정합니다. 이 모드는 다음에 start()를 호출할 때 사용됩니다. 예를 들어

QProcess builder; builder.setProcessChannelMode(QProcess::MergedChannels); builder.start("make", QStringList()<< "-j2");if (!builder.waitForFinished())    qDebug() << "Make failed:" << builder.errorString();
else    qDebug() << "Make output:" << builder.readAll();

processChannelMode(), ProcessChannelMode, setReadChannel()도 참조하세요 .

void QProcess::setProcessEnvironment(const QProcessEnvironment &environment)

QProcess 이 하위 프로세스에 전달할 environment 을 설정합니다.

예를 들어 다음 코드는 환경 변수 TMPDIR 를 추가합니다:

QProcess process;
QProcessEnvironment env = QProcessEnvironment::systemEnvironment();
env.insert("TMPDIR", "C:\\MyApp\\temp"); // Add an environment variable
process.setProcessEnvironment(env);
process.start("myapp");

Windows에서 환경 변수 이름은 대소문자를 구분하지 않는다는 점에 유의하세요.

processEnvironment(), QProcessEnvironment::systemEnvironment() 및 Environment variables 를참조하세요 .

[protected] void QProcess::setProcessState(QProcess::ProcessState state)

QProcess 의 현재 상태를 지정된 state 으로 설정합니다.

state()도 참조하세요 .

void QProcess::setProgram(const QString &program)

프로세스를 시작할 때 사용할 program 함수를 설정합니다. 이 함수는 start() 앞에 호출해야 합니다.

program 이 절대 경로인 경우 실행될 정확한 실행 파일을 지정합니다. 상대 경로는 PATH 환경 변수를 검색하는 등 플랫폼별 방식으로 확인됩니다(자세한 내용은 Finding the Executable 참조).

start(), setArguments(), program() 및 QStandardPaths::findExecutable()도 참조하세요 .

void QProcess::setReadChannel(QProcess::ProcessChannel channel)

QProcess 의 현재 읽기 채널을 지정된 channel 으로 설정합니다. 현재 입력 채널은 read(), readAll(), readLine() 및 getChar() 함수에서 사용됩니다. 또한 QProcess 을 트리거하여 readyRead() 을 방출할 채널도 결정합니다.

readChannel()도 참조하세요 .

void QProcess::setStandardErrorFile(const QString &fileName, QIODeviceBase::OpenMode mode = Truncate)

프로세스의 표준 오류를 fileName 파일로 리디렉션합니다. 리디렉션이 완료되면 표준 오류 읽기 채널이 닫힙니다. read()를 사용하여 이 채널에서 읽으면 readAllStandardError()와 마찬가지로 항상 실패합니다. mode 가 Append인 경우 파일이 추가되고, 그렇지 않으면 잘립니다.

파일 열기 방법에 대한 자세한 내용은 setStandardOutputFile()를 참조하세요.

참고: setProcessChannelMode()가 QProcess::MergedChannels 인수를 사용하여 호출된 경우 이 함수는 효과가 없습니다.

setStandardInputFile(), setStandardOutputFile() 및 setStandardOutputProcess()도 참조하세요 .

void QProcess::setStandardInputFile(const QString &fileName)

프로세스의 표준 입력을 fileName 으로 표시된 파일로 리디렉션합니다. 입력 리디렉션이 적용되면 QProcess 객체는 읽기 전용 모드가 됩니다( write() 호출 시 오류 발생).

프로세스가 EOF를 바로 읽도록 하려면 여기에 nullDevice()를 전달하세요. 이는 프로세스를 시작하기 전에 설정할 수 있으므로 데이터를 쓰기 전에 closeWriteChannel()를 사용하는 것보다 더 깔끔합니다.

start() 호출 시 fileName 파일이 존재하지 않거나 읽을 수 없는 경우 프로세스 시작이 실패합니다.

프로세스가 시작된 후에 setStandardInputFile()을 호출해도 아무런 효과가 없습니다.

setStandardOutputFile(), setStandardErrorFile() 및 setStandardOutputProcess()도 참조하세요 .

void QProcess::setStandardOutputFile(const QString &fileName, QIODeviceBase::OpenMode mode = Truncate)

프로세스의 표준 출력을 fileName 파일로 리디렉션합니다. 리디렉션이 적용되면 표준 출력 읽기 채널이 닫힙니다. read()를 사용하여 이 채널에서 읽으면 readAllStandardOutput()와 마찬가지로 항상 실패합니다.

프로세스의 모든 표준 출력을 삭제하려면 여기에 nullDevice()를 전달하세요. 이렇게 하면 QProcess 버퍼가 채워지지 않으므로 단순히 표준 출력을 읽지 않는 것보다 더 효율적입니다.

start()이 호출되는 시점에 fileName 파일이 존재하지 않으면 파일이 생성됩니다. 파일을 만들 수 없으면 시작이 실패합니다.

파일이 존재하고 mode 가 QIODeviceBase::Truncate 인 경우 파일이 잘립니다. 그렇지 않은 경우( mode 가 QIODeviceBase::Append 인 경우) 파일이 추가됩니다.

프로세스가 시작된 후 setStandardOutputFile()을 호출해도 아무런 효과가 없습니다.

fileName 이 빈 문자열이면 표준 출력 리디렉션을 중지합니다. 이는 리디렉션 후 표준 출력을 복원할 때 유용합니다.

setStandardInputFile(), setStandardErrorFile() 및 setStandardOutputProcess()도 참조하세요 .

void QProcess::setStandardOutputProcess(QProcess *destination)

이 프로세스의 표준 출력 스트림을 destination 프로세스의 표준 입력으로 파이프합니다.

다음 셸 명령을 사용합니다:

command1 | command2

다음 코드와 함께 QProcess 으로 수행할 수 있습니다:

QProcess process1;
QProcess process2;

process1.setStandardOutputProcess(&process2);

process1.start("command1");
process2.start("command2");

[since 6.6] void QProcess::setUnixProcessParameters(const QProcess::UnixProcessParameters &params)

유닉스 시스템에서 하위 프로세스에 대한 추가 설정 및 매개변수를 params 로 설정합니다. 이 함수는 대상 실행 파일을 시작하기 전에 QProcess 에 자식 프로세스를 수정하도록 요청하는 데 사용할 수 있습니다.

이 함수는 모든 불필요한 파일 설명자를 닫거나, 자식의 좋은 수준을 변경하거나, 제어하는 TTY와의 연결을 끊는 등 자식 프로세스의 특정 속성을 변경하는 데 사용할 수 있습니다. 자식 프로세스를 보다 세밀하게 제어하거나 다른 방법으로 수정하려면 setChildProcessModifier() 함수를 사용합니다. 자식 프로세스 수정자와 유닉스 프로세스 매개변수가 모두 설정되어 있으면 이러한 매개변수가 적용되기 전에 수정자가 실행됩니다.

이 함수는 Qt 6.6에 도입되었습니다.

unixProcessParameters() 및 setChildProcessModifier()도 참조하세요 .

[since 6.6] void QProcess::setUnixProcessParameters(QProcess::UnixProcessFlags flagsOnly)

이것은 오버로드된 함수입니다.

Unix 시스템에서 하위 프로세스에 대한 추가 설정을 flagsOnly 로 설정합니다. 이는 flags 필드만 설정한 과부하와 동일합니다.

이 함수는 Qt 6.6에 도입되었습니다.

unixProcessParameters() 및 setChildProcessModifier()도 참조하세요 .

void QProcess::setWorkingDirectory(const QString &dir)

작업 디렉터리를 dir 로 설정합니다. QProcess 은 이 디렉터리에서 프로세스를 시작합니다. 기본 동작은 호출하는 프로세스의 작업 디렉터리에서 프로세스를 시작하는 것입니다.

workingDirectory() 및 start()도 참조하세요 .

[static] QStringList QProcess::splitCommand(QStringView command)

command 문자열을 토큰 목록으로 분할하고 목록을 반환합니다.

공백이 있는 토큰은 큰따옴표로 묶을 수 있으며, 연속된 큰따옴표 3개는 따옴표 문자 자체를 나타냅니다.

void QProcess::start(const QString &program, const QStringList &arguments = {}, QIODeviceBase::OpenMode mode = ReadWrite)

주어진 program 을 새 프로세스에서 시작하여 arguments 에 명령줄 인수를 전달합니다. QProcess 이 실행할 실행 파일을 검색하는 방법에 대한 자세한 내용은 setProgram()를 참조하세요. OpenMode는 mode 로 설정됩니다. 인수의 추가 분할은 수행되지 않습니다.

QProcess 객체는 즉시 시작 상태가 됩니다. 프로세스가 성공적으로 시작되면 QProcess started (), 그렇지 않으면 errorOccurred()를 반환합니다. 하위 프로세스를 동기적으로 시작할 수 있는 플랫폼(특히 Windows)에서는 이 함수가 반환되기 전에 이러한 신호가 발생하고 QProcess 객체가 각각 QProcess::Running 또는 QProcess::NotRunning 상태로 전환됩니다. 다른 팔폼에서는 started() 및 errorOccurred() 신호가 지연됩니다.

waitForStarted()를 호출하여 프로세스가 시작되었는지(또는 시작에 실패했는지) 그리고 해당 신호가 전송되었는지 확인하세요. 프로세스 시작 상태를 이미 알고 있는 경우에도 해당 함수를 호출해도 신호가 다시 전송되지 않으므로 안전합니다.

Windows: 인수가 따옴표로 묶여 CommandLineToArgvW() Windows 함수와 호환되는 명령줄로 결합됩니다. 다른 명령줄 인용 요구 사항이 있는 프로그램의 경우에는 setNativeArguments()를 사용해야 합니다. CommandLineToArgvW() 규칙을 따르지 않는 대표적인 프로그램으로는 cmd.exe와 결과적으로 모든 배치 스크립트가 있습니다.

QProcess 개체가 이미 프로세스를 실행 중인 경우 콘솔에 경고가 표시될 수 있으며 기존 프로세스는 영향을 받지 않고 계속 실행됩니다.

processId(), started(), waitForStarted() 및 setNativeArguments()도 참조하세요 .

void QProcess::start(QIODeviceBase::OpenMode mode = ReadWrite)

이 함수는 오버로드된 함수입니다.

setArguments()로 설정된 인수를 사용하여 setProgram()로 설정된 프로그램을 시작합니다. OpenMode는 mode 로 설정됩니다.

open(), setProgram() 및 setArguments()도 참조하세요 .

[since 6.0] void QProcess::startCommand(const QString &command, QIODeviceBase::OpenMode mode = ReadWrite)

새 프로세스에서 command 명령을 시작합니다. OpenMode는 mode 로 설정됩니다.

command 는 프로그램 이름과 인수가 모두 포함된 단일 텍스트 문자열입니다. 인수는 하나 이상의 공백으로 구분됩니다. 예를 들어

QProcess process;
process.startCommand("del /s *.txt");
// same as process.start("del", QStringList() << "/s" << "*.txt");
...

새 프로세스에 올바르게 제공하려면 공백이 포함된 인수를 따옴표로 묶어야 합니다. 예

QProcess process;
process.startCommand("dir \"My Documents\"");

command 문자열의 리터럴 따옴표는 큰따옴표 세 개로 표시됩니다. 예: 다음과 같습니다:

QProcess process;
process.startCommand("dir \"Epic 12\"\"\" Singles\"");

command 문자열이 분할되고 따옴표가 제거된 후 이 함수는 start()처럼 작동합니다.

명령줄 인수를 하위 프로세스에 전달하기 위한 시스템 API가 기본적으로 단일 문자열을 사용하는 운영 체제(Windows)에서는 QProcess 의 이식 가능한 목록 기반 API를 통해 전달할 수 없는 명령줄을 생각할 수 있습니다. 이런 드문 경우에는 이 함수 대신 setProgram() 및 setNativeArguments()를 사용해야 합니다.

이 함수는 Qt 6.0에 도입되었습니다.

splitCommand() 및 start()도 참조하세요 .

bool QProcess::startDetached(qint64 *pid = nullptr)

setProgram()에서 설정한 프로그램을 setArguments()에서 설정한 인수를 사용하여 새 프로세스에서 시작하고 분리합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 호출하는 프로세스가 종료되면 분리된 프로세스는 영향을 받지 않고 계속 실행됩니다.

Unix: 시작된 프로세스는 자체 세션에서 실행되며 데몬처럼 작동합니다.

프로세스는 setWorkingDirectory()에 의해 설정된 디렉토리에서 시작됩니다. workingDirectory ()가 비어 있으면 호출하는 프로세스에서 작업 디렉터리가 상속됩니다.

함수가 성공하면 *pid 이 시작된 프로세스의 프로세스 식별자로 설정되고, 그렇지 않으면 -1로 설정됩니다. 자식 프로세스가 예고 없이 종료되어 PID가 유효하지 않게 될 수 있습니다. 또한 하위 프로세스가 종료된 후 완전히 다른 프로세스에서 동일한 PID를 재활용하여 사용할 수도 있습니다. 특히 운영 체제에서 프로세스를 강제로 종료하려는 경우 사용자 코드는 이 변수를 사용할 때 주의해야 합니다.

startDetached()는 다음 속성 설정자만 지원합니다:

• setArguments()
• setCreateProcessArgumentsModifier()
• setNativeArguments()
• setProcessEnvironment()
• setProgram()
• setStandardErrorFile()
• setStandardInputFile()
• setStandardOutputFile()
• setProcessChannelMode(QProcess::MergedChannels)
• setStandardOutputProcess()
• setWorkingDirectory()

QProcess 객체의 다른 모든 속성은 무시됩니다.

start() 및 startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory, qint64 *pid)도 참조하세요 .

[static] bool QProcess::startDetached(const QString &program, const QStringList &arguments = {}, const QString &workingDirectory = QString(), qint64 *pid = nullptr)

이 함수는 startDetached()를 오버로드합니다.

새 프로세스에서 arguments 인수를 사용하여 program 프로그램을 시작하고 이 프로그램에서 분리합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 호출하는 프로세스가 종료되면 분리된 프로세스는 영향을 받지 않고 계속 실행됩니다.

인자 처리는 각각의 start() 오버로드와 동일합니다.

프로세스는 workingDirectory 디렉토리에서 시작됩니다. workingDirectory 이 비어 있으면 작업 디렉터리가 호출 프로세스에서 상속됩니다.

함수가 성공하면 *pid 이 시작된 프로세스의 프로세스 식별자로 설정됩니다.

start()도 참조하세요 .

[private signal] void QProcess::started()

이 신호는 프로세스가 시작되면 QProcess 에서 전송되며 state()은 Running 을 반환합니다.

QProcess::ProcessState QProcess::state() const

프로세스의 현재 상태를 반환합니다.

stateChanged() 및 error()도 참조하세요 .

[private signal] void QProcess::stateChanged(QProcess::ProcessState newState)

이 신호는 QProcess 상태가 변경될 때마다 전송됩니다. newState 인수는 QProcess 상태가 변경된 상태입니다.

[static] QStringList QProcess::systemEnvironment()

호출하는 프로세스의 환경을 키=값 쌍의 목록으로 반환합니다. 예제:

QStringList environment = QProcess::systemEnvironment();
// environment = {"PATH=/usr/bin:/usr/local/bin",
//                "USER=greg", "HOME=/home/greg"}

이 함수는 시스템 환경을 캐시하지 않습니다. 따라서 setenv 또는 putenv 같은 저수준 C 라이브러리 함수가 호출된 경우 업데이트된 버전의 환경을 가져올 수 있습니다.

그러나 이 함수를 반복적으로 호출하면 환경 변수 목록이 다시 생성되므로 간단한 작업이 아니라는 점에 유의하세요.

QProcessEnvironment::systemEnvironment() 및 setProcessEnvironment()도 참조하세요 .

[slot] void QProcess::terminate()

프로세스 종료를 시도합니다.

이 함수를 호출해도 프로세스가 종료되지 않을 수 있습니다(사용자에게 저장되지 않은 파일 등을 확인할 기회가 주어집니다).

Windows에서 terminate()는 프로세스의 모든 최상위 창에 WM_CLOSE 메시지를 게시한 다음 프로세스 자체의 메인 스레드에 메시지를 게시합니다. Unix 및 macOS에서는 SIGTERM 신호가 전송됩니다.

이벤트 루프를 실행하지 않거나 이벤트 루프가 WM_CLOSE 메시지를 처리하지 않는 Windows의 콘솔 애플리케이션은 kill()를 호출해야만 종료할 수 있습니다.

kill()도 참조하세요 .

[noexcept, since 6.6] QProcess::UnixProcessParameters QProcess::unixProcessParameters() const

유닉스 시스템에서 하위 프로세스에 적용될 추가 플래그 및 설정을 설명하는 UnixProcessParameters 객체를 반환합니다. 기본 설정은 기본적으로 구성된 UnixProcessParameters 에 해당합니다.

이 함수는 Qt 6.6에 도입되었습니다.

setUnixProcessParameters() 및 childProcessModifier()도 참조하세요 .

[override virtual] bool QProcess::waitForBytesWritten(int msecs = 30000)

다시 구현합니다: QIODevice::waitForBytesWritten(int msecs).

bool QProcess::waitForFinished(int msecs = 30000)

프로세스가 완료되고 finished() 신호가 전송될 때까지 또는 msecs 밀리초가 경과할 때까지 차단합니다.

프로세스가 완료되면 true 을 반환하고, 그렇지 않으면 false (작업 시간 초과, 오류 발생 또는 이 QProcess 이미 완료된 경우)을 반환합니다.

이 함수는 이벤트 루프 없이 작동할 수 있습니다. 이 함수는 비-GUI 애플리케이션을 작성하거나 비-GUI 스레드에서 I/O 작업을 수행할 때 유용합니다.

msecs가 -1이면 이 함수는 시간 초과되지 않습니다.

finished(), waitForStarted(), waitForReadyRead() 및 waitForBytesWritten()도 참조하세요 .

[override virtual] bool QProcess::waitForReadyRead(int msecs = 30000)

다시 구현합니다: QIODevice::waitForReadyRead(int msecs).

bool QProcess::waitForStarted(int msecs = 30000)

프로세스가 시작되고 started() 신호가 전송될 때까지 또는 msecs 밀리초가 경과할 때까지 차단합니다.

프로세스가 성공적으로 시작되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다(작업 시간이 초과되었거나 오류가 발생한 경우). 이 함수를 사용하기 전에 프로세스가 이미 성공적으로 시작되었다면 즉시 반환됩니다.

이 함수는 이벤트 루프 없이 작동할 수 있습니다. 이 함수는 비-GUI 애플리케이션을 작성하거나 비-GUI 스레드에서 I/O 작업을 수행할 때 유용합니다.

msecs가 -1이면 이 함수는 시간 초과되지 않습니다.

started(), waitForReadyRead(), waitForBytesWritten() 및 waitForFinished()도 참조하세요 .

QString QProcess::workingDirectory() const

QProcess 에 작업 디렉터리가 할당된 경우 이 함수는 프로그램이 시작되기 전에 QProcess 에 입력할 작업 디렉터리를 반환합니다. 그렇지 않으면(즉, 디렉터리가 할당되지 않은 경우) 빈 문자열이 반환되고 QProcess 대신 애플리케이션의 현재 작업 디렉터리가 사용됩니다.

setWorkingDirectory()도 참조하세요 .