QMetaType Class

멤버 함수 문서

[constexpr noexcept, since 6.0] QMetaType::QMetaType()

기본, 유효하지 않은 QMetaType 객체를 구축합니다.

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

[explicit] QMetaType::QMetaType(int typeId)

typeId 유형에 대한 모든 정보를 포함하는 QMetaType 객체를 생성합니다.

[constexpr, since 6.0] qsizetype QMetaType::alignOf() const

타입의 정렬을 바이트 단위로 반환합니다(즉, alignof(T), 여기서 T는 이 QMetaType 인스턴스가 생성된 실제 타입입니다).

이 함수는 일반적으로 construct()와 함께 사용하여 형이 사용하는 메모리의 저수준 관리를 수행합니다.

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

QMetaType::construct() 및 QMetaType::sizeOf()도 참조하십시오 .

[static] bool QMetaType::canConvert(QMetaType fromType, QMetaType toType)

QMetaType::convert 이 fromType 에서 toType 로 변환할 수 있으면 true 을 반환합니다.

Qt에서 지원하는 변환은 다음과 같습니다:

기본 타입(int, float, bool 등) 간의 형 변환이 지원됩니다.

QObject 에서 파생된 타입의 포인터 간 변환도 fromType 에서 설명하는 타입에서 toType 에서 설명하는 타입으로 qobject_cast 이 성공할 경우 이 함수에 대해 참을 반환합니다.

순차 컨테이너로부터의 형 변환도 toType 이 QVariantList 인 경우 이 함수에 대해 참을 반환합니다.

마찬가지로 연관 컨테이너로부터의 형변환은 toType 이 QVariantHash 또는 QVariantMap 인 경우에도 이 함수에 대해 참을 반환합니다.

convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE()도 참조하세요 .

[static] bool QMetaType::canView(QMetaType fromType, QMetaType toType)

QMetaType::view 이 fromType 유형에 toType 유형의 가변 뷰를 생성할 수 있으면 true 을 반환합니다.

QObject 에서 파생된 타입의 포인터 간 변환은 fromType 에서 설명하는 타입에서 toType 에서 설명하는 타입으로 qobject_cast 이 성공할 경우 이 함수에 대해 참을 반환합니다.

Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE()에 등록된 모든 컨테이너에서 QSequentialIterable 유형의 변경 가능한 보기를 만들 수 있습니다.

마찬가지로 Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE()에 등록된 모든 컨테이너에 QAssociativeIterable 유형의 변경 가능한 보기를 만들 수 있습니다.

convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE()도 참조하세요 .

[since 6.0] QPartialOrdering QMetaType::compare(const void *lhs, const void *rhs) const

lhs 및 rhs 의 객체를 비교하여 순서를 지정합니다.

비교가 지원되지 않거나 값이 정렬되지 않은 경우 QPartialOrdering::Unordered 를 반환합니다. 그렇지 않으면 lhs 이 rhs 보다 작거나 같거나 크면 각각 QPartialOrdering::Less, QPartialOrdering::Equivalent 또는 QPartialOrdering::Greater 을 반환합니다.

두 객체 모두 이 메타타입에 설명된 유형이어야 합니다. lhs 또는 rhs 이 nullptr 인 경우 값은 순서가 지정되지 않습니다. 비교는 메타타입 선언에 타입의 보다 작음 연산자가 표시된 경우에만 지원됩니다.

타입의 같음 연산자도 표시된 경우, 같음 연산자가 같다고 표시된 경우에만 값이 동일하게 비교됩니다. 같음 연산자가 없는 경우, 두 값이 모두 다른 값보다 작지 않으면 값이 같은 것으로 간주되며, 같음 연산자도 사용할 수 있고 두 값이 같지 않으면 부동 소수점 타입의 NaN(숫자가 아닌) 값이 순서를 벗어나는 것과 마찬가지로 순서가 없는 것으로 간주됩니다.

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

equals() 및 isOrdered()도 참조하십시오 .

void *QMetaType::construct(void *where, const void *copy = nullptr) const

