QVariant Class

Dokumentation der Mitgliedsfunktionen

Gibt den Speichertyp des in der Variante gespeicherten Wertes zurück. Dies ist dasselbe wie metaType().id().

Siehe auch metaType().

Gibt einen Zeiger auf das enthaltene Objekt als generisches void* zurück, in das nicht geschrieben werden kann.

Siehe auch get_if() und QMetaType.

[noexcept] QVariant::QVariant()

Konstruiert eine ungültige Variante.

[noexcept] QVariant::QVariant(QChar c)

Konstruiert eine neue Variante mit einem char-Wert, c.

QVariant::QVariant(const char *val)

Konstruiert eine neue Variante mit einem String-Wert von val. Die Variante erstellt eine tiefe Kopie von val in eine QString unter der Annahme einer UTF-8-Kodierung der Eingabe val.

Beachten Sie, dass val zum Speichern in der Variante in QString konvertiert wird und QVariant::userType() QMetaType::QString für die Variante zurückgibt.

Sie können diesen Operator deaktivieren, indem Sie QT_NO_CAST_FROM_ASCII definieren, wenn Sie Ihre Anwendungen kompilieren.

[noexcept] QVariant::QVariant(double val)

Konstruiert eine neue Variante mit einem Fließkommawert, val.

[noexcept] QVariant::QVariant(float val)

Konstruiert eine neue Variante mit einem Fließkommawert, val.

[noexcept] QVariant::QVariant(int val)

Konstruiert eine neue Variante mit einem ganzzahligen Wert, val.

[noexcept] QVariant::QVariant(qlonglong val)

Konstruiert eine neue Variante mit einem Long-Long-Integer-Wert, val.

[noexcept] QVariant::QVariant(qulonglong val)

Konstruiert eine neue Variante mit einem vorzeichenlosen Long-Long-Integer-Wert, val.

[noexcept] QVariant::QVariant(uint val)

Konstruiert eine neue Variante mit einem ganzzahligen Wert ohne Vorzeichen, val.

[explicit] QVariant::QVariant(QMetaType type, const void *copy = nullptr)

Konstruiert eine Variante des Typs type und initialisiert sie mit einer Kopie von *copy, wenn copy nicht nullptr ist (in diesem Fall muss copy auf ein Objekt des Typs type zeigen).

Beachten Sie, dass Sie die Adresse des Objekts, das Sie speichern möchten, übergeben müssen.

Normalerweise brauchen Sie diesen Konstruktor nie zu verwenden. Verwenden Sie stattdessen QVariant::fromValue(), um Varianten aus den durch QMetaType::VoidStar und QMetaType::QObjectStar repräsentierten Zeigertypen zu konstruieren.

Wenn type die Konstruktion von Kopien nicht unterstützt und copy nicht nullptr ist, wird die Variante ungültig sein. Ähnlich ist die Variante ungültig, wenn copy nullptr ist und type die Standardkonstruktion nicht unterstützt.

Siehe auch QVariant::fromMetaType, QVariant::fromValue(), und QMetaType::Type.

[explicit noexcept(...), since 6.6] template <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, Args &&... args)

Konstruiert eine neue Variante, die einen Wert vom Typ T enthält. Der enthaltene Wert wird mit den Argumenten std::forward<Args>(args)... initialisiert.

Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn T aus args konstruiert werden kann.

Dieser Konstruktor wird aus Gründen der STL/std::any-Kompatibilität bereitgestellt.

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.6 eingeführt.

[explicit noexcept(...), since 6.6] template <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args &&... args)

Dies ist eine überladene Funktion.

Diese Überladung existiert, um Typen zu unterstützen, deren Konstruktoren ein initializer_list annehmen. Sie verhält sich ansonsten äquivalent zur Überladung der nicht-initialisierten Liste in_place_type_t.

Diese Funktion wurde in Qt 6.6 eingeführt.

[noexcept] QVariant::QVariant(QDate val)

Konstruiert eine neue Variante mit einem Datumswert, val.

QVariant::QVariant(QLatin1StringView val)

Konstruiert eine neue Variante mit einem QString Wert aus der Latin-1 Zeichenkette, die von val angezeigt wird.

[noexcept(...)] QVariant::QVariant(QLine val)

