QMetaType Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein standardmäßiges, ungültiges QMetaType-Objekt.

Diese Funktion wurde in Qt 6.0 eingeführt.

[explicit] QMetaType::QMetaType(int typeId)

Konstruiert ein QMetaType-Objekt, das alle Informationen über den Typ typeId enthält.

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

Gibt die Ausrichtung des Typs in Bytes zurück (d.h. alignof(T), wobei T der tatsächliche Typ ist, für den diese QMetaType Instanz erstellt wurde).

Diese Funktion wird typischerweise zusammen mit construct() verwendet, um eine Low-Level-Verwaltung des von einem Typ verwendeten Speichers durchzuführen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch QMetaType::construct() und QMetaType::sizeOf().

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

Gibt true zurück, wenn QMetaType::convert von fromType nach toType konvertieren kann.

Die folgenden Konvertierungen werden von Qt unterstützt:

Casting zwischen primitiven Typen (int, float, bool usw.) wird unterstützt.

Die Konvertierung zwischen Zeigern von Typen, die von QObject abgeleitet sind, gibt für diese Funktion ebenfalls true zurück, wenn ein qobject_cast von dem durch fromType beschriebenen Typ zu dem durch toType beschriebenen Typ erfolgreich wäre.

Ein Cast aus einem sequentiellen Container gibt für diese Funktion ebenfalls true zurück, wenn der toType QVariantList ist.

In ähnlicher Weise wird ein Cast aus einem assoziativen Container für diese Funktion ebenfalls wahr, wenn toType QVariantHash oder QVariantMap ist.

Siehe auch convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, und Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE().

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

Gibt true zurück, wenn QMetaType::view eine veränderbare Sicht des Typs toType auf den Typ fromType erstellen kann.

Die Konvertierung zwischen Zeigern von Typen, die von QObject abgeleitet sind, gibt für diese Funktion true zurück, wenn eine qobject_cast von dem durch fromType beschriebenen Typ zu dem durch toType beschriebenen Typ erfolgreich wäre.

Sie können eine veränderbare Ansicht des Typs QSequentialIterable auf jedem mit Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE() registrierten Container erstellen.

In ähnlicher Weise können Sie eine veränderbare Ansicht des Typs QAssociativeIterable auf einem beliebigen, mit Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE() registrierten Container erstellen.

Siehe auch convert(), QSequentialIterable, Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE(), QAssociativeIterable, und Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE().

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

Vergleicht die Objekte unter lhs und rhs auf ihre Reihenfolge.

Gibt QPartialOrdering::Unordered zurück, wenn der Vergleich nicht unterstützt wird oder die Werte nicht geordnet sind. Gibt andernfalls QPartialOrdering::Less, QPartialOrdering::Equivalent oder QPartialOrdering::Greater zurück, wenn lhs kleiner als, gleich oder größer als rhs ist.

Beide Objekte müssen von dem durch diesen Metatyp beschriebenen Typ sein. Wenn entweder lhs oder rhs nullptr ist, sind die Werte nicht geordnet. Der Vergleich wird nur unterstützt, wenn der Kleiner-als-Operator des Typs für die Metatyp-Deklaration sichtbar war.

Wenn der Gleichheitsoperator des Typs ebenfalls sichtbar war, werden die Werte nur dann gleich verglichen, wenn der Gleichheitsoperator dies besagt. Wenn kein Gleichheitsoperator vorhanden ist, werden die Werte als gleich angesehen, wenn keiner der beiden Werte kleiner als der andere ist. Wenn auch Gleichheit vorhanden ist und zwei solche Werte nicht gleich sind, werden sie als ungeordnet angesehen, so wie NaN (not a number) Werte eines Fließkommatyps außerhalb seiner Ordnung liegen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch equals() und isOrdered().

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

Konstruiert einen Wert des Typs, für den diese QMetaType Instanz konstruiert wurde, in dem durch where adressierten Speicher, der eine Kopie von copy ist, und gibt where zurück. Wenn copy Null ist, wird der Wert standardmäßig konstruiert.

Dies ist eine Low-Level-Funktion zur expliziten Verwaltung des zur Speicherung des Typs verwendeten Speichers. Ziehen Sie in Erwägung, create() aufzurufen, wenn Sie diese Ebene der Kontrolle nicht benötigen (d.h. verwenden Sie "new" statt "placement new").

