Класс QVersionNumber

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

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

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

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

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

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

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 initializer lists.

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

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

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

QVersionNumber::QVersionNumber(const QList<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 или больше ли 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, since 5.10] 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, since 5.10] 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 null, этот метод возвращает 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

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

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

int QVersionNumber::segmentCount() const

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

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

QList<int> QVersionNumber::segments() const

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

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

QString QVersionNumber::toString() const

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

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