Класс QSysInfo

Класс QSysInfo предоставляет информацию о системе. Подробнее...

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

Типы общедоступного использования

Статические члены публичного использования

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

Класс QSysInfo предоставляет информацию о системе.

• WordSize указывает размер указателя для платформы, на которой скомпилировано приложение.
• ByteOrder указывает, является ли платформа big-endian или little-endian.
• WindowsVersion указывает версию операционной системы Windows, на которой выполняется приложение.
• MacintoshVersion указывает версию операционной системы Macintosh, на которой выполняется приложение.

Некоторые константы определены только на определенных платформах. Вы можете использовать препроцессорные символы Q_OS_WIN и Q_OS_MACOS для проверки того, что приложение скомпилировано под Windows или macOS.

См. также QLibraryInfo.

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

enum QSysInfo::Endian

enum QSysInfo::MacVersion

Это перечисление предоставляет символические имена для различных версий операционной системы Darwin, охватывая как macOS, так и iOS. Переменная QSysInfo::MacintoshVersion указывает версию системы, на которой выполняется приложение.

См. также WinVersion.

enum QSysInfo::Sizes

Этот перечисление предоставляет платформозависимую информацию о размерах структур данных, используемых базовой архитектурой.

enum QSysInfo::WinVersion

Это перечисление предоставляет символические имена для различных версий операционной системы Windows. В Windows переменная QSysInfo::WindowsVersion указывает версию системы, на которой выполняется приложение.

Версии на основе MS-DOS:

Версии на основе NT (обратите внимание, что каждая версия операционной системы представлена только один раз, а не каждое издание Windows):

В качестве альтернативы, вы можете использовать следующие макросы, которые напрямую соответствуют номеру версии операционной системы Windows:

Версии на основе CE:

Следующие маски могут использоваться для проверки, основана ли версия Windows на MS-DOS, NT или CE:

См. также MacVersion.

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

[static] QString QSysInfo::buildAbi()

Возвращает полную строку архитектуры, для которой был скомпилирован Qt. Эта строка полезна для идентификации различных несовместимых сборок. Например, она может использоваться в качестве идентификатора для запроса пакета обновления с сервера.

Значения, возвращаемые этой функцией, поддерживаются стабильно следующим образом: обязательные компоненты результата не изменятся в будущих версиях Qt, но могут быть добавлены дополнительные суффиксы.

Возвращаемое значение состоит из трех или более частей, разделенных дефисами ("-"). Это:

Эта функция была представлена в Qt 5.4.

См. также QSysInfo::buildCpuArchitecture().

[static] QString QSysInfo::buildCpuArchitecture()

Возвращает архитектуру процессора, для которого был скомпилирован Qt, в текстовом формате. Обратите внимание, что она может не соответствовать фактическому процессору, на котором выполняется приложение, если существует уровень эмуляции или если процессор поддерживает несколько архитектур (например, процессоры x86-64, поддерживающие приложения i386). Чтобы определить это, используйте currentCpuArchitecture().

Значения, возвращаемые этой функцией, стабильны и не изменятся со временем, поэтому приложения могут полагаться на возвращаемое значение в качестве идентификатора, за исключением того, что новые типы процессоров могут быть добавлены со временем.

Типичные возвращаемые значения (список неполный):

• "arm"
• "arm64"
• "i386"
• "ia64"
• "mips"
• "mips64"
• "power"
• "power64"
• "sparc"
• "sparcv9"
• "x86_64"

Эта функция была представлена в Qt 5.4.

См. также QSysInfo::buildAbi() и QSysInfo::currentCpuArchitecture().

[static] QString QSysInfo::currentCpuArchitecture()

Возвращает архитектуру процессора, на котором выполняется приложение, в текстовом формате. Обратите внимание, что эта функция зависит от того, что сообщит операционная система, и может не обнаружить фактическую архитектуру процессора, если операционная система скрывает эту информацию или не может ее предоставить. Например, 32-разрядная операционная система, работающая на 64-разрядном процессоре, обычно не может определить, что процессор фактически способен выполнять 64-разрядные программы.

Значения, возвращаемые этой функцией, в основном стабильны: будет сделана попытка убедиться, что они остаются постоянными со временем и соответствуют значениям, возвращаемым QSysInfo::builldCpuArchitecture(). Однако из-за характера используемых функций операционной системы могут быть расхождения.

Типичные возвращаемые значения (список неполный):

• "arm"
• "arm64"
• "i386"
• "ia64"
• "mips"
• "mips64"
• "power"
• "power64"
• "sparc"
• "sparcv9"
• "x86_64"

Эта функция была представлена в Qt 5.4.

См. также QSysInfo::buildAbi() и QSysInfo::buildCpuArchitecture().

[static] QString QSysInfo::kernelType()

Возвращает тип ядра операционной системы, для которого был скомпилирован Qt. Также это ядро, на котором работает приложение, если хост-операционная система не выполняет функции совместимости или виртуализации.

Значения, возвращаемые этой функцией, стабильны и не изменятся со временем, поэтому приложения могут полагаться на возвращаемое значение в качестве идентификатора, за исключением того, что новые типы ядер ОС могут быть добавлены со временем.

В Windows эта функция возвращает тип ядра Windows, например, "wince" или "winnt". В системах Unix она возвращает то же, что и вывод uname -s (в нижнем регистре).

