QDBusArgument Class

멤버 함수 문서

QDBusArgument::QDBusArgument()

빈 QDBusArgument 인수를 생성합니다.

빈 QDBusArgument 객체는 읽기나 쓰기 작업을 수행할 수 없습니다.

QDBusArgument::QDBusArgument(const QDBusArgument &other)

other QDBusArgument 객체의 복사본을 생성합니다.

따라서 이 시점부터 두 객체 모두 동일한 상태를 갖게 됩니다. QDBusArgument는 명시적으로 공유되므로, 어느 한 쪽의 복사본에 변경 사항이 발생하면 다른 쪽에도 영향을 미칩니다.

[noexcept] QDBusArgument::~QDBusArgument()

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

QVariant QDBusArgument::asVariant() const

현재 인수를 ` QVariant` 형식으로 반환합니다. 기본 유형은 디코딩되어 ` QVariant`에 담겨 반환되지만, 복합 유형의 경우 이 함수는 ` QDBusArgument ` 객체를 ` QVariant`에 담아 반환합니다. 인수를 디코딩하는 작업(예: 해당 객체 내에서 `asVariant()`를 호출하는 방식)은 호출자의 책임입니다.

예를 들어, 현재 인수가 INT32인 경우, 이 함수는 QMetaType::Int 유형의 인수를 가진 QVariant 를 반환합니다. INT32 배열의 경우, QDBusArgument 를 포함하는 QVariant 를 반환합니다.

오류가 발생하거나 더 이상 디코딩할 인수가 없는 경우(즉, 인수 목록의 끝에 도달한 경우), 이 함수는 유효하지 않은 QVariant 를 반환합니다.

atEnd()도 참조하십시오 .

bool QDBusArgument::atEnd() const

이 ` QDBusArgument`에서 추출할 요소가 더 이상 없으면 ` true `를 반환합니다. 이 함수는 주로 ` beginMap()` 및 ` beginArray()`에서 반환되는 ` QDBusArgument ` 객체에서 사용됩니다.

void QDBusArgument::beginArray() const

D-Bus 배열을 재귀적으로 탐색하여 배열 요소를 추출할 수 있도록 합니다.

이 함수는 일반적으로 다음 예제와 같이 ` operator>> ` 스트리밍 연산자에서 사용됩니다:

// Extract a MyArray array of MyElement elements
const QDBusArgument &operator>>(const QDBusArgument &argument, MyArray &myArray)
{
    argument.beginArray();
    myArray.clear();

    while (!argument.atEnd()) {
        MyElement element;
        argument >> element;
        myArray.append(element);
    }

    argument.endArray();
    return argument;
}

디마셜링하려는 유형이 ` QList `이거나 템플릿 매개변수 하나를 받는 Qt의 컨테이너 클래스 중 하나라면, ` Qt D-Bus `이 데이터 디마셜링 작업을 수행하는 제네릭 템플릿을 제공하므로 해당 유형에 대한 ` operator>> ` 함수를 별도로 선언할 필요가 없습니다. 이는 ` std::list`, ` std::vector` 등과 같은 STL의 시퀀스 컨테이너에도 동일하게 적용됩니다.

atEnd(), beginStructure(), beginMap()도 참조하십시오 .

void QDBusArgument::beginArray(QMetaType id)

id 메타 유형의 요소를 추가하는 데 적합한 새로운 D-Bus 배열을 엽니다.

이 함수는 일반적으로 다음 예제와 같이 operator<< 스트리밍 연산자에서 사용됩니다:

// Append an array of MyElement types
QDBusArgument &operator<<(QDBusArgument &argument, const MyArray &myArray)
{
    argument.beginArray(qMetaTypeId<MyElement>());
    for (const auto &element : myArray)
        argument << element;
    argument.endArray();
    return argument;
}

마샬링하려는 유형이 ` QList `이거나 템플릿 매개변수를 하나 받는 Qt의 컨테이너 클래스 중 하나라면, ` Qt D-Bus `이 데이터 마샬링 작업을 수행하는 제네릭 템플릿을 제공하므로 해당 유형에 대한 ` operator<< ` 함수를 별도로 선언할 필요가 없습니다. 이는 ` std::list`, ` std::vector` 등과 같은 STL의 시퀀스 컨테이너에도 동일하게 적용됩니다.