where 으로 주소가 지정된 기존 메모리에 이 QMetaType 인스턴스가 생성된 유형의 값, 즉 copy 의 복사본을 생성하고 where 을 반환합니다. copy 이 0이면 기본값이 생성됩니다.

이 함수는 유형을 저장하는 데 사용되는 메모리를 명시적으로 관리하기 위한 저수준 함수입니다. 이 수준의 제어가 필요하지 않은 경우 create()를 호출하는 것이 좋습니다(즉, "배치 새로 만들기" 대신 "새로 만들기"를 사용).

where 이 새 값을 저장할 수 있는 위치를 가리키고 where 이 적절하게 정렬되어 있는지 확인해야 합니다. 타입의 크기는 sizeOf()를 호출하여 쿼리할 수 있습니다.

정렬에 대한 경험 법칙은 정렬이 플랫폼에 유용한 최대 정렬보다 크지 않는 한 유형보다 큰 2의 가장 작은 거듭제곱인 자연 경계에 유형을 정렬하는 것입니다. 실제로 2 * sizeof(void*)보다 큰 정렬은 특수한 하드웨어 명령어(예: x86에서 정렬된 SSE 로드 및 저장)에만 필요합니다.

[static] bool QMetaType::convert(QMetaType fromType, const void *from, QMetaType toType, void *to)

from 의 객체를 fromType 에서 미리 할당된 공간 to 에 입력한 toType 으로 변환합니다. 변환에 성공하면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

from 및 to 모두 유효한 포인터여야 합니다.

void *QMetaType::create(const void *copy = nullptr) const

QMetaType 인스턴스가 생성된 유형이라고 가정하여 copy 의 복사본을 반환합니다. copy 이 nullptr 인 경우 기본적으로 구성된 인스턴스를 생성합니다.

QMetaType::destroy()도 참조하세요 .

bool QMetaType::debugStream(QDebug &dbg, const void *rhs)

rhs 의 객체를 디버그 스트림 dbg 으로 스트리밍합니다. 성공하면 true 을 반환하고, 그렇지 않으면 거짓을 반환합니다.

void QMetaType::destroy(void *data) const

QMetaType 인스턴스가 생성된 유형이라고 가정하여 data 을 삭제합니다.

QMetaType::create()도 참조하세요 .

void QMetaType::destruct(void *data) const

QMetaType 인스턴스가 생성된 유형이라고 가정하여 data 에 있는 값을 파괴합니다.

destroy()와 달리 이 함수는 타입의 소멸자만 호출하고 삭제 연산자는 호출하지 않습니다.

QMetaType::construct()도 참조하세요 .

[since 6.0] bool QMetaType::equals(const void *lhs, const void *rhs) const

lhs 와 rhs 의 객체가 동일한지 비교합니다.

두 객체 모두 이 메타타입에서 설명하는 유형이어야 합니다. 메타타입 선언에 해당 타입에 대한 같음 연산자 또는 같음 연산자가 표시된 경우에만 두 객체를 비교할 수 있습니다. 그렇지 않으면 메타타입은 값을 같다고 간주하지 않습니다. 메타타입 선언에 같음 연산자가 표시된 경우, 이 연산자는 권한이 있으며, 그렇지 않고 같음이 표시된 경우, 어느 값도 다른 값보다 작지 않으면 두 값이 동일한 것으로 간주됩니다. 값이 정렬되지 않은 경우(자세한 내용은 compare() 참조) 둘은 같지 않습니다.

두 객체가 같으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

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

isEqualityComparable() 및 compare()도 참조하세요 .

[constexpr] QMetaType::TypeFlags QMetaType::flags() const

이 QMetaType 인스턴스가 생성된 타입의 플래그를 반환합니다. 특정 유형 특성을 검사하려면 플래그를 직접 사용하는 것보다 "is-" 함수 중 하나를 사용하는 것이 좋습니다.

QMetaType::TypeFlags, QMetaType::flags(), isDefaultConstructible(), isCopyConstructible(), isMoveConstructible(), isDestructible(), isEqualityComparable(), isOrdered()도 참조하세요 .

