Класс QVersionNumber

Класс QVersionNumber содержит номер версии с произвольным количеством сегментов. Подробнее...

Этот класс был представлен в Qt 5.6.

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Связанные нечлены

Подробное описание

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

Документация по функциям-членам

QVersionNumber::QVersionNumber(int maj, int min, int mic)

Создаёт QVersionNumber на основе номера версии maj, min и mic для основных, второстепенных и мелких версий, соответственно.

QVersionNumber::QVersionNumber(int maj, int min)

Создаёт QVersionNumber на основе основных и второстепенных версий maj и min, соответственно.

QVersionNumber::QVersionNumber(int maj)

Создаёт QVersionNumber на основе только номера основной версии maj.

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

Создаёт номер версии из переданного std::initializer_list args.

Этот конструктор доступен только если компилятор поддерживает C++11 инициализаторы списков.

QVersionNumber::QVersionNumber(QVector<int> &&seg)

Перемещающий конструктор для номера версии из списка чисел в seg.

Этот конструктор доступен только если компилятор поддерживает C++11 перемещаемые семантики.

QVersionNumber::QVersionNumber(const QVector<int> &seg)

Создаёт номер версии из списка чисел в seg.

QVersionNumber::QVersionNumber()

Создаёт нулевой номер версии.

См. также isNull().

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

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

Возвращает номер версии, который является родительским номером версии для v1 и v2.

См. также isPrefixOf().

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

Сравнивает v1 с v2 и возвращает целое число, меньшее, равное или большее нуля, в зависимости от того, меньше ли v1, равно ли v1 или больше ли v1, соответственно.

Сравнения выполняются путём сравнения сегментов v1 и v2, начиная с индекса 0 и двигаясь к концу более длинного списка.

QVersionNumber v1(1, 2);
QVersionNumber v2(1, 2, 0);
int compare = QVersionNumber::compare(v1, v2); // compare == -1

[static] QVersionNumber QVersionNumber::fromString(const QString &string, int *suffixIndex = nullptr)

Создаёт QVersionNumber из специально отформатированной строки неотрицательных десятичных чисел, разделённых точкой (.).

После разбора числовых сегментов, остальная часть строки считается строкой суффикса. Начальный индекс этой строки будет сохранён в suffixIndex, если он не равен null.

QString string("5.4.0-alpha");
int suffixIndex;
QVersionNumber version = QVersionNumber::fromString(string, &suffixIndex);
// version is 5.4.0
// suffixIndex is 5

См. также isNull().

[static] QVersionNumber QVersionNumber::fromString(QLatin1String string, int *suffixIndex = nullptr)

Это перегруженный метод.

Создаёт QVersionNumber из специально отформатированной строки неотрицательных десятичных чисел, разделённых точкой «.».

После разбора числовых сегментов, остальная часть строки считается строкой суффикса. Начальный индекс этой строки будет сохранён в suffixIndex, если он не равен null.

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

Этот метод был добавлен в Qt 5.10.

См. также isNull().

[static] QVersionNumber QVersionNumber::fromString(QStringView string, int *suffixIndex = nullptr)

Это перегруженный метод.

Создаёт QVersionNumber из специально отформатированной строки неотрицательных десятичных чисел, разделённых точкой «.».

После разбора числовых сегментов, остальная часть строки считается строкой суффикса. Начальный индекс этой строки будет сохранён в suffixIndex, если он не равен null.

QString string("5.4.0-alpha");
int suffixIndex;
QVersionNumber version = QVersionNumber::fromString(string, &suffixIndex);
// version is 5.4.0
// suffixIndex is 5

Этот метод был добавлен в Qt 5.10.

См. также isNull().

bool QVersionNumber::isNormalized() const

Возвращает true если номер версии не содержит конечных нулей, в противном случае возвращает false.

См. также normalized().

bool QVersionNumber::isNull() const

Возвращает true если числовых сегментов ноль, в противном случае возвращает false.

См. также segments().

bool QVersionNumber::isPrefixOf(const QVersionNumber &other) const

Возвращает true если текущий номер версии содержится в номере версии other, в противном случае возвращает false.

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

См. также commonPrefix().

int QVersionNumber::majorVersion() const

Возвращает номер основной версии, то есть первый сегмент. Этот метод эквивалентен segmentAt(0). Если объект QVersionNumber пустой, этот метод возвращает 0.

См. также isNull() и segmentAt().

int QVersionNumber::microVersion() const

Возвращает номер микроверсии, то есть третий сегмент. Этот метод эквивалентен segmentAt(2). Если в объекте QVersionNumber нет номера микроверсии, этот метод возвращает 0.

См. также isNull() и segmentAt().

int QVersionNumber::minorVersion() const

Возвращает номер версии, то есть второй сегмент. Этот метод эквивалентен segmentAt(1). Если в объекте QVersionNumber нет номера микроверсии, этот метод возвращает 0.

См. также isNull() и segmentAt().

QVersionNumber QVersionNumber::normalized() const

Возвращает эквивалентный номер версии, но с удалёнными конечными нулями.

Для проверки эквивалентности чисел используйте normalized() для обоих номеров версии перед сравнением.

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

int QVersionNumber::segmentAt(int index) const

Возвращает значение сегмента в индексе. Если индекс не существует, возвращает 0.

См. также segments() и segmentCount().

int QVersionNumber::segmentCount() const

Возвращает количество целых чисел, хранящихся в segments().

См. также segments().

QVector<int> QVersionNumber::segments() const

Возвращает все числовые сегменты.

См. также majorVersion(), minorVersion() и microVersion().

QString QVersionNumber::toString() const

Возвращает строку со всеми сегментами, разделёнными точкой (.).

См. также majorVersion(), minorVersion(), microVersion() и segments().