QVersionNumber Class
Die Klasse „QVersionNumber“ enthält eine Versionsnummer mit einer beliebigen Anzahl von Segmenten. Mehr...
| Header: | #include <QVersionNumber> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Vergleiche von QVersionNumber
| Kategorie | Vergleichbare Typen |
|---|---|
| stark | QVersionNumber |
Öffentliche Typen
(since 6.8) | const_iterator |
(since 6.8) | const_pointer |
(since 6.8) | const_reference |
(since 6.8) | const_reverse_iterator |
(since 6.8) | difference_type |
(since 6.8) | pointer |
(since 6.8) | reference |
(since 6.8) | size_type |
(since 6.8) | value_type |
Öffentliche Funktionen
| QVersionNumber() | |
| QVersionNumber(QList<int> &&seg) | |
(since 6.8) | QVersionNumber(QSpan<const int> args) |
| QVersionNumber(const QList<int> &seg) | |
| QVersionNumber(int maj) | |
| QVersionNumber(std::initializer_list<int> args) | |
| QVersionNumber(int maj, int min) | |
| QVersionNumber(int maj, int min, int mic) | |
(since 6.8) QVersionNumber::const_iterator | begin() const |
(since 6.8) QVersionNumber::const_iterator | cbegin() const |
(since 6.8) QVersionNumber::const_iterator | cend() const |
(since 6.8) QVersionNumber::const_iterator | constBegin() const |
(since 6.8) QVersionNumber::const_iterator | constEnd() const |
(since 6.8) QVersionNumber::const_reverse_iterator | crbegin() const |
(since 6.8) QVersionNumber::const_reverse_iterator | crend() const |
(since 6.8) QVersionNumber::const_iterator | end() const |
| bool | isNormalized() const |
| bool | isNull() const |
| bool | isPrefixOf(const QVersionNumber &other) const |
| int | majorVersion() const |
| int | microVersion() const |
| int | minorVersion() const |
| QVersionNumber | normalized() const |
(since 6.8) QVersionNumber::const_reverse_iterator | rbegin() const |
(since 6.8) QVersionNumber::const_reverse_iterator | rend() const |
| int | segmentAt(qsizetype index) const |
| qsizetype | segmentCount() const |
| QList<int> | segments() const |
| QString | toString() const |
Statische öffentliche Mitglieder
| QVersionNumber | commonPrefix(const QVersionNumber &v1, const QVersionNumber &v2) |
| int | compare(const QVersionNumber &v1, const QVersionNumber &v2) |
(since 6.4) QVersionNumber | fromString(QAnyStringView string, qsizetype *suffixIndex = nullptr) |
Zugehörige Nicht-Mitglieder
| bool | operator!=(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| bool | operator<(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| QDataStream & | operator<<(QDataStream &out, const QVersionNumber &version) |
| bool | operator<=(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| bool | operator==(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| bool | operator>(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| bool | operator>=(const QVersionNumber &lhs, const QVersionNumber &rhs) |
| QDataStream & | operator>>(QDataStream &in, QVersionNumber &version) |
Ausführliche Beschreibung
QVersionNumber version(1, 2, 3); // 1.2.3Dokumentation zu Mitgliedstypen
[alias, since 6.8] QVersionNumber::const_iterator
[alias, since 6.8] QVersionNumber::const_reverse_iterator
Typedefs für eine undurchsichtige Klasse, die einen (umgekehrten) Iterator mit Direktzugriff auf Segmente des Typs „ QVersionNumber “ implementiert.
Hinweis: „ QVersionNumber “ unterstützt keine In-Place-Änderungen an Segmenten, daher gibt es keinen veränderbaren Iterator.
Diese Typdefinitionen wurden in Qt 6.8 eingeführt.
[alias, since 6.8] QVersionNumber::const_pointer
[alias, since 6.8] QVersionNumber::const_reference
[alias, since 6.8] QVersionNumber::difference_type
[alias, since 6.8] QVersionNumber::pointer
[alias, since 6.8] QVersionNumber::reference
[alias, since 6.8] QVersionNumber::size_type
[alias, since 6.8] QVersionNumber::value_type
Zur Gewährleistung der STL-Kompatibilität.
Hinweis: „ QVersionNumber “ unterstützt keine In-Place-Änderungen an Segmenten, daher sind „reference“ und „ const_reference “ sowie „pointer“ und „ const_pointer “ paarweise identische Typen.
Diese Typdefinitionen wurden in Qt 6.8 eingeführt.
Dokumentation der Mitgliedsfunktionen
[noexcept] QVersionNumber::QVersionNumber()
Erzeugt eine Null-Version.
Siehe auch „ isNull()“.
[explicit] QVersionNumber::QVersionNumber(QList<int> &&seg)
Erstellt eine Versionsnummer aus der Liste der Zahlen, die unter seg enthalten sind.
[explicit, since 6.8] QVersionNumber::QVersionNumber(QSpan<const int> args)
Erstellt eine Versionsnummer aus dem durch „ args “ angegebenen Bereich.
Hinweis: In Qt-Versionen vor 6.8 konnte `QVersionNumber` nur aus ` QList`, `QVarLenthArray` oder `std::initializer_list` erstellt werden.
Diese Funktion wurde in Qt 6.8 eingeführt.
[explicit] QVersionNumber::QVersionNumber(const QList<int> &seg)
Erstellt eine Versionsnummer aus der Liste der Zahlen, die unter seg zu finden sind.
[explicit] QVersionNumber::QVersionNumber(int maj)
Erstellt eine `QVersionNumber`, die ausschließlich aus der Hauptversionsnummer besteht: maj.
QVersionNumber::QVersionNumber(std::initializer_list<int> args)
Erstellt eine Versionsnummer aus der durch ` args` angegebenen `std::initializer_list`.
[explicit] QVersionNumber::QVersionNumber(int maj, int min)
Erstellt eine `QVersionNumber`, die sich aus der Haupt- und der Nebenversionsnummer zusammensetzt: maj bzw. min.
[explicit] QVersionNumber::QVersionNumber(int maj, int min, int mic)
Erstellt eine `QVersionNumber`, die aus den Haupt-, Neben- und Mikro-Versionsnummern maj, min bzw. mic besteht.
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::begin() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::cbegin() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::cend() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::constBegin() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::constEnd() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::end() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::crbegin() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::crend() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::rbegin() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::rend() const
Gibt jeweils einen ` const_iterator ` oder einen ` const_reverse_iterator` zurück, der auf das erste bzw. das auf das letzte Segment folgende Segment dieser Versionsnummer verweist.
Hinweis: ` QVersionNumber ` unterstützt keine In-Place-Änderungen an Segmenten, daher gibt es keinen veränderbaren Iterator.
Diese Funktionen wurden in Qt 6.8 eingeführt.
[static] QVersionNumber QVersionNumber::commonPrefix(const QVersionNumber &v1, const QVersionNumber &v2)
QVersionNumber QVersionNumber::commonPrefix(const QVersionNumber &v1, const QVersionNumber &v2)
Gibt eine Versionsnummer zurück, die eine übergeordnete Version sowohl von ` v1 ` als auch von ` v2` ist.
Siehe auch isPrefixOf().
[static noexcept] int QVersionNumber::compare(const QVersionNumber &v1, const QVersionNumber &v2)
Vergleicht v1 mit v2 und gibt eine ganze Zahl zurück, die kleiner als, gleich oder größer als Null ist, je nachdem, ob v1 kleiner als, gleich oder größer als v2 ist.
Die Vergleiche erfolgen durch den Abgleich der Segmente von v1 und v2, beginnend beim Index 0 und in Richtung des Endes der längeren Liste.
QVersionNumber v1(1, 2);
QVersionNumber v2(1, 2, 0);
int compare = QVersionNumber::compare(v1, v2); // compare == -1[static, since 6.4] QVersionNumber QVersionNumber::fromString(QAnyStringView string, qsizetype *suffixIndex = nullptr)
Erstellt eine „ QVersionNumber “ aus einer speziell formatierten „ string “ aus nicht-negativen Dezimalzahlen, die durch einen Punkt getrennt sind (.).
Sobald die numerischen Segmente geparst wurden, wird der Rest der Zeichenkette als Suffix-Zeichenkette betrachtet. Der Startindex dieser Zeichenkette wird in ` suffixIndex ` gespeichert, sofern er nicht null ist.
QLatin1StringView string("5.4.0-alpha");
qsizetype suffixIndex;
auto version = QVersionNumber::fromString(string, &suffixIndex);
// version is 5.4.0
// suffixIndex is 5Hinweis: In Versionen vor Qt 6.4 war diese Funktion stattdessen für ` QString`, ` QLatin1StringView ` und ` QStringView ` überladen, und ` suffixIndex ` war ein ` int*`.
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch isNull().
[noexcept] bool QVersionNumber::isNormalized() const
Gibt „ true “ zurück, wenn die Versionsnummer keine nachgestellten Nullen enthält; andernfalls wird „ false “ zurückgegeben.
Siehe auch normalized().
[noexcept] bool QVersionNumber::isNull() const
Gibt „ true “ zurück, wenn keine numerischen Segmente vorhanden sind, andernfalls „ false “.
Siehe auch segments().
[noexcept] bool QVersionNumber::isPrefixOf(const QVersionNumber &other) const
Gibt „ true “ zurück, wenn die aktuelle Versionsnummer in der Versionsnummer von „ other “ enthalten ist, andernfalls wird „ false “ zurückgegeben.
QVersionNumber v1(5, 3);
QVersionNumber v2(5, 3, 1);
bool value = v1.isPrefixOf(v2); // trueSiehe auch commonPrefix().
[noexcept] int QVersionNumber::majorVersion() const
Gibt die Hauptversionsnummer zurück, d. h. das erste Segment. Diese Funktion entspricht segmentAt(0). Ist das Objekt „ QVersionNumber “ null, gibt diese Funktion 0 zurück.
Siehe auch ` isNull()` und ` segmentAt()`.
[noexcept] int QVersionNumber::microVersion() const
Gibt die Mikro-Versionsnummer zurück, d. h. das dritte Segment. Diese Funktion entspricht segmentAt(2). Wenn dieses QVersionNumber -Objekt keine Mikronummer enthält, gibt diese Funktion 0 zurück.
Siehe auch isNull() und segmentAt().
[noexcept] int QVersionNumber::minorVersion() const
Gibt die Minor-Versionsnummer zurück, d. h. das zweite Segment. Diese Funktion entspricht segmentAt(1). Wenn dieses QVersionNumber -Objekt keine Minor-Nummer enthält, gibt diese Funktion 0 zurück.
Siehe auch „ isNull()“ und „ segmentAt()“.
QVersionNumber QVersionNumber::normalized() const
Gibt eine äquivalente Versionsnummer zurück, bei der jedoch alle nachgestellten Nullen entfernt wurden.
Um zu prüfen, ob zwei Zahlen gleichwertig sind, wenden Sie vor dem Vergleich die Funktion `normalized()` auf beide Versionsnummern an.
QVersionNumber v1(5, 4);
QVersionNumber v2(5, 4, 0);
bool equivalent = v1.normalized() == v2.normalized();
bool equal = v1 == v2;
// equivalent is true
// equal is false[noexcept] int QVersionNumber::segmentAt(qsizetype index) const
Gibt den Segmentwert unter index zurück. Wenn der Index nicht existiert, wird 0 zurückgegeben.
Siehe auch ` segments()` und ` segmentCount()`.
[noexcept] qsizetype QVersionNumber::segmentCount() const
Gibt die Anzahl der in „ segments()“ gespeicherten Ganzzahlen zurück.
Siehe auch ` segments()`.
QList<int> QVersionNumber::segments() const
Gibt alle numerischen Segmente zurück.
Siehe auch majorVersion(), minorVersion() und microVersion().
QString QVersionNumber::toString() const
Gibt eine Zeichenkette zurück, in der alle Segmente durch einen Punkt getrennt sind (.).
Siehe auch majorVersion(), minorVersion(), microVersion() und segments().
Verwandte Themen für Nichtmitglieder
[noexcept] bool operator!=(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ nicht gleich „ rhs “ ist; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
[noexcept] bool operator<(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ kleiner als „ rhs “ ist; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
QDataStream &operator<<(QDataStream &out, const QVersionNumber &version)
Schreibt die Versionsnummer version in den Stream out.
Beachten Sie, dass dies nichts mit QDataStream::version() zu tun hat.
[noexcept] bool operator<=(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ kleiner oder gleich „ rhs “ ist; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
[noexcept] bool operator==(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ gleich „ rhs “ ist; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
[noexcept] bool operator>(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ größer ist als „ rhs “; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
[noexcept] bool operator>=(const QVersionNumber &lhs, const QVersionNumber &rhs)
Gibt „ true “ zurück, wenn „ lhs “ größer oder gleich „ rhs “ ist; andernfalls wird „ false “ zurückgegeben.
Siehe auch QVersionNumber::compare().
QDataStream &operator>>(QDataStream &in, QVersionNumber &version)
Liest eine Versionsnummer aus dem Stream „ in “ und speichert sie in „ version “.
Beachten Sie, dass dies nichts mit QDataStream::version() zu tun hat.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.