endArray(), beginStructure(), beginMap()도 참조하십시오 .

void QDBusArgument::beginMap() const

D-Bus 맵을 재귀적으로 탐색하여 맵의 요소를 추출할 수 있게 합니다.

이 함수는 일반적으로 다음 예제와 같이 ` operator>> ` 스트리밍 연산자에서 사용됩니다:

// Extract a MyDictionary map that associates integers to MyElement items
const QDBusArgument &operator>>(const QDBusArgument &argument, MyDictionary &myDict)
{
    argument.beginMap();
    myDict.clear();

    while (!argument.atEnd()) {
        int key;
        MyElement value;
        argument.beginMapEntry();
        argument >> key >> value;
        argument.endMapEntry();
        myDict.insert(key, value);
    }

    argument.endMap();
    return argument;
}

디마셜링하려는 유형이 ` QMap ` 또는 ` QHash`인 경우, ` Qt D-Bus `가 데이터 디마셜링 작업을 수행하는 제네릭 템플릿을 제공하므로 해당 유형에 대한 ` operator>> ` 함수를 별도로 선언할 필요가 없습니다.

endMap(), beginStructure(), beginArray(), beginMapEntry()도 참조하십시오 .

void QDBusArgument::beginMap(QMetaType keyMetaType, QMetaType valueMetaType)

요소를 추가하기에 적합한 새로운 Qt D-Bus 맵을 엽니다. 맵은 Qt XML의 ` QMap `이나 ` QHash`과 같이, 하나의 항목(키)을 다른 항목(값)과 연결하는 컨테이너입니다. 맵의 키 및 값 메타 타입 ID는 각각 ` keyMetaType ` 및 ` valueMetaType `에 전달되어야 합니다.

이 함수는 일반적으로 다음 예제와 같이 operator<< 스트리밍 연산자에서 사용됩니다:

// Append a dictionary that associates ints to MyValue types
QDBusArgument &operator<<(QDBusArgument &argument, const MyDictionary &myDict)
{
    argument.beginMap(QMetaType::fromType<int>(), QMetaType::fromType<MyValue>());
    MyDictionary::const_iterator i;
    for (i = myDict.cbegin(); i != myDict.cend(); ++i) {
        argument.beginMapEntry();
        argument << i.key() << i.value();
        argument.endMapEntry();
    }
    argument.endMap();
    return argument;
}

QHash 이나 std::map과 같은 연관 컨테이너의 경우, Qt D-Bus 이 데이터 마샬링 작업을 수행하는 제네릭 템플릿을 제공하므로 일반적으로 operator<< 또는 operator>> 함수를 별도로 정의할 필요가 없습니다.

endMap(), beginStructure(), beginArray(), beginMapEntry()도 참조하십시오 .

void QDBusArgument::beginMapEntry()

키 및 값 항목을 추가하기에 적합한 D-Bus 맵 항목을 엽니다. 이 함수는 beginMap()을 사용하여 맵을 연 경우에만 유효합니다.

이 함수의 사용 예제는 beginMap()을 참조하십시오.

endMapEntry() 및 beginMap()도 참조하십시오 .

void QDBusArgument::beginMapEntry() const

D-Bus 맵 항목을 재귀적으로 탐색하여 키-값 쌍을 추출할 수 있도록 합니다.

이 함수가 일반적으로 어떻게 사용되는지에 대한 예제는 beginMap()을 참조하십시오.

endMapEntry() 및 beginMap()도 참조하십시오 .

void QDBusArgument::beginStructure()

새로운 인수를 추가할 수 있는 새로운 D-Bus 구조체를 엽니다.

이 함수는 일반적으로 다음 예제와 같이 operator<< 스트리밍 연산자에서 사용됩니다:

QDBusArgument &operator<<(QDBusArgument &argument, const MyStructure &myStruct)
{
    argument.beginStructure();
    argument << myStruct.member1 << myStruct.member2;
    argument.endStructure();
    return argument;
}

구조체는 다른 구조체를 포함할 수 있으므로 다음 코드도 유효합니다:

QDBusArgument &operator<<(QDBusArgument &argument, const MyStructure &myStruct)
{
    argument.beginStructure();
    argument << myStruct.member1 << myStruct.member2;

    argument.beginStructure();
    argument << myStruct.member3.subMember1 << myStruct.member3.subMember2;
    argument.endStructure();

    argument << myStruct.member4;
    argument.endStructure();
    return argument;
}

