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" 프로그램은 유닉스와 윈도우 모두에서 콘솔에 텍스트 데이터를 표시하는 데 사용됩니다. 하지만 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 = {})

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

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

인자 처리는 해당 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()

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

반환되는 파일 경로는 네이티브 디렉터리 구분 기호를 사용합니다.

QProcess::setStandardInputFile(), QProcess::setStandardOutputFile() 및 QProcess::setStandardErrorFile()도 참조하십시오 .

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

QIODevice::open(QIODeviceBase::OpenMode mode)를 재구현합니다.

setProgram()로 설정된 프로그램을 setArguments()로 설정된 인수를 사용하여 시작합니다. 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(char *data, 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)

유닉스 시스템(macOS 포함; Windows의 경우 setCreateProcessArgumentsModifier() 참조)에서 자식 프로세스에 대한 ` modifier ` 함수를 설정합니다. ` modifier ` 인자에 포함된 함수는 ` fork() ` 또는 ` vfork() `이 완료되고, ` QProcess `이 자식 프로세스에 대한 표준 파일 디스크립터를 설정한 후, ` execve()`이 호출되기 전, ` start()` 내부에서 자식 프로세스에서 호출됩니다.

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

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 `에 대상 실행 파일을 실행하기 전에 자식 프로세스를 수정하도록 요청하는 데 사용할 수 있습니다.

이 함수는 불필요한 파일 설명자를 모두 닫거나, 자식 프로세스의 nice 레벨을 변경하거나, 제어용 TTY와의 연결을 끊는 등 자식 프로세스의 특정 속성을 변경하는 데 사용할 수 있습니다. 자식 프로세스를 더 세밀하게 제어하거나 다른 방식으로 수정하려면 setChildProcessModifier() 함수를 사용하십시오. 자식 프로세스 수정자와 유닉스 프로세스 매개변수가 모두 설정된 경우, 해당 매개변수가 적용되기 전에 수정자가 실행됩니다.

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

unixProcessParameters() 및 setChildProcessModifier()도 참조하십시오 .

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

유닉스 시스템에서 자식 프로세스에 대한 추가 설정을 ` flagsOnly`로 설정합니다. 이는 ` flags ` 필드만 설정된 오버로드와 동일합니다.

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

unixProcessParameters() 및 setChildProcessModifier()도 참조하십시오 .

void QProcess::setWorkingDirectory(const QString &dir)

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

workingDirectory() 및 start()도 참조하십시오 .

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

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

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

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

지정된 ` program `을 새 프로세스에서 시작하며, ` arguments`에 포함된 명령줄 인수를 전달합니다. ` QProcess `가 실행할 실행 파일을 검색하는 방법에 대한 자세한 내용은 ` setProgram()`을 참조하십시오. `OpenMode`는 ` mode`로 설정됩니다. 인수는 더 이상 분할되지 않습니다.

QProcess 객체는 즉시 Starting 상태로 진입합니다. 프로세스가 성공적으로 시작되면 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)

setProgram()로 설정된 프로그램을 setArguments()로 설정된 인자와 함께 시작합니다. 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 를 반환합니다. 호출한 프로세스가 종료되더라도 분리된 프로세스는 영향을 받지 않고 계속 실행됩니다.

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

프로세스는 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)

인수 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()도 참조하십시오 .