QSysInfo Class
La clase QSysInfo proporciona información sobre el sistema. Más...
| Encabezado: | #include <QSysInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Tipos públicos
Miembros públicos estáticos
| QByteArray | bootUniqueId() |
| QString | buildAbi() |
| QString | buildCpuArchitecture() |
| QString | currentCpuArchitecture() |
| QString | kernelType() |
| QString | kernelVersion() |
| QString | machineHostName() |
| QByteArray | machineUniqueId() |
| QString | prettyProductName() |
| QString | productType() |
| QString | productVersion() |
Descripción detallada
- WordSize especifica el tamaño de un puntero para la plataforma en la que se compila la aplicación.
- ByteOrder Especifica si la plataforma es «big-endian» o «little-endian».
Algunas constantes solo están definidas en determinadas plataformas. Puedes utilizar los símbolos del preprocesador Q_OS_WIN y Q_OS_MACOS para comprobar si la aplicación se ha compilado en Windows o macOS.
Véase también QLibraryInfo.
Documentación sobre tipos de miembros
enum QSysInfo::Endian
| Constante | Valor | Descripción |
|---|---|---|
QSysInfo::BigEndian | 0 | Orden de bytes «big-endian» (también denominado «orden de bytes de red») |
QSysInfo::LittleEndian | 1 | Orden de bytes «little-endian» |
QSysInfo::ByteOrder | BigEndian or LittleEndian | Equivale a BigEndian o LittleEndian, dependiendo del orden de los bytes de la plataforma. |
enum QSysInfo::Sizes
Esta enumeración proporciona información específica de la plataforma sobre los tamaños de las estructuras de datos utilizadas por la arquitectura subyacente.
| Constante | Valor | Descripción |
|---|---|---|
QSysInfo::WordSize | (sizeof(void *)<<3) | El tamaño en bits de un puntero para la plataforma en la que se compila la aplicación (32 o 64). |
Documentación de las funciones miembro
[static] QByteArray QSysInfo::bootUniqueId()
Devuelve un identificador único para el arranque de este equipo, si es posible determinarlo. Si no se ha podido determinar ningún identificador único, esta función devuelve una matriz de bytes vacía. Se espera que este valor cambie tras cada arranque y puede considerarse único a nivel global.
Actualmente, esta función solo está implementada para los sistemas operativos Linux y Apple.
Véase también machineUniqueId().
[static] QString QSysInfo::buildAbi()
Devuelve la cadena completa de arquitectura para la que se compiló Qt. Esta cadena resulta útil para identificar compilaciones diferentes e incompatibles. Por ejemplo, puede utilizarse como identificador para solicitar un paquete de actualización desde un servidor.
Los valores devueltos por esta función se mantienen estables de la siguiente manera: los componentes obligatorios del resultado no cambiarán en futuras versiones de Qt, pero se pueden añadir sufijos opcionales.
El valor devuelto se compone de tres o más partes, separadas por guiones («-»). Son las siguientes:
| Componente | Valor |
|---|---|
| Arquitectura de la CPU | Igual que en QSysInfo::buildCpuArchitecture(), como «arm», «i386», «mips» o «x86_64» |
| Endianidad | «little_endian » o «big_endian » |
| Tamaño de palabra | Si se trata de una aplicación de 32 o 64 bits. Los valores posibles son: «llp64» (Windows de 64 bits), «lp64» (Unix de 64 bits), «ilp32» (32 bits) |
| (Opcional) ABI | Cero o más componentes que identifican las diferentes ABI posibles en esta arquitectura. Actualmente, Qt tiene componentes ABI opcionales para procesadores ARM y MIPS: un componente es la ABI principal (como «eabi», «o32», «n32», «o64»); otro indica si la convención de llamada utiliza registros de coma flotante de hardware (en cuyo caso está presente «hardfloat»). Además, si Qt se ha configurado con |
Véase también QSysInfo::buildCpuArchitecture().
[static] QString QSysInfo::buildCpuArchitecture()
Devuelve la arquitectura de la CPU para la que se compiló Qt, en formato de texto. Ten en cuenta que es posible que esto no coincida con la CPU real en la que se está ejecutando la aplicación si existe una capa de emulación o si la CPU admite múltiples arquitecturas (como los procesadores x86-64 que admiten aplicaciones i386). Para detectarlo, utiliza currentCpuArchitecture().
Los valores devueltos por esta función son estables y no cambiarán con el tiempo, por lo que las aplicaciones pueden basarse en el valor devuelto como identificador, salvo que se añadan nuevos tipos de CPU con el tiempo.
Los valores típicos devueltos son (nota: la lista no es exhaustiva):
- «arm»
- «arm64»
- «i386»
- «ia64»
- «mips»
- «mips64»
- «power»
- «power64»
- «sparc»
- «sparcv9»
- «x86_64»
Véase también QSysInfo::buildAbi() y QSysInfo::currentCpuArchitecture().
[static] QString QSysInfo::currentCpuArchitecture()
Devuelve la arquitectura de la CPU en la que se está ejecutando la aplicación, en formato de texto. Ten en cuenta que esta función depende de la información que facilite el sistema operativo y es posible que no detecte la arquitectura real de la CPU si el sistema operativo oculta esa información o no puede proporcionarla. Por ejemplo, un sistema operativo de 32 bits que se ejecuta en una CPU de 64 bits normalmente no puede determinar si la CPU es realmente capaz de ejecutar programas de 64 bits.
Los valores devueltos por esta función son, en su mayoría, estables: se intentará garantizar que se mantengan constantes a lo largo del tiempo y que coincidan con los valores devueltos por buildCpuArchitecture(). Sin embargo, debido a la naturaleza de las funciones del sistema operativo que se utilizan, puede haber discrepancias.
Los valores devueltos habituales son (nota: la lista no es exhaustiva):
- «arm»
- «arm64»
- «i386»
- «ia64»
- «mips»
- «mips64»
- «power»
- «power64»
- «sparc»
- «sparcv9»
- «x86_64»
Véase también QSysInfo::buildAbi() y QSysInfo::buildCpuArchitecture().
[static] QString QSysInfo::kernelType()
Devuelve el tipo de núcleo del sistema operativo para el que se compiló Qt. También es el núcleo en el que se ejecuta la aplicación, a menos que el sistema operativo anfitrión utilice algún tipo de capa de compatibilidad o virtualización.
Los valores devueltos por esta función son estables y no cambian con el tiempo, por lo que las aplicaciones pueden utilizar el valor devuelto como identificador, salvo en el caso de que se añadan nuevos tipos de núcleo del sistema operativo con el paso del tiempo.
En Windows, esta función devuelve el tipo de núcleo de Windows, como «winnt». En sistemas Unix, devuelve lo mismo que la salida de « uname -s » (en minúsculas).
Nota: Esta función puede devolver valores inesperados: devuelve «linux» para todos los sistemas operativos que ejecutan Linux (incluido Android), «qnx» para todos los sistemas operativos que ejecutan QNX, «freebsd» para Debian/kFreeBSD y «darwin» para macOS e iOS. Para obtener información sobre el tipo de producto en el que se ejecuta la aplicación, consulta productType().
Véase también QFileSelector, kernelVersion(), productType(), productVersion() y prettyProductName().
[static] QString QSysInfo::kernelVersion()
Devuelve la versión del núcleo del sistema operativo. En Windows, devuelve la versión del núcleo NT. En sistemas Unix, incluidos Android y macOS, devuelve lo mismo que devolvería el comando « uname -r ». En VxWorks, devuelve la parte numérica de la cadena que devuelve la función kernelVersion().
Si no se ha podido determinar la versión, esta función puede devolver una cadena vacía.
Véanse también kernelType(), productType(), productVersion() y prettyProductName().
[static] QString QSysInfo::machineHostName()
Devuelve el nombre de host de esta máquina, si se ha configurado alguno. Ten en cuenta que no se garantiza que los nombres de host sean únicos a nivel mundial, especialmente si se han configurado automáticamente.
Esta función no garantiza que el nombre de host devuelto sea un nombre de dominio completo (FQDN). Para ello, utilice QHostInfo para resolver el nombre devuelto a un FQDN.
Esta función devuelve lo mismo que QHostInfo::localHostName().
Véanse también QHostInfo::localDomainName y machineUniqueId().
[static] QByteArray QSysInfo::machineUniqueId()
Devuelve un identificador único para este equipo, si es posible determinarlo. Si no se ha podido determinar ningún identificador único, esta función devuelve una matriz de bytes vacía. A diferencia de ` machineHostName()`, es probable que el valor devuelto por esta función sea único a nivel global.
Un identificador único resulta útil en operaciones de red para identificar este equipo durante un periodo prolongado, cuando la dirección IP podría cambiar o si este equipo pudiera tener más de una dirección IP. Por ejemplo, el identificador podría utilizarse al comunicarse con un servidor o al almacenar datos específicos del dispositivo en un almacenamiento de red compartido.
Tenga en cuenta que, en algunos sistemas, este valor persistirá tras los reinicios y, en otros, no. Las aplicaciones no deben confiar ciegamente en este hecho sin verificar las capacidades del sistema operativo. En concreto, en los sistemas Linux, este identificador suele ser permanente y coincide con el identificador de máquina de D-Bus, salvo en el caso de los nodos que carecen de almacenamiento propio (nodos replicados).
Véase también machineHostName() y bootUniqueId().
[static] QString QSysInfo::prettyProductName()
Devuelve una versión más clara de ` productType()` y ` productVersion()`, que incluye otros datos como el tipo de sistema operativo, nombres en clave y otra información. El resultado de esta función es adecuado para mostrarlo al usuario, pero no para su almacenamiento a largo plazo, ya que la cadena puede cambiar con las actualizaciones de Qt XML.
Si productType() devuelve «unknown», esta función utilizará en su lugar las funciones kernelType() y kernelVersion().
Véanse también kernelType(), kernelVersion(), productType() y productVersion().
[static] QString QSysInfo::productType()
Devuelve el nombre del sistema operativo en el que se está ejecutando esta aplicación. Si la aplicación se está ejecutando en algún tipo de capa de emulación o virtualización (como WINE en un sistema Unix), esta función analizará dicha capa de emulación o virtualización.
Los valores devueltos por esta función son estables y no cambian con el tiempo, por lo que las aplicaciones pueden utilizar el valor devuelto como identificador, salvo que se añadan nuevos tipos de sistemas operativos con el tiempo.
Nota sobre Linux y Android: esta función devuelve «android» para los sistemas Linux que ejecutan el espacio de usuario de Android, especialmente cuando se utiliza la biblioteca Bionic. Para todos los demás sistemas Linux, independientemente de la biblioteca C que se utilice, intenta determinar el nombre de la distribución y devuelve ese nombre. Si no se consigue determinar el nombre de la distribución, devuelve «unknown».
Nota sobre macOS: esta función devuelve «macos» para todos los sistemas macOS, independientemente de la convención de nomenclatura de Apple. Anteriormente, en Qt 5, devolvía «osx», de nuevo independientemente de las convenciones de nomenclatura de Apple.
Nota sobre Darwin, iOS, tvOS y watchOS: esta función devuelve «ios» para los sistemas iOS, «tvos» para los sistemas tvOS, «watchos» para los sistemas watchOS y «darwin» en caso de que no se pueda determinar el sistema.
Nota sobre FreeBSD: esta función devuelve «debian» para Debian/kFreeBSD y «unknown» en los demás casos.
Nota sobre Windows: esta función devuelve «windows».
Nota sobre VxWorks: esta función devuelve «vxworks».
Para otros sistemas de tipo Unix, esta función suele devolver «unknown».
Véase también QFileSelector, kernelType(), kernelVersion(), productVersion() y prettyProductName().
[static] QString QSysInfo::productVersion()
Devuelve la versión del sistema operativo en formato de cadena. Si no se ha podido determinar la versión, esta función devuelve «desconocida».
Devolverá las versiones completas de los productos Android, iOS, macOS, VxWorks y Windows en dichos sistemas.
Los valores típicos devueltos son (nota: la lista no es exhaustiva):
- «12» (Android 12)
- «36» (Fedora 36)
- «15.5» (iOS 15.5)
- «12.4» (macOS Monterey)
- «22.04» (Ubuntu 22.04)
- «8.6» (watchOS 8.6)
- «11» (Windows 11)
- «Server 2022» (Windows Server 2022)
- «24.03» (VxWorks 7 - 24.03)
En sistemas Linux, intentará determinar la versión de la distribución y devolverá esa versión. Esto también se hace en Debian/kFreeBSD, por lo que, en ese caso, esta función devolverá la versión de Debian.
En todos los demás sistemas de tipo Unix, esta función siempre devuelve «desconocido».
Nota: No se garantiza quela cadena de versión devuelta por esta función pueda ordenarse. En Linux, la versión de la distribución puede cambiar de forma inesperada; consulta la documentación de la distribución para conocer las prácticas de numeración de versiones.
Véase también kernelType(), kernelVersion(), productType() y prettyProductName().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.