QProcessEnvironment Class

멤버 함수 문서

QProcessEnvironment::QProcessEnvironment()

새로운 QProcessEnvironment 객체를 생성합니다. 이 생성자는 빈 환경을 생성합니다. QProcess 에 이 객체를 설정하면, 현재 환경 변수들이 제거됩니다(Windows의 경우 PATH 및 SystemRoot는 제외).

[noexcept, since 6.3] QProcessEnvironment::QProcessEnvironment(QProcessEnvironment::Initialization)

QProcess 에 설정하면 부모 프로세스에서 상속받은 환경 변수를 사용하여 실행되도록 하는 객체를 생성합니다.

부모 환경의 수정된 버전이 필요한 경우, systemEnvironment() 의 반환값을 기반으로 시작하여 이를 수정하십시오(단, 해당 환경이 생성된 후 부모 프로세스의 환경에 가해진 변경 사항은 수정된 환경에 반영되지 않는다는 점에 유의하십시오).

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

inheritsFromParent() 및 systemEnvironment()도 참조하십시오 .

QProcessEnvironment::QProcessEnvironment(const QProcessEnvironment &other)

other 의 복사본인 QProcessEnvironment 객체를 생성합니다.

[noexcept] QProcessEnvironment::~QProcessEnvironment()

이 QProcessEnvironment 객체와 관련된 리소스를 해제합니다.

void QProcessEnvironment::clear()

이 QProcessEnvironment 객체에서 모든 키-값 쌍을 제거하여 객체를 비워줍니다.

환경이 ` QProcessEnvironment::InheritFromParent `를 사용하여 생성된 경우, 환경은 변경되지 않습니다.

isEmpty() 및 systemEnvironment()도 참조하십시오 .

bool QProcessEnvironment::contains(const QString &name) const

이 QProcessEnvironment 객체에서 name 라는 이름의 환경 변수가 발견되면 true 를 반환합니다.

insert() 및 value()도 참조하십시오 .

[since 6.3] bool QProcessEnvironment::inheritsFromParent() const

이 ` QProcessEnvironment ` 객체가 ` QProcessEnvironment::InheritFromParent`을 사용하여 생성된 경우 ` true `을 반환합니다.

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

isEmpty()도 참조하십시오 .

void QProcessEnvironment::insert(const QString &name, const QString &value)

이름 name, 내용 value 인 환경 변수를 이 QProcessEnvironment 객체에 삽입합니다. 해당 변수가 이미 존재하는 경우, 새로운 값으로 대체됩니다.

대부분의 시스템에서, 내용이 없는 변수를 삽입하는 것은 응용 프로그램의 관점에서 해당 변수가 전혀 설정되지 않은 것과 동일한 효과를 냅니다. 그러나 호환성 문제를 방지하기 위해 변수를 제거하려면 remove() 함수를 사용하십시오.

contains(), remove(), value()도 참조하십시오 .

void QProcessEnvironment::insert(const QProcessEnvironment &e)

e 의 내용을 이 QProcessEnvironment 객체에 삽입합니다. 이 객체에 포함되어 있으며 e 에도 존재하는 변수들은 덮어쓰게 됩니다.

bool QProcessEnvironment::isEmpty() const

이 QProcessEnvironment 객체가 비어 있는 경우, 즉 key=value 쌍이 설정되어 있지 않은 경우 true 를 반환합니다.

이 메서드는 QProcessEnvironment::InheritFromParent 를 사용하여 생성된 객체에 대해서도 true 를 반환합니다.

clear(), systemEnvironment(), insert(), inheritsFromParent()도 참조하십시오 .

QStringList QProcessEnvironment::keys() const

이 QProcessEnvironment 객체에 포함된 모든 변수 이름을 담은 목록을 반환합니다.

QProcessEnvironment::InheritFromParent 를 사용하여 생성된 객체의 경우, 반환되는 리스트는 비어 있습니다.

void QProcessEnvironment::remove(const QString &name)

name 로 식별되는 환경 변수를 이 QProcessEnvironment 객체에서 제거합니다. 해당 변수가 이전에 존재하지 않았던 경우, 아무런 작업도 수행되지 않습니다.

contains(), insert() 및 value()도 참조하십시오 .

[noexcept] void QProcessEnvironment::swap(QProcessEnvironment &other)

이 프로세스 환경 인스턴스를 other 로 교체합니다. 이 작업은 매우 빠르게 수행되며 실패하는 일이 없습니다.

[static] QProcessEnvironment QProcessEnvironment::systemEnvironment()

systemEnvironment 함수는 호출한 프로세스의 환경을 반환합니다.

이 값은 ` QProcessEnvironment` 객체로 반환됩니다. 이 함수는 시스템 환경을 캐시하지 않습니다. 따라서 ` setenv `이나 ` putenv `과 같은 저수준 C 라이브러리 함수가 호출된 경우, 환경의 최신 버전을 얻을 수 있습니다.

그러나 이 함수를 반복해서 호출하면 QProcessEnvironment 객체가 새로 생성되며, 이는 상당한 작업 부하를 유발한다는 점에 유의하십시오.

QProcess::systemEnvironment()도 참조하십시오 .

QStringList QProcessEnvironment::toStringList() const

이 QProcessEnvironment 객체를 설정된 각 환경 변수마다 하나씩의 문자열로 구성된 목록으로 변환합니다. 환경 변수의 이름과 값은 등호('=')로 구분됩니다.

이 함수가 반환하는 QStringList 의 내용은 표시용으로 적합합니다. Unix 환경에서 발생할 수 있는 인코딩 문제와 성능 저하로 인해 QProcess::setEnvironment 함수와 함께 사용하는 것은 권장되지 않습니다.

systemEnvironment(), QProcess::systemEnvironment(), QProcess::setProcessEnvironment()도 참조하십시오 .

QString QProcessEnvironment::value(const QString &name, const QString &defaultValue = QString()) const

이 QProcessEnvironment 객체에서 name 로 식별되는 변수를 검색하여 해당 값을 반환합니다. 이 객체에서 변수를 찾을 수 없는 경우, 대신 defaultValue 가 반환됩니다.

contains(), insert(), remove()도 참조하십시오 .

QProcessEnvironment &QProcessEnvironment::operator=(const QProcessEnvironment &other)

other QProcessEnvironment 객체의 내용을 이 객체로 복사합니다.