Sie müssen sicherstellen, dass where auf eine Stelle zeigt, an der der neue Wert gespeichert werden kann, und dass where entsprechend ausgerichtet ist. Die Größe des Typs kann durch Aufruf von sizeOf() abgefragt werden.

Als Faustregel für die Ausrichtung gilt, dass ein Typ an seiner natürlichen Grenze ausgerichtet wird, d. h. an der kleinsten Potenz von 2, die größer als der Typ ist, es sei denn, diese Ausrichtung ist größer als die maximal sinnvolle Ausrichtung für die Plattform. In der Praxis ist eine Ausrichtung, die größer als 2 * sizeof(void*) ist, nur für spezielle Hardwareanweisungen erforderlich (z. B. ausgerichtete SSE-Lade- und Speicheroperationen auf x86).

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

Konvertiert das Objekt unter from von fromType in den vorab zugewiesenen Speicherplatz unter to mit der Typisierung toType. Gibt true zurück, wenn die Konvertierung erfolgreich war, andernfalls false.

Sowohl from als auch to müssen gültige Zeiger sein.

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

Gibt eine Kopie von copy zurück, vorausgesetzt, sie ist von dem Typ, für den diese QMetaType Instanz erstellt wurde. Wenn copy nullptr ist, wird eine standardmäßig konstruierte Instanz erstellt.

Siehe auch QMetaType::destroy().

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

Streamt das Objekt unter rhs in den Debug-Stream dbg. Gibt bei Erfolg true zurück, andernfalls false.

void QMetaType::destroy(void *data) const

Zerstört die data, vorausgesetzt, sie ist von dem Typ, für den diese QMetaType Instanz erstellt wurde.

Siehe auch QMetaType::create().

void QMetaType::destruct(void *data) const

Zerstört den Wert, der sich unter data befindet, unter der Annahme, dass er von dem Typ ist, für den diese QMetaType Instanz konstruiert wurde.

Im Gegensatz zu destroy() ruft diese Funktion nur den Destruktor des Typs auf, sie ruft nicht den Löschoperator auf.

Siehe auch QMetaType::construct().

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

Vergleicht die Objekte auf lhs und rhs auf Gleichheit.

Beide Objekte müssen von dem durch diesen Metatyp beschriebenen Typ sein. Kann die beiden Objekte nur vergleichen, wenn ein Kleiner-als- oder Gleichheitsoperator für den Typ in der Metatyp-Deklaration sichtbar war. Andernfalls betrachtet der Metatyp die Werte nie als gleich. Wenn ein Gleichheitsoperator für die Metatyp-Deklaration sichtbar war, ist er maßgebend; andernfalls, wenn less than sichtbar ist, werden die beiden Werte als gleich betrachtet, wenn keiner der beiden Werte kleiner als der andere ist. Wenn die Werte nicht geordnet sind (siehe compare() für Details), sind sie nicht gleich.

Gibt true zurück, wenn die beiden Objekte gleich sind, sonst false.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch isEqualityComparable() und compare().

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

Gibt Flags des Typs zurück, für den diese QMetaType Instanz erstellt wurde. Um bestimmte Typeneigenschaften zu untersuchen, verwenden Sie lieber eine der "is-" Funktionen als die Flags direkt.

Siehe auch QMetaType::TypeFlags, QMetaType::flags(), isDefaultConstructible(), isCopyConstructible(), isMoveConstructible(), isDestructible(), isEqualityComparable(), und isOrdered().

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

Gibt ein QMetaType zurück, das typeName entspricht. Das zurückgegebene Objekt ist nicht gültig, wenn der typeName nicht bekannt ist für QMetaType

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

Gibt die QMetaType zurück, die dem Typ im Template-Parameter entspricht.

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

Gibt true zurück, wenn das Metatypsystem eine registrierte Konvertierung von meta type id fromType in toType

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

Gibt true zurück, wenn das Meta-Typ-System eine registrierte Konvertierung von Typ From nach Typ To hat.

Dies ist eine überladene Funktion.

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

Gibt true zurück, wenn das Metatypsystem Datenstromoperatoren für diesen Metatyp registriert hat.