Обратите внимание, что эта функция может возвращать неожиданные значения: она возвращает "linux" для всех операционных систем, работающих под Linux (включая Android), "qnx" для всех операционных систем, работающих под QNX (включая BlackBerry 10), "freebsd" для Debian/kFreeBSD и "darwin" для macOS и iOS. Для получения информации о типе продукта, на котором выполняется приложение, см. productType().

Эта функция была представлена в Qt 5.4.

См. также QFileSelector, kernelVersion(), productType(), productVersion() и prettyProductName().

[static] QString QSysInfo::kernelVersion()

Возвращает версию релиза ядра операционной системы. В Windows она возвращает версию ядра NT или CE. В системах Unix, включая Android, BlackBerry и macOS, она возвращает то же, что и команда uname -r.

Если версия не может быть определена, эта функция может вернуть пустую строку.

Эта функция была представлена в Qt 5.4.

См. также kernelType(), productType(), productVersion() и prettyProductName().

[static] MacVersion QSysInfo::macVersion()

Возвращает версию Darwin (macOS или iOS), на которой выполняется приложение, или MV_None, если операционная система не является версией Darwin.

[static] QString QSysInfo::machineHostName()

Возвращает имя хоста этой машины, если оно настроено. Обратите внимание, что имена хостов не гарантируется, что они будут глобально уникальными, особенно если они были настроены автоматически.

Эта функция не гарантирует, что возвращаемое имя хоста является полным доменным именем (FQDN). Для этого используйте QHostInfo для разрешения возвращённого имени в FQDN.

Эта функция возвращает то же, что и QHostInfo::localHostName().

Эта функция была введена в Qt 5.6.

См. также QHostInfo::localDomainName.

[static] QString QSysInfo::prettyProductName()

Возвращает более удобочитаемый вид productType() и productVersion(), содержащий другие токены, такие как тип операционной системы, кодовые названия и другую информацию. Результат этой функции подходит для отображения пользователю, но не для долгосрочного хранения, так как строка может измениться с обновлениями Qt.

Если productType() равно "unknown", эта функция вместо этого будет использовать функции kernelType() и kernelVersion().

Эта функция была введена в Qt 5.4.

См. также kernelType(), kernelVersion(), productType() и productVersion().

[static] QString QSysInfo::productType()

Возвращает имя продукта операционной системы, в которой выполняется это приложение. Если приложение выполняется на некотором эмуляционном или виртуализирующем слое (например, WINE на системе Unix), эта функция проверит эмуляционный/виртуализирующий слой.

Значения, возвращаемые этой функцией, стабильны и не будут изменяться со временем, поэтому приложения могут полагаться на возвращаемое значение в качестве идентификатора, за исключением того, что новые типы ОС могут быть добавлены со временем.

Примечание для Linux и Android: эта функция возвращает "android" для систем Linux, работающих под Android, в частности, при использовании библиотеки Bionic. Для всех других систем Linux, независимо от используемой библиотеки C, она пытается определить имя дистрибутива и возвращает его. Если определение имени дистрибутива не удалось, она возвращает "unknown".

Примечание для BlackBerry: эта функция возвращает "blackberry" для систем QNX, работающих под BlackBerry, но "qnx" для всех остальных систем на базе QNX.

Примечание для Darwin, macOS и iOS: эта функция возвращает "macos" для macOS, "ios" для iOS и "darwin", если система не может быть определена.

Примечание для OS X: эта функция возвращает "osx" для версий macOS до 10.12.

Примечание для FreeBSD: эта функция возвращает "debian" для Debian/kFreeBSD и "unknown" в противном случае.

Примечание для Windows: эта функция возвращает "winphone" для сборок для Windows Phone, "winrt" для WinRT сборок, "wince" для Windows CE и Embedded Compact сборок и "windows" для обычных настольных сборок.

Для других систем типа Unix эта функция обычно возвращает "unknown".

Эта функция была введена в Qt 5.4.

См. также QFileSelector, kernelType(), kernelVersion(), productVersion() и prettyProductName().

[static] QString QSysInfo::productVersion()

Возвращает версию продукта операционной системы в строковом формате. Если версия не может быть определена, эта функция возвращает "unknown".

Она вернёт полные версии Android, BlackBerry, iOS, macOS и Windows на этих системах. В частности, на macOS, iOS и Windows возвращаемая строка аналогична перечислениям macVersion() или windowsVersion().

На системах Linux она попытается определить версию дистрибутива и вернёт её. Это также делается для Debian/kFreeBSD, поэтому эта функция вернёт версию Debian в этом случае.

Во всех других системах типа Unix эта функция всегда возвращает "unknown".

Примечание: строка версии, возвращаемая этой функцией, гарантирует упорядоченность только на Android, BlackBerry, macOS и iOS. На Windows некоторые версии Windows являются текстом ("XP" и "Vista", например). На Linux версия дистрибутива может неожиданно изменяться, пожалуйста, обратитесь к документации дистрибутива для понимания правил версии.

Эта функция была введена в Qt 5.4.

См. также kernelType(), kernelVersion(), productType() и prettyProductName().

[static] WinVersion QSysInfo::windowsVersion()

Возвращает версию операционной системы Windows, на которой запущено приложение, или WV_None, если операционная система не Windows.

Эта функция была введена в Qt 4.4.