Konstruiert eine neue Variante mit einem Zeilenwert von val.

[noexcept(...)] QVariant::QVariant(QLineF val)

Konstruiert eine neue Variante mit einem Zeilenwert von val.

[noexcept] QVariant::QVariant(QPoint val)

Konstruiert eine neue Variante mit einem Punktwert von val.

[noexcept(...)] QVariant::QVariant(QPointF val)

Konstruiert eine neue Variante mit einem Punktwert von val.

[noexcept(...)] QVariant::QVariant(QRect val)

Konstruiert eine neue Variante mit einem rect-Wert von val.

[noexcept(...)] QVariant::QVariant(QRectF val)

Konstruiert eine neue Variante mit einem rect-Wert von val.

[noexcept] QVariant::QVariant(QSize val)

Konstruiert eine neue Variante mit einem Größenwert von val.

[noexcept(...)] QVariant::QVariant(QSizeF val)

Konstruiert eine neue Variante mit einem Größenwert von val.

[noexcept] QVariant::QVariant(QTime val)

Konstruiert eine neue Variante mit einem Zeitwert, val.

[noexcept(...)] QVariant::QVariant(QUuid val)

Konstruiert eine neue Variante mit einem uuid-Wert, val.

[noexcept] QVariant::QVariant(bool val)

Konstruiert eine neue Variante mit einem booleschen Wert, val.

[noexcept] QVariant::QVariant(const QBitArray &val)

Konstruiert eine neue Variante mit einem Bitarray-Wert, val.

[noexcept] QVariant::QVariant(const QByteArray &val)

Konstruiert eine neue Variante mit einem Bytearray-Wert, val.

[noexcept] QVariant::QVariant(const QDateTime &val)

Konstruiert eine neue Variante mit einem Datums-/Zeitwert, val.

QVariant::QVariant(const QEasingCurve &val)

Konstruiert eine neue Variante mit einem Entspannungskurvenwert, val.

[noexcept] QVariant::QVariant(const QHash<QString, QVariant> &val)

Konstruiert eine neue Variante mit einem Hash von QVariants, val.

[noexcept] QVariant::QVariant(const QJsonArray &val)

Konstruiert eine neue Variante mit einem json-Array-Wert, val.

QVariant::QVariant(const QJsonDocument &val)

Konstruiert eine neue Variante mit einem json-Dokumentwert, val.

[noexcept] QVariant::QVariant(const QJsonObject &val)

Konstruiert eine neue Variante mit einem json-Objektwert, val.

[noexcept(...)] QVariant::QVariant(const QJsonValue &val)

Konstruiert eine neue Variante mit einem json-Wert, val.

[noexcept] QVariant::QVariant(const QList<QVariant> &val)

Konstruiert eine neue Variante mit einem Listenwert, val.

[noexcept] QVariant::QVariant(const QLocale &l)

Konstruiert eine neue Variante mit einem Locale-Wert, l.

[noexcept] QVariant::QVariant(const QMap<QString, QVariant> &val)

Konstruiert eine neue Variante mit einer Karte von QVariants, val.

[noexcept(...)] QVariant::QVariant(const QModelIndex &val)

Konstruiert eine neue Variante mit einem QModelIndex Wert, val.

QVariant::QVariant(const QPersistentModelIndex &val)

Konstruiert eine neue Variante mit einem QPersistentModelIndex Wert, val.

[noexcept] QVariant::QVariant(const QRegularExpression &re)

Konstruiert eine neue Variante mit dem Wert des regulären Ausdrucks re.

[noexcept] QVariant::QVariant(const QString &val)

Konstruiert eine neue Variante mit einem String-Wert, val.

[noexcept] QVariant::QVariant(const QStringList &val)

Konstruiert eine neue Variante mit einem String-Listenwert, val.

[noexcept] QVariant::QVariant(const QUrl &val)

Konstruiert eine neue Variante mit einem Url-Wert von val.

QVariant::QVariant(const QVariant &p)

Konstruiert eine Kopie der Variante p, die als Argument an diesen Konstruktor übergeben wird.

[noexcept] QVariant::QVariant(QVariant &&other)

Move-konstruiert eine QVariant-Instanz, die auf das gleiche Objekt zeigt, auf das other gezeigt hat.

