QVersionNumber Class
La clase QVersionNumber contiene un número de versión con un número arbitrario de segmentos. Más...
| Cabecera: | #include <QVersionNumber> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Esta clase es fuertemente comparable.
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) |
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.3
Documentación de los tipos de miembros
[alias, since 6.8] QVersionNumber::const_iterator
[alias, since 6.8] QVersionNumber::const_reverse_iterator
Typedefs para una clase opaca que implementa un iterador (inverso) de acceso aleatorio sobre segmentos QVersionNumber.
Nota: QVersionNumber no admite la modificación de segmentos in situ, por lo que no existe un iterador mutable.
Estos typedefs 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 proporciona por compatibilidad con STL.
Nota: QVersionNumber no soporta la modificación de segmentos in-place, por lo que referencia y const_reference, así como puntero y const_pointer son pares de tipos iguales.
Estos typedefs se introdujeron en Qt 6.8.
Documentación de funciones miembro
[noexcept] QVersionNumber::QVersionNumber()
Produce una versión nula.
Véase también isNull().
[explicit] QVersionNumber::QVersionNumber(QList<int> &&seg)
Move-construye un número de versión a partir de la lista de números contenida en seg.
[explicit, since 6.8] QVersionNumber::QVersionNumber(QSpan<const int> args)
Construye un número de versión a partir del span especificado por args.
Nota: En versiones de Qt anteriores a la 6.8, QVersionNumber sólo podía construirse 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)
Construye un número de versión a partir de la lista de números contenida en seg.
[explicit] QVersionNumber::QVersionNumber(int maj)
Construye un QVersionNumber consistente únicamente en el número de versión principal maj.
QVersionNumber::QVersionNumber(std::initializer_list<int> args)
Construye un número de versión a partir de la lista std::initializer_list especificada por args.
[explicit] QVersionNumber::QVersionNumber(int maj, int min)
Construye un QVersionNumber consistente en los números de versión mayor y menor maj y min, respectivamente.
[explicit] QVersionNumber::QVersionNumber(int maj, int min, int mic)
Construye un QVersionNumber consistente en los números de versión mayor, menor 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::end() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::rbegin() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::rend() 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_reverse_iterator QVersionNumber::crbegin() const
[noexcept, since 6.8] QVersionNumber::const_reverse_iterator QVersionNumber::crend() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::constBegin() const
[noexcept, since 6.8] QVersionNumber::const_iterator QVersionNumber::constEnd() const
Devuelve un const_iterator o const_reverse_iterator, respectivamente, apuntando al primero o al último segmento de este número de versión.
Nota: QVersionNumber no permite modificar segmentos in situ, por lo que no existe un 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 padre 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 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 en el índice 0 y trabajando 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)
Construye un QVersionNumber a partir de un string especialmente formateado de 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 de inicio de esa 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 estaba sobrecargada para QString, QLatin1StringView y QStringView en su lugar, 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 hay cero segmentos numéricos, 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á contenido en el número de versión 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 microversión, es decir, el tercer segmento. Esta función es equivalente a segmentAt(2). Si este objeto QVersionNumber no contiene un número de 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 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, utilice 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 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().
No miembros relacionados
[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.
Tenga 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.
Tenga 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.