class QVersionNumber

The QVersionNumber class contains a version number with an arbitrary number of segments. More

Synopsis

Methods

Static functions

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

QVersionNumber version(1, 2, 3) # 1.2.3
class enum_264
__init__()

Produces a null version.

See also

isNull()

__init__(maj)
Parameters:

maj – int

Constructs a QVersionNumber consisting of just the major version number maj.

__init__(maj, min)
Parameters:
  • maj – int

  • min – int

Constructs a QVersionNumber consisting of the major and minor version numbers maj and min, respectively.

__init__(maj, min, mic)
Parameters:
  • maj – int

  • min – int

  • mic – int

Constructs a QVersionNumber consisting of the major, minor, and micro version numbers maj, min and mic, respectively.

static commonPrefix(v1, v2)
Parameters:
Return type:

QVersionNumber

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

Returns a version number that is a parent version of both v1 and v2.

See also

isPrefixOf()

static compare(v1, v2)
Parameters:
Return type:

int

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Compares v1 with v2 and returns an integer less than, equal to, or greater than zero, depending on whether v1 is less than, equal to, or greater than v2, respectively.

Comparisons are performed by comparing the segments of v1 and v2 starting at index 0 and working towards the end of the longer list.

v1 = QVersionNumber(1, 2)
v2 = QVersionNumber(1, 2, 0)
compare = QVersionNumber.compare(v1, v2) # compare == -1()
static fromString(string)
Parameters:

string – str

Return type:

QVersionNumber

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Constructs a QVersionNumber from a specially formatted string of non-negative decimal numbers delimited by a period (.).

Once the numerical segments have been parsed, the remainder of the string is considered to be the suffix string. The start index of that string will be stored in suffixIndex if it is not null.

string = QLatin1StringView("5.4.0-alpha")
suffixIndex = qsizetype()
version = QVersionNumber.fromString(string, suffixIndex)
# version is 5.4.0
# suffixIndex is 5

Note

In versions prior to Qt 6.4, this function was overloaded for QString , QLatin1StringView and QStringView instead, and suffixIndex was an int*.

See also

isNull()

isNormalized()
Return type:

bool

Returns true if the version number does not contain any trailing zeros, otherwise returns false.

See also

normalized()

isNull()
Return type:

bool

Returns true if there are zero numerical segments, otherwise returns false.

See also

segments()

isPrefixOf(other)
Parameters:

otherQVersionNumber

Return type:

bool

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Returns true if the current version number is contained in the other version number, otherwise returns false.

v1 = QVersionNumber(5, 3)
v2 = QVersionNumber(5, 3, 1)
value = v1.isPrefixOf(v2) # true

See also

commonPrefix()

majorVersion()
Return type:

int

Returns the major version number, that is, the first segment. This function is equivalent to segmentAt (0). If this QVersionNumber object is null, this function returns 0.

microVersion()
Return type:

int

Returns the micro version number, that is, the third segment. This function is equivalent to segmentAt (2). If this QVersionNumber object does not contain a micro number, this function returns 0.

minorVersion()
Return type:

int

Returns the minor version number, that is, the second segment. This function is equivalent to segmentAt (1). If this QVersionNumber object does not contain a minor number, this function returns 0.

normalized()
Return type:

QVersionNumber

Warning

This section contains snippets that were automatically translated from C++ to Python and may contain errors.

Returns an equivalent version number but with all trailing zeros removed.

To check if two numbers are equivalent, use normalized() on both version numbers before performing the compare.

v1 = QVersionNumber(5, 4)
v2 = QVersionNumber(5, 4, 0)
equivalent = v1.normalized() == v2.normalized()
equal = v1 == v2
# equivalent is true
# equal is false
__ne__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is not equal to rhs; otherwise returns false.

See also

compare()

__lt__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is less than rhs; otherwise returns false.

See also

compare()

__le__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is less than or equal to rhs; otherwise returns false.

See also

compare()

__eq__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is equal to rhs; otherwise returns false.

See also

compare()

__gt__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is greater than rhs; otherwise returns false.

See also

compare()

__ge__(rhs)
Parameters:

rhsQVersionNumber

Return type:

bool

Returns true if lhs is greater than or equal to rhs; otherwise returns false.

See also

compare()

segmentAt(index)
Parameters:

index – int

Return type:

int

Returns the segment value at index. If the index does not exist, returns 0.

segmentCount()
Return type:

int

Returns the number of integers stored in segments() .

See also

segments()

segments()
Return type:

.list of int

Returns all of the numerical segments.

toString()
Return type:

str

Returns a string with all of the segments delimited by a period (.).