[noexcept] QVariant::~QVariant()

Zerstört die QVariant und das darin enthaltene Objekt.

template <typename T> bool QVariant::canConvert() const

Gibt true zurück, wenn die Variante in den Vorlagentyp T konvertiert werden kann, andernfalls false.

Beispiel:

QVariant v = 42;

v.canConvert<int>();              // returns true
v.canConvert<QString>();          // returns true

MyCustomStruct s;
v.setValue(s);

v.canConvert<int>();              // returns false
v.canConvert<MyCustomStruct>();   // returns true

Ein QVariant, das einen Zeiger auf einen von QObject abgeleiteten Typ enthält, gibt für diese Funktion ebenfalls true zurück, wenn ein qobject_cast auf den Vorlagentyp T erfolgreich wäre. Beachten Sie, dass dies nur für QObject Unterklassen funktioniert, die das Makro Q_OBJECT verwenden.

Siehe auch convert().

[since 6.0] bool QVariant::canConvert(QMetaType type) const

Gibt true zurück, wenn der Typ der Variante in den angeforderten Typ, type, umgewandelt werden kann. Ein solches Casting wird automatisch beim Aufruf der Methoden toInt(), toBool(), ... durchgeführt.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch QMetaType::canConvert().

template <typename T> bool QVariant::canView() const

Gibt true zurück, wenn eine veränderbare Ansicht des Vorlagentyps T auf dieser Variante erstellt werden kann, andernfalls false.

Siehe auch value().

void QVariant::clear()

Konvertieren Sie diese Variante in den Typ QMetaType::UnknownType und geben Sie alle verwendeten Ressourcen frei.

[static, since 6.0] QPartialOrdering QVariant::compare(const QVariant &lhs, const QVariant &rhs)

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, gleich oder größer als rhs ist.

Wenn die Varianten Daten mit einem anderen Metatyp enthalten, werden die Werte als ungeordnet betrachtet, es sei denn, sie sind beide vom Typ numerisch oder Zeiger, wobei die regulären numerischen oder Zeiger-Vergleichsregeln verwendet werden.

Wenn beide Varianten Daten desselben Metatyps enthalten, verwendet die Methode die QMetaType::compare Methode, um die Reihenfolge der beiden Varianten zu bestimmen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch QMetaType::compare() und QMetaType::isOrdered().

[since 6.0] bool QVariant::convert(QMetaType targetType)

Überführt die Variante in den angeforderten Typ, targetType. Wenn der Cast nicht durchgeführt werden kann, wird die Variante trotzdem in den angeforderten Typ geändert, aber in einem gelöschten Null-Zustand belassen, ähnlich dem von QVariant(Typ) konstruierten.

Gibt true zurück, wenn der aktuelle Typ der Variante erfolgreich gecastet wurde; andernfalls wird false zurückgegeben.

Ein QVariant, das einen Zeiger auf einen von QObject abgeleiteten Typ enthält, wird ebenfalls konvertiert und gibt für diese Funktion true zurück, wenn ein qobject_cast auf den durch targetType beschriebenen Typ erfolgreich wäre. Beachten Sie, dass dies nur für QObject Unterklassen funktioniert, die das Makro Q_OBJECT verwenden.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch canConvert() und clear().

void *QVariant::data()

Gibt einen Zeiger auf das enthaltene Objekt als generisches void* zurück, in das geschrieben werden kann.

Diese Funktion trennt die QVariant. Wenn sie auf einer null-QVariant aufgerufen wird, ist die QVariant nach dem Aufruf nicht null.

Siehe auch get_if() und QMetaType.

[since 6.6] template <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> T &QVariant::emplace(Args &&... args)

Ersetzt das derzeit in *this gehaltene Objekt durch ein Objekt des Typs T, das aus args... konstruiert wurde. Wenn *this nicht leer war, wird das zuvor gehaltene Objekt zuerst zerstört. Wenn möglich, verwendet diese Methode den von QVariant zugewiesenen Speicher wieder. Gibt eine Referenz auf das neu erstellte Objekt zurück.

Diese Funktion wurde in Qt 6.6 eingeführt.

[since 6.6] template <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> T &QVariant::emplace(std::initializer_list<U> list, Args &&... args)

Dies ist eine überladene Funktion.

