QMetaType Class

멤버 함수 문서

[constexpr noexcept default, 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 를 반환합니다. 이는 주로 변환을 수행할 수 있는 능력에 관한 것이며, 실제 변환을 시도할 때 실패할 수도 있다는 점에 유의하십시오(예: 범위를 벗어난 부동 소수점 값을 정수로 변환하는 경우).

registerConverter() 함수는 내장형과 비내장형 사이, 또는 두 비내장형 간의 추가 변환을 등록하는 데 사용할 수 있습니다. 이 함수는 변환 경로가 등록되면 true 를 반환합니다.

Qt에서는 다음 변환을 지원합니다:

지원되는 다른 변환으로는 모든 기본 유형(int, float, bool 등, 모든 열거형 포함) 간의 변환과, 모든 포인터 유형과 std::nullptr_t 간의 변환이 있습니다. 열거형은 QString 및 QByteArray 로도 변환될 수 있습니다.

fromType 와 toType 가 모두 QObject 에서 파생된 유형(또는 해당 유형을 가리키는 포인터)인 경우, 두 유형 중 하나가 다른 하나에서 파생된 것이라면 이 함수는 true 를 반환합니다. 즉, fromType 로 표현된 유형에서 toType 로 표현된 유형으로의 static_cast<> 가 컴파일될 수 있다면 true를 반환합니다. convert() 함수는 qobject_cast()와 유사하게 작동하며, QVariant 가 가리키는 객체의 동적 유형을 검증합니다.

toType 가 QVariantList 인 경우, 순차 컨테이너에서 수행된 형 변환도 이 함수에 대해 true를 반환합니다.

마찬가지로, toType 이 QVariantHash 또는 QVariantMap 인 경우, 연관 컨테이너에서 캐스팅한 결과도 이 함수에 대해 true를 반환합니다.

convert(), QMetaSequence::Iterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QMetaAssociation::Iterable 및 Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE()도 참조하십시오 .

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

QMetaType::view 가 fromType 타입에 대해 toType 타입의 변경 가능한 뷰를 생성할 수 있는 경우, 이 함수는 ` true `를 반환합니다.

QObject 에서 파생된 유형의 포인터 간 변환 시, fromType 로 설명된 유형에서 toType 로 설명된 유형으로의 qobject_cast 가 성공하면 이 함수는 true를 반환합니다.

Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE()에 등록된 모든 컨테이너에 대해 QMetaSequence::Iterable 유형의 변경 가능한 뷰를 생성할 수 있습니다.

마찬가지로 Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE()에 등록된 모든 컨테이너에 대해 QMetaAssociation::Iterable 유형의 변경 가능한 뷰를 생성할 수 있습니다.

convert(), QMetaSequence::Iterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QMetaAssociation::Iterable 및 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 가 지정한 기존 메모리 영역(즉, copy 의 복사본)에 이 QMetaType 인스턴스가 생성될 때 지정된 타입의 값을 생성하고, where 를 반환합니다. copy 가 0인 경우, 값은 기본 생성됩니다.

이는 해당 타입을 저장하는 데 사용되는 메모리를 명시적으로 관리하기 위한 저수준 함수입니다. 이 정도의 제어가 필요하지 않은 경우 create()를 호출하는 것을 고려하십시오(즉, "placement new" 대신 "new"를 사용하십시오).

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

copy 의 복사본을 반환합니다. 단, 해당 객체가 이 QMetaType 인스턴스가 생성된 유형과 일치해야 합니다. copy 가 nullptr 인 경우, 기본 생성된 인스턴스를 생성합니다.

QMetaType::destroy()도 참조하십시오 .

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

rhs 에 있는 객체를 디버그 스트림 dbg 으로 스트리밍합니다. 성공 시 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

void QMetaType::destroy(void *data) const

data 를 파기합니다. 단, 해당 가 이 QMetaType 인스턴스가 생성된 용도에 맞는 유형이어야 합니다.

QMetaType::create()도 참조하십시오 .

void QMetaType::destruct(void *data) const

data 에 위치한 값을, 이 QMetaType 인스턴스가 생성된 유형에 속한다고 가정하고 소멸시킵니다.

destroy()와 달리, 이 함수는 해당 타입의 소멸자만 호출하며, delete 연산자는 호출하지 않습니다.

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

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

lhs 및 rhs 에 있는 객체들이 동일한지 비교합니다.

두 객체 모두 이 메타타입에 의해 정의된 유형이어야 합니다. 해당 유형에 대한 ‘보다 작음’ 또는 ‘동일함’ 연산자가 메타타입 선언에서 가시적인 경우에만 두 객체를 비교할 수 있습니다. 그렇지 않은 경우, 메타타입은 절대로 값을 동일하다고 간주하지 않습니다. 메타타입 선언에서 등호 연산자가 가시적인 경우, 해당 연산자가 기준이 됩니다. 그렇지 않은 경우, '보다 작음' 연산자가 가시적이고 두 값 중 어느 것도 다른 값보다 작지 않을 때, 두 값은 동일한 것으로 간주됩니다. 값들이 순서가 정해지지 않은 경우(자세한 내용은 compare() 참조), 두 값은 동일하지 않습니다.

두 객체가 같으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

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

isEqualityComparable() 및 compare()도 참조하십시오 .

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

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

QMetaType::TypeFlags, isDefaultConstructible(), isCopyConstructible(), isMoveConstructible(), isDestructible(), isEqualityComparable() 및 isOrdered()도 참조하십시오 .

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

typeName 와 일치하는 ` QMetaType `를 반환합니다. `typeName`이 다음에서 인식되지 않는 경우, 반환된 객체는 유효하지 않습니다. QMetaType

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

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

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

true메타 타입 시스템에 메타 타입 ID fromType 에서 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)