endStructure(), beginArray(), beginMap()도 참조하십시오 .

void QDBusArgument::beginStructure() const

요소를 추출하기에 적합한 D-Bus 구조체를 엽니다.

이 함수는 일반적으로 다음 예제와 같이 operator>> 스트리밍 연산자에서 사용됩니다.

const QDBusArgument &operator>>(const QDBusArgument &argument, MyStructure &myStruct)
{
    argument.beginStructure();
    argument >> myStruct.member1 >> myStruct.member2 >> myStruct.member3;
    argument.endStructure();
    return argument;
}

endStructure(), beginArray(), beginMap()도 참조하십시오 .

QDBusArgument::ElementType QDBusArgument::currentType() const

현재 요소 유형의 분류를 반환합니다. 유형 디코딩 중 오류가 발생하거나 인수의 끝 부분에 도달한 경우, 이 함수는 ` QDBusArgument::UnknownType`를 반환합니다.

이 함수는 인수를 디마샬링할 때만 의미가 있습니다. 마샬링 중에 이 함수를 사용하면 항상 ` UnknownType`를 반환합니다.

void QDBusArgument::endArray()

beginArray() 함수로 열린 D-Bus 배열을 닫습니다. 이 함수는 beginArray() 함수가 호출된 횟수와 동일한 횟수만큼 호출되어야 합니다.

beginArray(), endStructure() 및 endMap()도 참조하십시오 .

void QDBusArgument::endArray() const

D-Bus 배열을 닫고, 배열이 끝난 후 다음 요소를 추출할 수 있도록 합니다.

beginArray()도 참조하십시오 .

void QDBusArgument::endMap()

beginMap() 함수로 열린 D-Bus 맵을 닫습니다. 이 함수는 beginMap() 함수가 호출된 횟수와 동일한 횟수만큼 호출되어야 합니다.

beginMap(), endStructure() 및 endArray()도 참조하십시오 .

void QDBusArgument::endMap() const

D-Bus 맵을 닫고, 맵 다음에 오는 요소를 추출할 수 있게 합니다.

beginMap()도 참조하십시오 .

void QDBusArgument::endMapEntry()

beginMapEntry() 함수로 열린 D-Bus 맵 항목을 닫습니다. 이 함수는 beginMapEntry() 함수가 호출된 횟수와 동일한 횟수만큼 호출되어야 합니다.

beginMapEntry()도 참조하십시오 .

void QDBusArgument::endMapEntry() const

D-Bus 맵 항목을 닫고, 맵에서 다음 요소를 추출할 수 있도록 합니다.

beginMapEntry()도 참조하십시오 .

void QDBusArgument::endStructure()

beginStructure() 함수로 열린 D-Bus 구조체를 닫습니다. 이 함수는 beginStructure() 함수가 호출된 횟수와 동일한 횟수만큼 호출되어야 합니다.

beginStructure(), endArray() 및 endMap()도 참조하십시오 .

void QDBusArgument::endStructure() const

D-Bus 구조체를 닫고, 구조체 다음에 있는 요소를 추출할 수 있도록 합니다.

beginStructure()도 참조하십시오 .

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

이 인수를 ` other`와 서로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QDBusArgument &QDBusArgument::operator<<(uchar arg)

BYTE 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(bool arg)

BOOLEAN 유형의 기본 값 ` arg `을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(const QByteArray &arg)

arg 에 의해 ARRAY of BYTE 로 지정된 QByteArray 를 D-Bus 스트림에 추가합니다.

QStringList QByteArray 는 Qt 애플리케이션에서 널리 사용되기 때문에 에서 직접 지원하는 유일한 두 가지 비기본형(non-primitive) 유형입니다. QDBusArgument

그 외의 배열은 Qt D-Bus 의 복합 타입을 통해 지원됩니다.

QDBusArgument &QDBusArgument::operator<<(const QDBusVariant &arg)

VARIANT 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

Qt D-Bus 변형 유형은 다른 변형 유형을 포함하여 어떤 유형이든 포함할 수 있습니다. 이는 Qt XML의 ` QVariant ` 유형과 유사합니다.

