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など）間のキャストがサポートされています。

fromType で記述された型からtoType で記述された型へのqobject_cast が成功する場合、QObject から派生した型のポインタ間の変換もこの関数で真を返します。

シーケンシャルコンテナからのキャストも、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 がtoType 型のミュータブル・ビューをfromType 型上に作成できる場合、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 の場合、値は順序なしとなる。比較は、型の less than 演算子がメタタイプ宣言で可視であった場合にのみサポートされます。

型の等号演算子も表示されていた場合、値は等号演算子が等号であると言う場合にのみ比較されます。等号演算子がない場合、どちらの値も他方の値より小さい場合、値は等しいとみなされます。等号演算子も使用可能で、そのような2つの値が等しくない場合、浮動小数点型のNaN（数値ではない）値がその順序の外にあるのと同じように、それらは順序なしとみなされます。

この関数は Qt 6.0 で導入されました。

equals() およびisOrdered()も参照してください 。

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

where によってアドレス指定された既存のメモリに、このQMetaType インスタンスが構築された型の値を構築し、それはcopy のコピーであり、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

このQMetaType インスタンスが作成された型であると仮定して、copy のコピーを返す。copy がnullptr の場合、デフォルトのインスタンスを作成します。

QMetaType::destroy()も参照してください 。

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

rhs のオブジェクトをデバッグ・ストリームdbg にストリームします。成功した場合はtrue を返し、そうでない場合は false を返します。

void QMetaType::destroy(void *data) const

このQMetaType インスタンスが作成された型であると仮定して、data を破棄します。

QMetaType::create()も参照してください 。

void QMetaType::destruct(void *data) const

このQMetaType インスタンスが作成された型であることを前提に、data にある値を破棄します。

destroy() とは異なり、この関数は型のデストラクタを呼び出すだけで、delete 演算子は呼び出されません。

QMetaType::construct()も参照 。

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

lhs とrhs のオブジェクトが等しいかどうかを比較する。

どちらのオブジェクトもこのメタタイプで記述された型でなければなりません。2つのオブジェクトを比較できるのは、メタタイプの宣言時に、その型に対する小なり演算子または等号演算子が見えていた場合のみです。そうでない場合、メタタイプは値が等しいと見なしません。等号演算子がメタタイプ宣言で可視であった場合、それが権威となります。そうでない場合、less than が可視であれば、どちらの値も他方の値より小さい場合、両者は等しいとみなされます。値が順序付けされていない場合（詳細はcompare() を参照）、それらは等しくない。

2つのオブジェクトが等しいと比較された場合はtrueを返し、そうでない場合はfalseを返します。

この関数は 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)

メタ型システムがメタ型 IDfromType からの変換を登録している場合は、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)

メタ・タイプ・システムが、メタ・タイプIDtoType のメタ・タイプIDfromType に登録されたミュータブル・ビューを持っている場合、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-constructed であれば true を返します。QMetaType は現在、この特性を利用するための API を持っていません。

この関数は Qt 6.5 で導入されました。

flags(),isDefaultConstructible(),isCopyConstructible(),isDestructible()も参照してください 。

bool QMetaType::isOrdered() const

このメタタイプで記述された型の less than 演算子がメタタイプ宣言で可視であった場合はtrue を返し、そうでない場合はfalse を返します。

compare() およびisEqualityComparable()も参照 。

bool QMetaType::isRegistered() const

このQMetaType オブジェクトが Qt グローバルメタタイプレジストリに登録されている場合、true を返します。登録することで、（QMetaType::fromName() を使用した）名前、または（コンストラクタを使用した）IDによって型を見つけることができます。

qRegisterMetaType() およびisValid()も参照してください 。

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

IDtype を持つデータ型が登録されている場合は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 を返します。

通常、この関数を直接呼び出す必要はありません。その代わりに、QVariant のoperator>>() を使用してください。 は、load() に依存してカスタム・タイプをストリーミングします。

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

これはオーバーロードされた関数です。

To From::function() const のようなメソッドfunction を、メタ型システムにおけるFrom型からTo型へのコンバータとして登録します。登録に成功した場合は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)

これはオーバーロードされた関数です。

メタ型システムのFrom型からTo型へのコンバータとして単項関数オブジェクトfunction を登録します。登録が成功すればtrue を返し、そうでなければ false を返します。

function は、 型のインスタンスを取り、 型のインスタンスを返さなければなりません。これは、関数ポインタ、ラムダ、またはファンクタオブジェクトであることができます。Qt 6.5以降、 は、変換に失敗したことを示すために、 のインスタンスを返すこともできます。From To 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)

これはオーバーロードされた関数です。

To From::function() のようなメソッドfunction を、メタ型システムのFrom 型のTo 型のミュータブル・ビューとして登録します。登録が成功すれば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 を型レジストリに登録し、QMetaType::fromName() を使って名前で見つけられるようにします。

この関数は Qt 6.5 で導入されました。

qRegisterMetaType()も参照してください 。

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

data が指すオブジェクトを、与えられたstream に書き込みます。オブジェクトが正常に保存された場合はtrue を返し、そうでない場合はfalse を返します。

通常、この関数を直接呼び出す必要はありません。その代わりに、QVariant のoperator<<() を使用してください。 は、 save() に依存してカスタム・タイプをストリーミングします。

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)

fromType のfrom にあるオブジェクトに対して、to のtoType で型付けされた事前に割り当てられた空間に、変更可能なビューを作成します。変換が成功すればtrue を返し、そうでなければ false を返します。

この関数は Qt 6.0 で導入されました。