[static] QMetaType QMetaType::fromName(QByteArrayView typeName)

typeName 과 일치하는 QMetaType 을 반환합니다. 반환된 객체는 타입 이름을 알 수 없는 경우 유효하지 않습니다. QMetaType

[static constexpr] template <typename T> QMetaType QMetaType::fromType()

템플릿 매개변수의 유형에 해당하는 QMetaType 을 반환합니다.

[static] bool QMetaType::hasRegisteredConverterFunction(QMetaType fromType, QMetaType toType)

메타 타입 시스템에 메타 타입 ID fromType 에서 다음과 같이 등록된 변환이 있는 경우 true 을 반환합니다. toType

[static] template <typename From, typename To> bool QMetaType::hasRegisteredConverterFunction()

메타 유형 시스템에 From 유형에서 To 유형으로의 변환이 등록된 경우 true 을 반환합니다.

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

[since 6.1] bool QMetaType::hasRegisteredDataStreamOperators() const

메타 타입 시스템에 이 메타 타입에 대한 데이터 스트림 연산자가 등록된 경우 true 를 반환합니다.

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

[since 6.0] bool QMetaType::hasRegisteredDebugStreamOperator() const

메타 타입 시스템에 이 메타 타입에 대해 등록된 디버그 스트림 연산자가 있는 경우 true 를 반환합니다.

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

[static] bool QMetaType::hasRegisteredMutableViewFunction(QMetaType fromType, QMetaType toType)

메타 타입 시스템에 메타 타입 아이디 fromType 의 메타 타입 아이디 toType 에 등록된 변경 가능한 뷰가 있는 경우 true 를 반환합니다.

[static, since 6.0] template <typename From, typename To> bool QMetaType::hasRegisteredMutableViewFunction()

메타 유형 시스템에 From 유형의 To 유형에 등록된 변경 가능한 보기가 있는 경우 true 를 반환합니다.

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

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

int QMetaType::id() const

이 Q메타타입 인스턴스가 보유한 ID 유형을 반환합니다.

[noexcept, since 6.5] bool QMetaType::isCopyConstructible() const

이 유형을 복사하여 구성할 수 있으면 true를 반환합니다. 가능한 경우, construct() 및 create()은 null이 아닌 copy 매개 변수와 함께 사용할 수 있습니다.

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

flags(), isDefaultConstructible(), isMoveConstructible() 및 isDestructible()도 참조하십시오 .

[noexcept, since 6.5] bool QMetaType::isDefaultConstructible() const

이 유형을 기본 구성할 수 있으면 참을 반환합니다. 가능한 경우, construct() 및 create()은 null인 copy 매개 변수와 함께 사용할 수 있습니다.

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

flags(), isCopyConstructible(), isMoveConstructible() 및 isDestructible()도 참조하십시오 .

[noexcept, since 6.5] bool QMetaType::isDestructible() const

이 유형을 파괴할 수 있으면 참을 반환합니다. 가능하면 destroy() 및 destruct()를 호출할 수 있습니다.

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

flags(), isDefaultConstructible(), isCopyConstructible() 및 isMoveConstructible()도 참조하십시오 .

bool QMetaType::isEqualityComparable() const

메타타입 선언에 이 메타타입으로 설명된 타입에 대한 같음 연산자가 표시되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

equals() 및 isOrdered()도 참조하세요 .

[noexcept, since 6.5] bool QMetaType::isMoveConstructible() const

이 타입을 이동 구성할 수 있으면 true를 반환합니다. QMetaType 에는 현재 이 특성을 활용하는 API가 없습니다.

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

flags(), isDefaultConstructible(), isCopyConstructible() 및 isDestructible()도 참조하세요 .

bool QMetaType::isOrdered() const

메타타입 선언에 이 메타타입으로 설명된 타입에 대한 연산자보다 작은 연산자가 표시되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

compare() 및 isEqualityComparable()도 참조하세요 .

bool QMetaType::isRegistered() const