Diese Überladung existiert, um Typen zu unterstützen, deren Konstruktoren ein initializer_list annehmen. Sie verhält sich ansonsten äquivalent zu der Überladung für nicht-initialisierte Listen.

Diese Funktion wurde in Qt 6.6 eingeführt.

[static, since 6.7] QVariant QVariant::fromMetaType(QMetaType type, const void *copy = nullptr)

Erzeugt eine Variante des Typs type und initialisiert sie mit einer Kopie von *copy, falls copy nicht nullptr ist (in diesem Fall muss copy auf ein Objekt des Typs type zeigen).

Beachten Sie, dass Sie die Adresse des Objekts, das Sie speichern möchten, übergeben müssen.

Normalerweise brauchen Sie diesen Konstruktor nie zu verwenden. Verwenden Sie stattdessen QVariant::fromValue(), um Varianten aus den durch QMetaType::VoidStar und QMetaType::QObjectStar repräsentierten Zeigertypen zu konstruieren.

Wenn type die Konstruktion von Kopien nicht unterstützt und copy nicht nullptr ist, wird die Variante ungültig sein. Ähnlich ist die Variante ungültig, wenn copy nullptr ist und type die Standardkonstruktion nicht unterstützt.

Gibt die QVariant zurück, die wie oben beschrieben erstellt wurde.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QVariant::fromValue() und QMetaType::Type.

[static] template <typename... Types> QVariant QVariant::fromStdVariant(const std::variant<Types...> &value)

Gibt eine QVariant mit dem Typ und dem Wert der aktiven Variante von value zurück. Wenn der aktive Typ std::monostate ist, wird ein Standardwert QVariant zurückgegeben.

Siehe auch fromValue().

[static, since 6.6] template <typename... Types> QVariant QVariant::fromStdVariant(std::variant<Types...> &&value)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.6 eingeführt.

[static] template <typename T> QVariant QVariant::fromValue(const T &value)

Gibt ein QVariant zurück, das eine Kopie von value enthält. Verhält sich ansonsten genau wie setValue().

Beispiel:

MyCustomStruct s;
return QVariant::fromValue(s);

Siehe auch setValue() und value().

[static, since 6.6] template <typename T, QVariant::if_rvalue<T> = true> QVariant QVariant::fromValue(T &&value)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.6 eingeführt.

bool QVariant::isNull() const

Gibt true zurück, wenn dies eine Null-Variante ist, andernfalls false.

Eine Variante wird als null betrachtet, wenn sie keinen initialisierten Wert oder einen Null-Zeiger enthält.

Siehe auch convert().

bool QVariant::isValid() const

Gibt true zurück, wenn der Speichertyp dieser Variante nicht QMetaType::UnknownType ist; andernfalls wird false zurückgegeben.

[since 6.0] QMetaType QVariant::metaType() const

Gibt die QMetaType des in der Variante gespeicherten Wertes zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

void QVariant::setValue(QVariant &&value)

Verschiebt value über dieses QVariant. Es ist gleichbedeutend mit einer einfachen Verschiebung der Zuweisung von value zu diesem QVariant.

Siehe auch value().

template <typename T, typename = std::enable_if_t<!std::is_same_v<std::decay_t<T>, QVariant>>> void QVariant::setValue(T &&value)

Speichert eine Kopie von value. Wenn T ein Typ ist, den QVariant nicht unterstützt, wird QMetaType verwendet, um den Wert zu speichern. Ein Kompilierfehler tritt auf, wenn QMetaType den Typ nicht verarbeitet.

Beispiel:

QVariant v;

v.setValue(5);
int i = v.toInt();         // i is now 5
QString s = v.toString();  // s is now "5"

MyCustomStruct c;
v.setValue(c);

...

MyCustomStruct c2 = v.value<MyCustomStruct>();

Siehe auch value(), fromValue(), und canConvert().

void QVariant::setValue(const QVariant &value)

Kopiert value über dieses QVariant. Dies ist gleichbedeutend mit der einfachen Zuweisung von value an QVariant.

[noexcept] void QVariant::swap(QVariant &other)

Tauscht diese Variante mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QBitArray QVariant::toBitArray() const

