QDBusArgument Class

멤버 함수 문서

QDBusArgument::QDBusArgument()

빈 QDBusArgument 인자를 구축합니다.

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

QDBusArgument::QDBusArgument(const QDBusArgument &other)

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

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

[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)

요소를 추가하기에 적합한 새 D-Bus 맵을 엽니다. 맵은 한 항목(키)을 다른 항목(값)에 연결하는 컨테이너로, Qt의 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;
}

Qt D-Bus 에서 데이터 마샬링 작업을 수행하는 일반 템플릿을 제공하기 때문에 QHash 또는 std::map과 같은 연관 컨테이너에는 일반적으로 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 에서 제공한 QByteArray 을 ARRAY of BYTE 로 D-Bus 스트림에 추가합니다.

QStringList 와 QByteArray 는 Qt 응용 프로그램에서 널리 사용되기 때문에 QDBusArgument 에서 직접 지원되는 유일한 두 가지 비 프리미티브 형입니다.

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

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

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

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

D-Bus 변형 유형은 다른 변형을 포함한 모든 유형을 포함할 수 있습니다. Qt 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 응용 프로그램에서 널리 사용되기 때문에 QDBusArgument 에서 직접 지원하는 유일한 두 가지 비 프리미티브 유형입니다.

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

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

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

D-Bus 스트림에서 VARIANT 타입의 D-Bus 기본 인자 하나를 추출합니다.

D-Bus 변형 형은 다른 변형을 포함한 모든 형을 포함할 수 있습니다. Qt 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 프리미티브 인자 하나를 추출합니다.