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ía | Tipos comparables |
|---|---|
| strong | QVersionNumber |
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) |
Elementos no miembros relacionados
| 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.3Documentació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 5Nota: 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); // trueVé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.