Gibt die Variante als QBitArray zurück, wenn die Variante userType() QMetaType::QBitArray hat; andernfalls wird ein leeres Bit-Array zurückgegeben.

Siehe auch canConvert() und convert().

bool QVariant::toBool() const

Gibt die Variante als bool zurück, wenn die Variante userType() Bool hat.

Gibt true zurück, wenn die Variante userType() QMetaType::Bool, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::UInt oder QMetaType::ULongLong hat und der Wert ungleich Null ist, oder wenn die Variante den Typ QMetaType::QString oder QMetaType::QByteArray hat und ihr klein geschriebener Inhalt nicht einer der folgenden ist: leer, "0" oder "false"; andernfalls wird false zurückgegeben.

Siehe auch canConvert() und convert().

QByteArray QVariant::toByteArray() const

Gibt die Variante als QByteArray zurück, wenn die Variante userType() QMetaType::QByteArray oder QMetaType::QString (umgewandelt mit QString::fromUtf8()) hat; andernfalls wird ein leeres Byte-Array zurückgegeben.

Siehe auch canConvert() und convert().

QChar QVariant::toChar() const

Gibt die Variante als QChar zurück, wenn die Variante userType() QMetaType::QChar, QMetaType::Int oder QMetaType::UInt hat; andernfalls wird ein ungültiger QChar zurückgegeben.

Siehe auch canConvert() und convert().

QDate QVariant::toDate() const

Gibt die Variante als QDate zurück, wenn die Variante userType() QMetaType::QDate, QMetaType::QDateTime, oder QMetaType::QString hat; andernfalls wird ein ungültiges Datum zurückgegeben.

Wenn type() QMetaType::QString ist, wird ein ungültiges Datum zurückgegeben, wenn die Zeichenkette nicht als Datum im Format Qt::ISODate geparst werden kann.

Siehe auch canConvert() und convert().

QDateTime QVariant::toDateTime() const

Gibt die Variante als QDateTime zurück, wenn die Variante userType() QMetaType::QDateTime, QMetaType::QDate oder QMetaType::QString hat; andernfalls wird ein ungültiges Datum/Uhrzeit zurückgegeben.

Wenn type() QMetaType::QString ist, wird ein ungültiges Datum/Uhrzeit zurückgegeben, wenn die Zeichenkette nicht als Datum/Uhrzeit im Format Qt::ISODate geparst werden kann.

Siehe auch canConvert() und convert().

double QVariant::toDouble(bool *ok = nullptr) const

Gibt die Variante als Double zurück, wenn die Variante userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, oder QMetaType::ULongLong hat; andernfalls wird 0.0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen double umgewandelt werden konnte; andernfalls *ok wird auf false gesetzt.

Siehe auch canConvert() und convert().

QEasingCurve QVariant::toEasingCurve() const

Gibt die Variante als QEasingCurve zurück, wenn die Variante userType() QMetaType::QEasingCurve hat; andernfalls wird eine Standard-Entspannungskurve zurückgegeben.

Siehe auch canConvert() und convert().

float QVariant::toFloat(bool *ok = nullptr) const

Gibt die Variante als Float zurück, wenn die Variante userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt oder QMetaType::ULongLong hat; andernfalls wird 0.0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in ein Double umgewandelt werden konnte; andernfalls wird *ok auf false gesetzt.

Siehe auch canConvert() und convert().

QHash<QString, QVariant> QVariant::toHash() const

Gibt die Variante als QHash<QString, QVariant> zurück, wenn die Variante den Typ() QMetaType::QVariantHash hat; andernfalls wird eine leere Map zurückgegeben.

Siehe auch canConvert() und convert().

int QVariant::toInt(bool *ok = nullptr) const

Gibt die Variante als int zurück, wenn die Variante userType() QMetaType::Int, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, oder QMetaType::ULongLong hat; andernfalls wird 0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen int konvertiert werden konnte; andernfalls wird *ok auf false gesetzt.

Warnung: Wenn der Wert in QMetaType::LongLong umgewandelt werden kann, aber zu groß ist, um in einem int dargestellt zu werden, wird der daraus resultierende arithmetische Überlauf nicht in ok wiedergegeben. Eine einfache Abhilfe ist die Verwendung von QString::toInt().

Siehe auch canConvert() und convert().

