En esta página

QVersionNumber Class

La clase QVersionNumber contiene un número de versión con un número arbitrario de segmentos. Más información...

Cabecera: #include <QVersionNumber>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Comparaciones de QVersionNumber

CategoríaTipos comparables
strongQVersionNumber

Tipos públicos

(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

Funciones públicas

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

Miembros públicos estáticos

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)
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)

Descripción detallada

QVersionNumber version(1, 2, 3);  // 1.2.3

Documentación sobre los tipos de miembros

[alias, since 6.8] QVersionNumber::const_iterator

[alias, since 6.8] QVersionNumber::const_reverse_iterator

Definiciones de tipo para una clase opaca que implementa un iterador de acceso aleatorio (inverso) sobre segmentos de tipo « QVersionNumber ».

Nota: « QVersionNumber » no admite la modificación de segmentos in situ, por lo que no existe ningún iterador mutable.

Estas definiciones de tipo se introdujeron en Qt 6.8.

[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

Se ha incluido para garantizar la compatibilidad con STL.

Nota: QVersionNumber no admite la modificación de segmentos in situ, por lo que «reference» y « const_reference », así como «pointer» y « const_pointer », son tipos idénticos por pares.

Estas definiciones de tipo se introdujeron en Qt 6.8.

Documentación de las funciones miembro

[noexcept] QVersionNumber::QVersionNumber()

Genera una versión nula.

Véase también isNull().

[explicit] QVersionNumber::QVersionNumber(QList<int> &&seg)

Crea un número de versión a partir de la lista de números que contiene seg.

[explicit, since 6.8] QVersionNumber::QVersionNumber(QSpan<const int> args)

Crea un número de versión a partir del intervalo especificado por ` args`.

Nota: En las versiones de Qt anteriores a la 6.8, QVersionNumber solo se podía crear a partir de QList, QVarLenthArray o std::initializer_list.

Esta función se introdujo en Qt 6.8.

[explicit] QVersionNumber::QVersionNumber(const QList<int> &seg)

Crea un número de versión a partir de la lista de números que figura en seg.

[explicit] QVersionNumber::QVersionNumber(int maj)

Crea un objeto `QVersionNumber` que contiene únicamente el número de versión principal maj.

QVersionNumber::QVersionNumber(std::initializer_list<int> args)

Crea un número de versión a partir de la lista de inicializadores `std::initializer_list` especificada por ` args`.

[explicit] QVersionNumber::QVersionNumber(int maj, int min)

Crea un objeto QVersionNumber compuesto por los números de versión principal y secundaria, maj y min, respectivamente.

[explicit] QVersionNumber::QVersionNumber(int maj, int min, int mic)

Crea un objeto `QVersionNumber` compuesto por los números de versión principal, secundaria y micro: maj, min y mic, respectivamente.

[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

Devuelve un ` const_iterator ` o un ` const_reverse_iterator`, respectivamente, que apuntan al primer segmento o al segmento inmediatamente posterior al último de este número de versión.

Nota: ` QVersionNumber ` no admite la modificación de segmentos in situ, por lo que no hay ningún iterador mutable.

Estas funciones se introdujeron en Qt 6.8.

[static] QVersionNumber QVersionNumber::commonPrefix(const QVersionNumber &v1, const QVersionNumber &v2)

QVersionNumber QVersionNumber::commonPrefix(const QVersionNumber &v1, const QVersionNumber &v2)

Devuelve un número de versión que es una versión superior tanto de v1 como de v2.

Véase también isPrefixOf().

[static noexcept] int QVersionNumber::compare(const QVersionNumber &v1, const QVersionNumber &v2)

Compara v1 con v2 y devuelve un número entero menor, igual o mayor que cero, dependiendo de si v1 es menor, igual o mayor que v2, respectivamente.

Las comparaciones se realizan comparando los segmentos de v1 y v2, comenzando por el índice 0 y avanzando hacia el final de la lista más larga.

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)

Crea un objeto ` QVersionNumber ` a partir de una cadena ` string ` con un formato especial, compuesta por números decimales no negativos delimitados por un punto (.).

Una vez analizados los segmentos numéricos, el resto de la cadena se considera la cadena sufijo. El índice inicial de dicha cadena se almacenará en suffixIndex si no es nulo.

QLatin1StringView string("5.4.0-alpha");
qsizetype suffixIndex;
auto version = QVersionNumber::fromString(string, &suffixIndex);
// version is 5.4.0
// suffixIndex is 5

Nota: En versiones anteriores a Qt 6.4, esta función se sobrecargaba para QString, QLatin1StringView y QStringView, y suffixIndex era un int*.

Esta función se introdujo en Qt 6.4.

Véase también isNull().

[noexcept] bool QVersionNumber::isNormalized() const

Devuelve « true » si el número de versión no contiene ceros al final; en caso contrario, devuelve « false ».

Véase también normalized().

[noexcept] bool QVersionNumber::isNull() const

Devuelve ` true ` si no hay ningún segmento numérico; en caso contrario, devuelve ` false`.

Véase también segments().

[noexcept] bool QVersionNumber::isPrefixOf(const QVersionNumber &other) const

Devuelve « true » si el número de versión actual está incluido en el número de versión de « other »; en caso contrario, devuelve « false ».

QVersionNumber v1(5, 3);
QVersionNumber v2(5, 3, 1);
bool value = v1.isPrefixOf(v2); // true

Véase también commonPrefix().

[noexcept] int QVersionNumber::majorVersion() const

Devuelve el número de versión principal, es decir, el primer segmento. Esta función es equivalente a ` segmentAt(0)`. Si este objeto ` QVersionNumber ` es nulo, esta función devuelve 0.

Véase también isNull() y segmentAt().

[noexcept] int QVersionNumber::microVersion() const

Devuelve el número de versión «micro», es decir, el tercer segmento. Esta función es equivalente a segmentAt(2). Si este objeto QVersionNumber no contiene un número «micro», esta función devuelve 0.

Véase también isNull() y segmentAt().

[noexcept] int QVersionNumber::minorVersion() const

Devuelve el número de versión menor, es decir, el segundo segmento. Esta función es equivalente a segmentAt(1). Si este objeto QVersionNumber no contiene un número de versión menor, esta función devuelve 0.

Véase también isNull() y segmentAt().

QVersionNumber QVersionNumber::normalized() const

Devuelve un número de versión equivalente, pero sin los ceros finales.

Para comprobar si dos números son equivalentes, utiliza la función `normalized()` en ambos números de versión antes de realizar la comparación.

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

Devuelve el valor del segmento en index. Si el índice no existe, devuelve 0.

Véase también segments() y segmentCount().

[noexcept] qsizetype QVersionNumber::segmentCount() const

Devuelve el número de números enteros almacenados en segments().

Véase también segments().

QList<int> QVersionNumber::segments() const

Devuelve todos los segmentos numéricos.

Véase también majorVersion(), minorVersion() y microVersion().

QString QVersionNumber::toString() const

Devuelve una cadena con todos los segmentos delimitados por un punto (.).

Véase también majorVersion(), minorVersion(), microVersion() y segments().

Temas relacionados para no miembros

[noexcept] bool operator!=(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve « true » si « lhs » no es igual a « rhs »; en caso contrario, devuelve « false ».

Véase también QVersionNumber::compare().

[noexcept] bool operator<(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve « true » si « lhs » es menor que « rhs »; en caso contrario, devuelve « false ».

Véase también QVersionNumber::compare().

QDataStream &operator<<(QDataStream &out, const QVersionNumber &version)

Escribe el número de versión version en el flujo out.

Ten en cuenta que esto no tiene nada que ver con QDataStream::version().

[noexcept] bool operator<=(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve « true » si « lhs » es menor o igual que « rhs »; en caso contrario, devuelve « false ».

Véase también QVersionNumber::compare().

[noexcept] bool operator==(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve « true » si « lhs » es igual a « rhs »; en caso contrario, devuelve « false ».

Véase también QVersionNumber::compare().

[noexcept] bool operator>(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve ` true ` si ` lhs ` es mayor que ` rhs`; en caso contrario, devuelve ` false`.

Véase también QVersionNumber::compare().

[noexcept] bool operator>=(const QVersionNumber &lhs, const QVersionNumber &rhs)

Devuelve « true » si « lhs » es mayor o igual que « rhs »; en caso contrario, devuelve « false ».

Véase también QVersionNumber::compare().

QDataStream &operator>>(QDataStream &in, QVersionNumber &version)

Lee un número de versión del flujo in y lo almacena en version.

Ten en cuenta que esto no tiene nada que ver con QDataStream::version().

© 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.