QDBusArgument &QDBusArgument::operator<<(const QString &arg)

STRING (유니코드 문자열) 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(const QStringList &arg)

arg 에 의해 정의된 QStringList 를 ARRAY of STRING 형태로 D-Bus 스트림에 추가합니다.

QStringList QByteArray 는 Qt 애플리케이션에서 널리 사용되기 때문에 에서 직접 지원하는 유일한 두 가지 비기본 유형입니다. QDBusArgument

그 외의 배열은 Qt D-Bus 의 복합 타입을 통해 지원됩니다.

QDBusArgument &QDBusArgument::operator<<(double arg)

DOUBLE (이중 정밀도 부동 소수점) 유형의 원시 값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(int arg)

INT32 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(qlonglong arg)

INT64 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(qulonglong arg)

UINT64 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(short arg)

INT16 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(uint arg)

UINT32 유형의 기본 값 arg 을 D-Bus 스트림에 추가합니다.

QDBusArgument &QDBusArgument::operator<<(ushort arg)

UINT16 유형의 기본값 arg 을 D-Bus 스트림에 추가합니다.

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

other QDBusArgument 객체를 이 객체로 복사합니다.

따라서 이 시점부터 두 객체 모두 동일한 상태를 갖게 됩니다. QDBusArguments는 명시적으로 공유되므로, 한 쪽의 복사본을 수정하면 다른 쪽에도 영향을 미칩니다.

const QDBusArgument &QDBusArgument::operator>>(uchar &arg) const

D-Bus 스트림에서 ` BYTE ` 유형의 D-Bus 프리미티브 인자 하나를 추출하여 ` arg`에 저장합니다.

const QDBusArgument &QDBusArgument::operator>>(QByteArray &arg) const

D-Bus 스트림에서 바이트 배열을 추출하여 ` QByteArray`로 반환합니다.

QStringList QByteArray 는 Qt 애플리케이션에서 널리 사용되기 때문에 에서 직접 지원하는 유일한 두 가지 비기본형(non-primitive) 유형입니다. QDBusArgument

다른 배열은 Qt D-Bus 의 복합 유형을 통해 지원됩니다.

const QDBusArgument &QDBusArgument::operator>>(QDBusVariant &arg) const

D-Bus 스트림에서 ` VARIANT ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

Qt D-Bus 변형 타입은 다른 변형 타입을 포함하여 어떤 타입이든 포함할 수 있습니다. 이는 Qt XML의 ` QVariant ` 타입과 유사합니다.

변형체에 ` QDBusArgument`가 직접 지원하지 않는 타입이 포함된 경우, 반환된 ` QDBusVariant `의 값에는 다른 ` QDBusArgument`가 포함됩니다. 이를 다른 타입으로 추가로 디마셜링하는 것은 사용자의 책임입니다.

const QDBusArgument &QDBusArgument::operator>>(QString &arg) const

D-Bus 스트림에서 ` STRING `(유니코드 문자열) 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(QStringList &arg) const

D-Bus 스트림에서 문자열 배열을 추출하여 ` QStringList` 객체로 반환합니다.

QStringList QByteArray 는 Qt 애플리케이션에서 널리 사용되기 때문에 에서 직접 지원하는 유일한 두 가지 비기본형입니다. QDBusArgument

다른 배열은 ` Qt D-Bus`의 복합 유형을 통해 지원됩니다.

const QDBusArgument &QDBusArgument::operator>>(bool &arg) const

D-Bus 스트림에서 ` BOOLEAN ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(double &arg) const

D-Bus 스트림에서 ` DOUBLE `(이중 정밀도 부동 소수점) 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(int &arg) const

D-Bus 스트림에서 ` INT32 ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(qlonglong &arg) const

D-Bus 스트림에서 ` INT64 ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(qulonglong &arg) const

D-Bus 스트림에서 ` UINT64 ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(short &arg) const

D-Bus 스트림에서 ` INT16 ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(uint &arg) const

D-Bus 스트림에서 ` UINT32 ` 유형의 D-Bus 프리미티브 인자 하나를 추출합니다.

const QDBusArgument &QDBusArgument::operator>>(ushort &arg) const

D-Bus 스트림에서 ` UINT16 ` 유형의 D-Bus 프리미티브 인수를 하나 추출합니다.