QJsonArray QVariant::toJsonArray() const

Gibt die Variante als QJsonArray zurück, wenn die Variante userType() QJsonArray hat; andernfalls wird eine standardmäßig konstruierte QJsonArray zurückgegeben.

Siehe auch canConvert() und convert().

QJsonDocument QVariant::toJsonDocument() const

Gibt die Variante als QJsonDocument zurück, wenn die Variante userType() QJsonDocument hat; andernfalls wird eine standardmäßig konstruierte QJsonDocument zurückgegeben.

Siehe auch canConvert() und convert().

QJsonObject QVariant::toJsonObject() const

Gibt die Variante als QJsonObject zurück, wenn die Variante userType() QJsonObject hat; andernfalls wird eine standardmäßig konstruierte QJsonObject zurückgegeben.

Siehe auch canConvert() und convert().

QJsonValue QVariant::toJsonValue() const

Gibt die Variante als QJsonValue zurück, wenn die Variante userType() QJsonValue hat; andernfalls wird eine standardmäßig konstruierte QJsonValue zurückgegeben.

Siehe auch canConvert() und convert().

QLine QVariant::toLine() const

Gibt die Variante als QLine zurück, wenn die Variante userType() QMetaType::QLine hat; andernfalls wird ein ungültiger QLine zurückgegeben.

Siehe auch canConvert() und convert().

QLineF QVariant::toLineF() const

Gibt die Variante als QLineF zurück, wenn die Variante userType() QMetaType::QLineF hat; andernfalls wird ein ungültiger QLineF zurückgegeben.

Siehe auch canConvert() und convert().

QList<QVariant> QVariant::toList() const

Gibt die Variante als QVariantList zurück, wenn die Variante userType() QMetaType::QVariantList hat. Ist dies nicht der Fall, versucht QVariant, den Typ in eine Liste zu konvertieren und gibt ihn dann zurück. Dies gelingt für jeden Typ, der einen Konverter für QVariantList registriert hat oder der mit Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE als sequentieller Container deklariert wurde. Wenn keine dieser Bedingungen erfüllt ist, gibt diese Funktion eine leere Liste zurück.

Siehe auch canConvert() und convert().

QLocale QVariant::toLocale() const

Gibt die Variante als QLocale zurück, wenn die Variante userType() QMetaType::QLocale hat; andernfalls wird ein ungültiger QLocale zurückgegeben.

Siehe auch canConvert() und convert().

qlonglong QVariant::toLongLong(bool *ok = nullptr) const

Gibt die Variante als long long int zurück, wenn die Variante userType() QMetaType::LongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::QString, QMetaType::UInt, oder QMetaType::ULongLong hat; andernfalls wird 0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen int umgewandelt werden konnte; andernfalls wird *ok auf false gesetzt.

Siehe auch canConvert() und convert().

QMap<QString, QVariant> QVariant::toMap() const

Gibt die Variante als QVariantMap zurück, wenn die Variante type() QMetaType::QVariantMap hat. Ist dies nicht der Fall, versucht QVariant, den Typ in eine Map zu konvertieren und gibt ihn dann zurück. Dies gelingt für jeden Typ, der einen Konverter für QVariantMap registriert hat oder der mit Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE als assoziativer Container deklariert wurde. Wenn keine dieser Bedingungen erfüllt ist, gibt diese Funktion eine leere Map zurück.

Siehe auch canConvert() und convert().

QModelIndex QVariant::toModelIndex() const

Gibt die Variante als QModelIndex zurück, wenn die Variante userType() QModelIndex hat; andernfalls wird eine standardmäßig konstruierte QModelIndex zurückgegeben.

Siehe auch canConvert(), convert(), und toPersistentModelIndex().

QPersistentModelIndex QVariant::toPersistentModelIndex() const

Gibt die Variante als QPersistentModelIndex zurück, wenn die Variante userType() QPersistentModelIndex hat; andernfalls wird eine standardmäßig konstruierte QPersistentModelIndex zurückgegeben.

Siehe auch canConvert(), convert(), und toModelIndex().

QPoint QVariant::toPoint() const

Gibt die Variante als QPoint zurück, wenn die Variante userType() QMetaType::QPoint oder QMetaType::QPointF hat; andernfalls wird eine Null QPoint zurückgegeben.