Diese Funktion wurde in Qt 6.1 eingeführt.

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

Gibt true zurück, wenn das Metatyp-System einen registrierten Debug-Stream-Operator für diesen Metatyp hat.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Gibt true zurück, wenn das Metatyp-System eine registrierte veränderbare Ansicht auf die Metatyp-ID fromType der Metatyp-ID toType hat.

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

Gibt true zurück, wenn das Meta-Typ-System eine registrierte veränderbare Sicht auf den Typ From vom Typ To hat.

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

int QMetaType::id() const

Gibt den id-Typ zurück, der in dieser QMetatype-Instanz enthalten ist.

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

Gibt true zurück, wenn dieser Typ als Kopie konstruiert werden kann. Wenn dies der Fall ist, können construct() und create() mit einem copy Parameter, der nicht null ist, verwendet werden.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch flags(), isDefaultConstructible(), isMoveConstructible(), und isDestructible().

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

Gibt true zurück, wenn dieser Typ standardmäßig konstruiert werden kann. Wenn dies der Fall ist, können construct() und create() mit einem Parameter copy verwendet werden, der null ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch flags(), isCopyConstructible(), isMoveConstructible(), und isDestructible().

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

Gibt true zurück, wenn dieser Typ zerstört werden kann. Wenn dies der Fall ist, können destroy() und destruct() aufgerufen werden.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch flags(), isDefaultConstructible(), isCopyConstructible(), und isMoveConstructible().

bool QMetaType::isEqualityComparable() const

Gibt true zurück, wenn ein Kleiner-als- oder Gleichheitsoperator für den durch diesen Metatyp beschriebenen Typ für die Metatyp-Deklaration sichtbar war, andernfalls false.

Siehe auch equals() und isOrdered().

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

Gibt true zurück, wenn dieser Typ bewegt werden kann. QMetaType hat derzeit keine API, um diese Eigenschaft zu nutzen.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch flags(), isDefaultConstructible(), isCopyConstructible(), und isDestructible().

bool QMetaType::isOrdered() const

Gibt true zurück, wenn ein Kleiner-als-Operator für den durch diesen Metatyp beschriebenen Typ für die Metatyp-Deklaration sichtbar war, andernfalls false.

Siehe auch compare() und isEqualityComparable().

bool QMetaType::isRegistered() const

Gibt true zurück, wenn dieses QMetaType Objekt bei der globalen Qt-Metatyp-Registrierung registriert wurde. Die Registrierung ermöglicht es, den Typ über seinen Namen (mit QMetaType::fromName()) oder über seine ID (mit dem Konstruktor) zu finden.

Siehe auch qRegisterMetaType() und isValid().

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

Gibt true zurück, wenn der Datentyp mit der ID type registriert ist; andernfalls wird false zurückgegeben.

Siehe auch type(), typeName(), und Type.

bool QMetaType::isValid() const

Gibt true zurück, wenn dieses QMetaType Objekt gültige Informationen über einen Typ enthält, andernfalls false.

Siehe auch isRegistered().

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

Liest das Objekt dieses Typs aus dem angegebenen stream in data. Gibt true zurück, wenn das Objekt erfolgreich geladen wurde; andernfalls wird false zurückgegeben.

Normalerweise sollten Sie diese Funktion nicht direkt aufrufen müssen. Verwenden Sie stattdessen QVariant's operator>>(), die sich auf load() stützt, um benutzerdefinierte Typen zu streamen.

Siehe auch save().

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

Gibt eine QMetaObject relativ zu diesem Typ zurück.

Wenn der Typ ein Zeigertyp auf eine Unterklasse von QObject ist, enthält flags() QMetaType::PointerToQObject und diese Funktion gibt die entsprechende QMetaObject zurück. Dies kann in Kombination mit QMetaObject::newInstance() verwendet werden, um QObjects dieses Typs zu erstellen.

Wenn der Typ ein Q_GADGET ist, enthält flags() QMetaType::IsGadget. Wenn der Typ ein Zeiger auf ein Q_GADGET ist, enthält flags() QMetaType::PointerToGadget. In beiden Fällen gibt diese Funktion ihre QMetaObject zurück. Dies kann verwendet werden, um QMetaMethod und QMetaProperty abzurufen und sie auf einen Zeiger dieses Typs anzuwenden, wie es z. B. durch QVariant::data() geschieht.

