Класс QVersionNumber

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

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

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

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

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

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

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

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

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

QVersionNumber::QVersionNumber()

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

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

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

Конструирует номер версии из списка чисел, содержащихся в seg.

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

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

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

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

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

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

QVersionNumber::QVersionNumber(int maj)

Конструирует QVersionNumber , состоящий только из основного номера версии maj.

QVersionNumber::QVersionNumber(int maj, int min)

Конструирует QVersionNumber, состоящий из основных и второстепенных номеров версии maj и min соответственно.

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

Конструирует QVersionNumber, состоящий из основных, второстепенных и микроверсий maj, min и mic соответственно.

[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 меньше, равно или больше v2 соответственно.

Сравнения выполняются путём сравнения сегментов 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().