Класс QSysInfo

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

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

Типы public

Статические члены public

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

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

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

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

См. также QLibraryInfo.

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

Перечисление QSysInfo::Endian

Перечисление QSysInfo::Sizes

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

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

[static] QByteArray QSysInfo::bootUniqueId()

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

Эта функция в настоящее время реализована только для операционных систем Linux и Apple.

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

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

[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, например, "winnt". В системах Unix она возвращает то же, что и вывод uname -s (в нижнем регистре).

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

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

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

[static] QString QSysInfo::kernelVersion()

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

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

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

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

[static] QString QSysInfo::machineHostName()

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

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

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

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

См. также QHostInfo::localDomainName и machineUniqueId().

[static] QByteArray QSysInfo::machineUniqueId()

Возвращает уникальный идентификатор этой машины, если он может быть определен. Если уникальный идентификатор определить не удалось, функция возвращает пустой массив байтов. В отличие от machineHostName(), возвращаемое значение этой функции, скорее всего, будет глобально уникальным.

Уникальный идентификатор полезен в сетевых операциях для идентификации данной машины на протяжении длительного времени, когда IP-адрес может измениться или если у этой машины может быть более одного IP-адреса. Например, идентификатор может быть использован при общении с сервером или при сохранении данных, специфичных для устройства, в общем сетевом хранилище.

Обратите внимание, что в некоторых системах это значение сохраняется после перезагрузки, а в некоторых – нет. Приложения не должны слепо полагаться на этот факт без проверки возможностей ОС. В частности, в системах Linux этот идентификатор обычно постоянный и соответствует идентификатору машины D-Bus, за исключением узлов без собственного хранилища (реплицированные узлы).

Данная функция была добавлена в Qt 5.11.

См. также machineHostName() и bootUniqueId().

[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".

Примечание для macOS: эта функция возвращает "osx" для всех систем macOS, независимо от соглашений об именовании Apple. Возвращаемая строка будет обновлена для Qt 6. Обратите внимание, что эта функция ошибочно возвращала "macos" для macOS 10.12 в версиях Qt 5.6.2, 5.7.1 и 5.8.0.

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

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

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

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

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

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

[static] QString QSysInfo::productVersion()

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

Она вернет полные версии Android, iOS, macOS, Windows в этих системах.

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

• "2016.09" (Amazon Linux AMI 2016.09)
• "7.1" (Android Nougat)
• "25" (Fedora 25)
• "10.1" (iOS 10.1)
• "10.12" (macOS Sierra)
• "10.0" (tvOS 10)
• "16.10" (Ubuntu 16.10)
• "3.1" (watchOS 3.1)
• "7 SP 1" (Windows 7 Service Pack 1)
• "8.1" (Windows 8.1)
• "10" (Windows 10)
• "Server 2016" (Windows Server 2016)

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

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

Примечание: Строка версии, возвращаемая этой функцией, не гарантирует возможности упорядочивания. В Linux версии дистрибутива могут неожиданно изменяться, пожалуйста, обратитесь к документации дистрибутива для получения информации о практиках версионирования.

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

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