Siehe auch canConvert() und convert().

QPointF QVariant::toPointF() const

Gibt die Variante als QPointF zurück, wenn die Variante userType() QMetaType::QPoint oder QMetaType::QPointF hat; andernfalls wird eine Null QPointF zurückgegeben.

Siehe auch canConvert() und convert().

qreal QVariant::toReal(bool *ok = nullptr) const

Gibt die Variante als qreal zurück, wenn die Variante userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, oder QMetaType::ULongLong hat; andernfalls wird 0.0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen double konvertiert werden konnte; andernfalls wird *ok auf false gesetzt.

Siehe auch canConvert() und convert().

QRect QVariant::toRect() const

Gibt die Variante als QRect zurück, wenn die Variante userType() QMetaType::QRect hat; andernfalls wird ein ungültiger QRect zurückgegeben.

Siehe auch canConvert() und convert().

QRectF QVariant::toRectF() const

Gibt die Variante als QRectF zurück, wenn die Variante userType() QMetaType::QRect oder QMetaType::QRectF hat; andernfalls wird ein ungültiger QRectF zurückgegeben.

Siehe auch canConvert() und convert().

QRegularExpression QVariant::toRegularExpression() const

Gibt die Variante als QRegularExpression zurück, wenn die Variante userType() QRegularExpression hat; andernfalls wird ein leeres QRegularExpression zurückgegeben.

Siehe auch canConvert() und convert().

QSize QVariant::toSize() const

Gibt die Variante als QSize zurück, wenn die Variante userType() QMetaType::QSize hat; andernfalls wird ein ungültiger QSize zurückgegeben.

Siehe auch canConvert() und convert().

QSizeF QVariant::toSizeF() const

Gibt die Variante als QSizeF zurück, wenn die Variante userType() QMetaType::QSizeF hat; andernfalls wird ein ungültiger QSizeF zurückgegeben.

Siehe auch canConvert() und convert().

QString QVariant::toString() const

Gibt die Variante als QString zurück, wenn die Variante ein userType() hat, einschließlich, aber nicht beschränkt auf:

QMetaType::QString, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::QDate, QMetaType::QDateTime, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QStringList, QMetaType::QTime, QMetaType::UInt, oder QMetaType::ULongLong.

Der Aufruf von QVariant::toString() für eine nicht unterstützte Variante gibt einen leeren String zurück.

Siehe auch canConvert() und convert().

QStringList QVariant::toStringList() const

Gibt die Variante als QStringList zurück, wenn die Variante userType() QMetaType::QStringList, QMetaType::QString, oder QMetaType::QVariantList eines Typs hat, der in QString konvertiert werden kann; andernfalls wird eine leere Liste zurückgegeben.

Siehe auch canConvert() und convert().

QTime QVariant::toTime() const

Gibt die Variante als QTime zurück, wenn die Variante userType() QMetaType::QTime, QMetaType::QDateTime, oder QMetaType::QString hat; andernfalls wird eine ungültige Zeit zurückgegeben.

Wenn type() QMetaType::QString ist, wird eine ungültige Zeit zurückgegeben, wenn die Zeichenkette nicht als Zeit im Format Qt::ISODate geparst werden kann.

Siehe auch canConvert() und convert().

uint QVariant::toUInt(bool *ok = nullptr) const

Gibt die Variante als unsigned int zurück, wenn die Variante userType() QMetaType::UInt, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString oder QMetaType::ULongLong hat; andernfalls wird 0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen unsigned int konvertiert werden konnte; andernfalls *ok wird auf false gesetzt.

Warnung: Wenn der Wert in QMetaType::ULongLong umgewandelt werden kann, aber zu groß ist, um in einem vorzeichenlosen int dargestellt zu werden, wird der daraus resultierende arithmetische Überlauf nicht in ok wiedergegeben. Eine einfache Abhilfe ist die Verwendung von QString::toUInt().

Siehe auch canConvert() und convert().

qulonglong QVariant::toULongLong(bool *ok = nullptr) const

Gibt die Variante als unsigned long long int zurück, wenn die Variante den Typ() QMetaType::ULongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString oder QMetaType::UInt hat; andernfalls wird 0 zurückgegeben.