Wenn der Typ eine Aufzählung ist, enthält flags() QMetaType::IsEnumeration. In diesem Fall gibt diese Funktion die QMetaObject des umschließenden Objekts zurück, wenn die Aufzählung als Q_ENUM registriert wurde, ansonsten nullptr.

Siehe auch QMetaType::flags().

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

Gibt den Typnamen zurück, der mit diesem QMetaType verbunden ist, oder einen Null-Zeiger, wenn kein passender Typ gefunden wurde. Der zurückgegebene Zeiger darf nicht gelöscht werden.

Siehe auch typeName().

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

Registriert die Möglichkeit einer impliziten Konvertierung von Typ From zu Typ To im Meta-Typ-System. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls 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)

Dies ist eine überladene Funktion.

Registriert eine Methode function wie To From::function() const als Konverter vom Typ From zum Typ To im Metatypsystem. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls 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)

Dies ist eine überladene Funktion.

Registriert eine Methode function wie To From::function(bool *ok) const als Konverter vom Typ From zum Typ To im Metatypsystem. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls false.

Der Zeiger ok kann von der Funktion verwendet werden, um anzuzeigen, ob die Konvertierung erfolgreich war.

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)

Dies ist eine überladene Funktion.

Registriert ein unäres Funktionsobjekt function als Konverter vom Typ From zum Typ To im Metatypsystem. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls false.

function muss eine Instanz vom Typ From annehmen und eine Instanz von To zurückgeben. Es kann ein Funktionszeiger, ein Lambda oder ein Funktorobjekt sein. Seit Qt 6.5 kann function auch eine Instanz von std::optional<To> zurückgeben, um fehlgeschlagene Konvertierungen anzeigen zu können.

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)

Dies ist eine überladene Funktion.

Registriert eine Methode function wie To From::function() als veränderbare Sicht des Typs To auf den Typ From im Metatypsystem. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls false.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Dies ist eine überladene Funktion.

Registriert ein unäres Funktionsobjekt function als veränderbare Sicht vom Typ To auf den Typ From im Meta-Typ-System. Gibt true zurück, wenn die Registrierung erfolgreich war, andernfalls false.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Registriert diese QMetaType in der Typregistrierung, so dass sie über den Namen gefunden werden kann, indem QMetaType::fromName() verwendet wird.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch qRegisterMetaType().

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

Schreibt das Objekt, auf das data verweist, in das angegebene stream. Gibt true zurück, wenn das Objekt erfolgreich gespeichert wurde; andernfalls wird false zurückgegeben.

Normalerweise sollten Sie diese Funktion nicht direkt aufrufen müssen. Verwenden Sie stattdessen QVariant's operator<<(), die sich auf save() stützt, um benutzerdefinierte Typen zu streamen.

Siehe auch load().

[constexpr] qsizetype QMetaType::sizeOf() const

Gibt die Größe des Typs in Bytes zurück (d.h. sizeof(T), wobei T der tatsächliche Typ ist, für den diese QMetaType Instanz erstellt wurde).

Diese Funktion wird typischerweise zusammen mit construct() verwendet, um die Verwaltung des von einem Typ verwendeten Speichers auf niedriger Ebene durchzuführen.

Siehe auch QMetaType::construct(), QMetaType::sizeOf(), und QMetaType::alignOf().

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

Wenn dieser Metatyp eine Aufzählung darstellt, gibt diese Methode einen Metatyp einer numerischen Klasse mit demselben Vorzeichen und derselben Größe wie der zugrunde liegende Typ der Aufzählung zurück. Wenn es sich um einen QFlags Typ handelt, wird QMetaType::Int zurückgegeben. In allen anderen Fällen wird ein ungültiger QMetaType zurückgegeben.

Diese Funktion wurde in Qt 6.6 eingeführt.

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

Erzeugt eine veränderbare Sicht auf das Objekt unter from von fromType in dem zuvor zugewiesenen Speicherplatz unter to mit dem Typ toType. Gibt true zurück, wenn die Konvertierung erfolgreich war, andernfalls false.

Diese Funktion wurde in Qt 6.0 eingeführt.