메타 타입 시스템에 메타 타입 ID toType 에 대한 메타 타입 ID fromType 의 등록된 가변 뷰가 있는 경우, ` true`를 반환합니다.

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

메타 타입 시스템에 To 타입에 대한 From 타입의 등록된 가변 뷰가 있는 경우, ` true`를 반환합니다.

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

int QMetaType::id() const

이 ` QMetaType ` 인스턴스가 보유한 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

이 유형이 기본 생성될 수 있는 경우 true를 반환합니다. 기본 생성될 수 있다면, ` construct()` 및 ` create()` 함수를 ` copy ` 매개변수가 null인 상태로 사용할 수 있습니다.

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

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

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

이 타입을 소멸시킬 수 있으면 true를 반환합니다. 소멸시킬 수 있다면, ` 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

이 유형이 이동 생성(move-construct)될 수 있는 경우 true를 반환합니다. 현재 ` QMetaType `에는 이 트레이트를 활용할 수 있는 API가 없습니다.

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

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

bool QMetaType::isOrdered() const

이 메타타입이 설명하는 유형에 대한 ‘보다 작음’ 연산자가 메타타입 선언에서 가시적이었다면 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

compare() 및 isEqualityComparable()도 참조하십시오 .

[noexcept] bool QMetaType::isRegistered() const

이 QMetaType 객체가 Qt 전역 메타타입 레지스트리에 등록된 경우 true 를 반환합니다. 등록을 통해 해당 타입은 이름( QMetaType::fromName())을 사용하거나 ID(생성자)를 사용하여 찾을 수 있습니다.

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

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

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

type() 및 Type도 참조하십시오 .

[constexpr noexcept] 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 를 반환합니다. 이를 사용하여 QMetaMethod 및 QMetaProperty 를 가져와, 예를 들어 QVariant::data()에서 제공되는 바와 같이 이 타입의 포인터에 적용할 수 있습니다.

타입이 열거형인 경우, flags()은 QMetaType::IsEnumeration 를 포함합니다. 이 경우, 해당 열거형이 Q_ENUM 로 등록된 경우 이 함수는 QMetaObject 를 반환하고, 그렇지 않은 경우 nullptr 를 반환합니다.

QMetaType::flags()도 참조하십시오 .

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

이 QMetaType 에 연관된 유형 이름을 반환하거나, 일치하는 유형이 발견되지 않은 경우 null 포인터를 반환합니다. 반환된 포인터는 삭제해서는 안 됩니다.

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::*function)() const)

메타 타입 시스템에서 From 타입에서 To 타입으로의 변환기로서, ` function `와 같은 메서드(예: `To From::function() const`)를 등록합니다. 등록에 성공하면 ` 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::*function)(bool *) const)

메타 타입 시스템에서 From 타입에서 To 타입으로의 변환기로 ` function `와 같은 메서드(예: `To From::function(bool *ok) const`)를 등록합니다. 등록에 성공하면 ` 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 `를 반환하고, 그렇지 않으면 `false`를 반환합니다.

function From 타입의 인스턴스를 인수로 받아 타입의 인스턴스를 반환해야 합니다. 함수 포인터, 람다 또는 펑터 객체일 수 있습니다. Qt 6.5부터는 가 변환 실패를 표시할 수 있도록 타입의 인스턴스를 반환할 수도 있습니다. To function std::optional<To>

QMetaType::registerConverter<CustomStringType, QString>([](const CustomStringType &str) {
    return QString::fromUtf8(str.data());
});
QMetaType::registerConverter<QJsonValue, CustomPointType>(
          [](const QJsonValue &value) -> std::optional<CustomPointType> {
    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 CustomPointType{object["x"].toDouble(), object["y"].toDouble()};
});

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

메타 타입 시스템 내에서 From 타입에 대해 To 타입의 가변 뷰인 function (예: To From::function() ) 메서드를 등록합니다. 등록에 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

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

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

메타 타입 시스템에서 From 타입에 대한 To 타입의 가변 뷰로서 단항 함수 객체 function 를 등록합니다. 등록에 성공하면 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::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)

fromType to 에 위치한 타입의 사전 할당된 공간 내, 에 있는 객체에 대한 가변 뷰를 생성합니다. 변환이 성공하면 를 반환하고, 그렇지 않으면 false를 반환합니다. toType from true

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