Wenn ok nicht null ist: *ok wird auf true gesetzt, wenn der Wert in einen int umgewandelt werden konnte; andernfalls wird *ok auf false gesetzt.

Siehe auch canConvert() und convert().

QUrl QVariant::toUrl() const

Gibt die Variante als QUrl zurück, wenn die Variante userType() QMetaType::QUrl hat; andernfalls wird ein ungültiger QUrl zurückgegeben.

Siehe auch canConvert() und convert().

QUuid QVariant::toUuid() const

Gibt die Variante als QUuid zurück, wenn die Variante den Typ() QMetaType::QUuid, QMetaType::QByteArray oder QMetaType::QString hat; andernfalls wird eine standardmäßig konstruierte QUuid zurückgegeben.

Siehe auch canConvert() und convert().

const char *QVariant::typeName() const

Gibt den Namen des Typs zurück, der in der Variante gespeichert ist. Die zurückgegebenen Zeichenfolgen beschreiben den C++-Datentyp, der zum Speichern der Daten verwendet wird: z. B. "QFont", "QString" oder "QVariantList". Eine ungültige Variante gibt 0 zurück.

template <typename T> T QVariant::value() const &

Gibt den gespeicherten Wert zurück, der in den Vorlagentyp T konvertiert wurde. Rufen Sie canConvert() auf, um herauszufinden, ob ein Typ konvertiert werden kann. Wenn der Wert nicht konvertiert werden kann, wird ein standardmäßig konstruierter Wert zurückgegeben.

Wenn der Typ T von QVariant unterstützt wird, verhält sich diese Funktion genau wie toString(), toInt() usw.

Beispiel:

QVariant v;

MyCustomStruct c;
if (v.canConvert<MyCustomStruct>())
    c = v.value<MyCustomStruct>();

v = 7;
int i = v.value<int>();                        // same as v.toInt()
QString s = v.value<QString>();                // same as v.toString(), s is now "7"
MyCustomStruct c2 = v.value<MyCustomStruct>(); // conversion failed, c2 is empty

Wenn QVariant einen Zeiger auf einen von QObject abgeleiteten Typ enthält, kann T ein beliebiger QObject -Typ sein. Wenn der in QVariant gespeicherte Zeiger qobject_cast auf T sein kann, dann wird dieses Ergebnis zurückgegeben. Andernfalls wird nullptr zurückgegeben. Beachten Sie, dass dies nur für QObject Unterklassen funktioniert, die das Makro Q_OBJECT verwenden.

Wenn QVariant einen sequentiellen Container enthält und T QVariantList ist, werden die Elemente des Containers in QVariantumgewandelt und als QVariantList zurückgegeben.

QList<int> intList = {7, 11, 42};QVariant variant = QVariant::fromValue(intList);if (variant.canConvert<QVariantList>()) { QSequentialIterable iterable = variant.value<QSequentialIterable>() ; // Kann foreach verwenden:foreach(const QVariant &v, iterable) {        qDebug() << v;
    } // Kann C++11 range-for verwenden: for(const QVariant &v: iterable) {        qDebug() << v;
    } // Kann Iteratoren verwenden:    QSequentialIterable::const_iterator it = iterable.begin(); const QSequentialIterable::const_iterator end = iterable.end(); for ( ; it != end;++it) {        qDebug() << *it;
    } }

Siehe auch setValue(), fromValue(), canConvert(), und Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE().

template <typename T> T QVariant::view()

Gibt eine veränderbare Ansicht des Vorlagentyps T auf den gespeicherten Wert zurück. Rufen Sie canView() auf, um herauszufinden, ob eine solche Ansicht unterstützt wird. Wenn keine solche Ansicht erstellt werden kann, wird der gespeicherte Wert in den Vorlagentyp T konvertiert. Rufen Sie canConvert() auf, um herauszufinden, ob ein Typ konvertiert werden kann. Wenn der Wert weder angezeigt noch konvertiert werden kann, wird ein standardmäßig konstruierter Wert zurückgegeben.

Siehe auch canView() und Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE().

[noexcept] QVariant &QVariant::operator=(QVariant &&other)

Verschieben - weist other dieser QVariant Instanz zu.

QVariant &QVariant::operator=(const QVariant &variant)

Weist den Wert der Variante variant dieser Variante zu.