이 QMetaType 객체가 Qt 전역 메타형 레지스트리에 등록되어 있으면 true 을 반환합니다. 등록하면 이름( QMetaType::fromName() 사용) 또는 ID(생성자 사용)로 형을 찾을 수 있습니다.

qRegisterMetaType() 및 isValid()도 참조하십시오 .

[static] bool QMetaType::isRegistered(int type)

ID가 type 인 데이터 타입이 등록되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

type(), typeName() 및 Type 를참조하십시오 .

bool QMetaType::isValid() const

이 QMetaType 객체에 유형에 대한 유효한 정보가 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

isRegistered()도 참조하세요 .

bool QMetaType::load(QDataStream &stream, void *data) const

주어진 stream 에서 data 으로 이 타입의 객체를 읽습니다. 객체가 성공적으로 로드되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

일반적으로 이 함수를 직접 호출할 필요는 없습니다. 대신 load()에 의존하는 QVariant 의 operator>>() 을 사용하여 사용자 정의 유형을 스트리밍하세요.

save()도 참조하세요 .

[constexpr] const QMetaObject *QMetaType::metaObject() const

이 타입에 상대적인 QMetaObject 을 반환합니다.

유형이 QObject 의 하위 클래스에 대한 포인터 유형인 경우 flags() 에는 QMetaType::PointerToQObject 이 포함되며 이 함수는 해당 QMetaObject 을 반환합니다. 이 함수는 QMetaObject::newInstance()와 함께 사용하여 이 유형의 QObject를 만들 수 있습니다.

유형이 Q_GADGET 인 경우 flags() 에는 QMetaType::IsGadget 이 포함됩니다. 유형이 Q_GADGET 에 대한 포인터인 경우 flags() 에는 QMetaType::PointerToGadget 이 포함됩니다. 두 경우 모두 이 함수는 QMetaObject 을 반환합니다. 예를 들어 QVariant::data()에 주어진 것처럼 QMetaMethod 및 QMetaProperty 을 검색하여 이 타입의 포인터에 사용할 수 있습니다.

유형이 열거형인 경우 flags()에는 QMetaType::IsEnumeration 이 포함됩니다. 이 경우 이 함수는 열거형이 Q_ENUM 또는 nullptr 로 등록되어 있는 경우 둘러싸는 객체의 QMetaObject 를 반환합니다.

QMetaType::flags()도 참조하세요 .

[constexpr] const char *QMetaType::name() const

이 QMetaType 과 연관된 유형 이름을 반환하거나 일치하는 유형을 찾을 수 없는 경우 널 포인터를 반환합니다. 반환된 포인터는 삭제해서는 안 됩니다.

typeName()도 참조하세요 .

[static] template <typename From, typename To> bool QMetaType::registerConverter()

메타 타입 시스템에서 From 타입에서 To 타입으로의 암시적 변환 가능성을 등록합니다. 등록에 성공하면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

class Counter {
  int number = 0;
public:
  int value() const { return number; }
  operator int() const { return value(); }
  void increment() {++number;}
};
QMetaType::registerConverter<Counter, int>();

[static] template <typename From, typename To> bool QMetaType::registerConverter(To (From::*)() const function)

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

메타 타입 시스템에서 From 타입에서 To 타입으로 변환하는 To From::function() const와 같은 function 메서드를 등록합니다. 등록에 성공하면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

struct Coordinates {
  int x;
  int y;
  int z;

  QString toString() const { return u"[x: %1; y: %2, z: %3]"_s.arg(QString::number(x),
    QString::number(y),
    QString::number(z)); }
};
QMetaType::registerConverter<Coordinates, QString>(&Coordinates::toString);

[static] template <typename From, typename To> bool QMetaType::registerConverter(To (From::*)(bool *) const function)

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

메타 타입 시스템에서 From 타입에서 To 타입으로 변환하는 To From::function(bool *ok) const와 같은 function 메서드를 메타 타입 시스템에 등록합니다. 등록에 성공하면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

ok 포인터는 함수에서 변환 성공 여부를 나타내는 데 사용할 수 있습니다.

struct BigNumber {
    long long l;

