Класс QSysInfo
Класс QSysInfo предоставляет информацию о системе. Подробнее...
| Заголовок: | #include <QSysInfo> |
| qmake: | QT += core |
Типы public
| Перечисление | Endian { BigEndian, LittleEndian, ByteOrder } |
| Перечисление | Sizes { WordSize } |
Статические члены public
| QByteArray | bootUniqueId() |
| QString | buildAbi() |
| QString | buildCpuArchitecture() |
| QString | currentCpuArchitecture() |
| QString | kernelType() |
| QString | kernelVersion() |
| QString | machineHostName() |
| QByteArray | machineUniqueId() |
| QString | prettyProductName() |
| QString | productType() |
| QString | productVersion() |
Подробное описание
Класс QSysInfo предоставляет информацию о системе.
- WordSize указывает размер указателя для платформы, на которой скомпилировано приложение.
- ByteOrder указывает, является ли платформа big-endian или little-endian.
Некоторые константы определены только на определённых платформах. Вы можете использовать препроцессорные символы Q_OS_WIN и Q_OS_MACOS, чтобы проверить, скомпилировано ли приложение под Windows или macOS.
См. также QLibraryInfo.
Документация по типам членов
Перечисление QSysInfo::Endian
| Константа | Значение | Описание |
|---|---|---|
QSysInfo::BigEndian |
0 |
Порядок байтов big-endian (также называется сетевым порядком байтов) |
QSysInfo::LittleEndian |
1 |
Порядок байтов little-endian |
QSysInfo::ByteOrder |
BigEndian or LittleEndian |
Равно BigEndian или LittleEndian, в зависимости от порядка байтов платформы. |
Перечисление QSysInfo::Sizes
Это перечисление предоставляет платформоспецифическую информацию о размерах структур данных, используемых базовой архитектурой.
| Константа | Значение | Описание |
|---|---|---|
QSysInfo::WordSize |
(sizeof(void *)<<3) |
Размер в битах указателя для платформы, на которой скомпилировано приложение (32 или 64). |
Документация по функциям-членам
[static] QByteArray QSysInfo::bootUniqueId()
Возвращает уникальный идентификатор запуска данной машины, если он может быть определен. Если уникальный идентификатор определить не удалось, функция возвращает пустой массив байтов. Это значение ожидается, что оно будет изменяться после каждого запуска и может считаться глобально уникальным.
В настоящее время эта функция реализована только для операционных систем Linux и Apple.
Функция была добавлена в Qt 5.11.
См. также machineUniqueId().
[static] QString QSysInfo::buildAbi()
Возвращает полную строку архитектуры, для которой был скомпилирован Qt. Эта строка полезна для идентификации различных несовместимых сборок. Например, она может использоваться как идентификатор для запроса пакета обновления с сервера.
Значения, возвращаемые этой функцией, сохраняются стабильными следующим образом: обязательные компоненты результата не будут изменяться в будущих версиях Qt, но могут быть добавлены необязательные суффиксы.
Возвращаемое значение состоит из трёх или более частей, разделённых дефисами («-»). Это:
| Компонент | Значение |
|---|---|
| Архитектура процессора | Такая же, как QSysInfo::buildCpuArchitecture(), например, "arm", "i386", "mips" или "x86_64" |
| Порядок байтов | "little_endian" или "big_endian" |
| Размер слова | Является ли это 32- или 64-битным приложением. Возможные значения: "llp64" (Windows 64-бит), "lp64" (Unix 64-бит), "ilp32" (32-бит) |
| (Необязательный) ABI | Ноль или более компонентов, идентифицирующих различные ABI, возможные в этой архитектуре. В настоящее время Qt имеет необязательные компоненты ABI для процессоров ARM и MIPS: один компонент — основной ABI (такой как "eabi", "o32", "n32", "o64"); другой — использует ли вызов конвенцию регистры с плавающей запятой ("hardfloat" присутствует). Кроме того, если 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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qsysinfo.html