    int toInt(bool *ok = nullptr) const {
      const bool canConvertSafely = l < std::numeric_limits<int>::max();
      if (ok)
        *ok = canConvertSafely;
      return l;
    }
};
QMetaType::registerConverter<BigNumber, int>(&BigNumber::toInt);

[static] template <typename From, typename To, typename UnaryFunction> bool QMetaType::registerConverter(UnaryFunction function)

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

메타 타입 시스템에서 단항 함수 객체 function 를 From 타입에서 To 타입으로의 변환기로 등록합니다. 등록에 성공하면 true 을 반환하고, 그렇지 않으면 거짓을 반환합니다.

function 는 From 타입의 인스턴스를 받아 To 의 인스턴스를 반환해야 합니다. 함수 포인터, 람다 또는 함수 객체일 수 있습니다. Qt 6.5부터 function 는 std::optional<To> 의 인스턴스를 반환하여 실패한 변환을 나타낼 수도 있습니다.

QMetaType::registerConverter<CustomStringType, QString>([](const CustomStringType &str) {
    return QString::fromUtf8(str.data());
});
QMetaType::registerConverter<QJsonValue, QPointF>(
          [](const QJsonValue &value) -> std::optional<QPointF> {
    const auto object = value.toObject();
    if (!object.contains("x") || !object.contains("y"))
        return std::nullopt;  // The conversion fails if the required properties are missing
    return QPointF{object["x"].toDouble(), object["y"].toDouble()};
});

[static, since 6.0] template <typename From, typename To> bool QMetaType::registerMutableView(To (From::*)() function)

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

메타 타입 시스템의 From 타입에 To 타입의 변경 가능한 보기로 To From::function() 같은 메서드 function 를 등록합니다. 등록에 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

[static, since 6.0] template <typename From, typename To, typename UnaryFunction> bool QMetaType::registerMutableView(UnaryFunction function)

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

단항 함수 객체 function 를 메타 타입 시스템의 From 타입에 To 타입의 변경 가능한 보기로 등록합니다. 등록에 성공하면 true 를 반환하고, 그렇지 않으면 false 을 반환합니다.

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

[since 6.5] void QMetaType::registerType() const

QMetaType::fromName()을 사용하여 이름으로 찾을 수 있도록 QMetaType 을 유형 레지스트리에 등록합니다.

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

qRegisterMetaType()도 참조하십시오 .

bool QMetaType::save(QDataStream &stream, const void *data) const

data 이 가리키는 객체를 주어진 stream 에 씁니다. 객체가 성공적으로 저장되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

일반적으로 이 함수를 직접 호출할 필요는 없습니다. 대신 save()에 의존하는 QVariant 의 operator<<() 을 사용하여 사용자 정의 유형을 스트리밍하세요.

load()도 참조하세요 .

[constexpr] qsizetype QMetaType::sizeOf() const

타입의 크기를 바이트 단위로 반환합니다(즉, sizeof(T), 여기서 T는 이 QMetaType 인스턴스가 생성된 실제 타입).

이 함수는 일반적으로 construct()와 함께 사용하여 타입이 사용하는 메모리의 저수준 관리를 수행합니다.

QMetaType::construct(), QMetaType::sizeOf() 및 QMetaType::alignOf()도 참조하세요 .

[since 6.6] QMetaType QMetaType::underlyingType() const

이 메타형이 열거형을 나타내는 경우, 이 메서드는 열거형 기본 형과 동일한 부호 및 크기의 숫자 클래스의 메타형을 반환합니다. QFlags 타입을 나타내는 경우 QMetaType::Int 을 반환합니다. 다른 모든 경우에는 유효하지 않은 QMetaType 이 반환됩니다.

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

[static, since 6.0] bool QMetaType::view(QMetaType fromType, void *from, QMetaType toType, void *to)

from to toType 에 미리 할당된 공간에 의 에 있는 객체에 대해 변경 가능한 보기를 생성합니다. 변환에 성공하면 을 반환하고, 그렇지 않으면 거짓을 반환합니다. fromType true

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