QNativeIpcKey Class
La clase `QNativeIpcKey` contiene una clave nativa utilizada por ` QSystemSemaphore ` y ` QSharedMemory`. Más información...
| Encabezado: | #include <QNativeIpcKey> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.6 |
Comparaciones de QNativeIpcKey
| Categoría | Tipos comparables |
|---|---|
| igualdad | QNativeIpcKey |
Tipos públicos
| enum class | Type { SystemV, PosixRealtime, Windows } |
Funciones públicas
| QNativeIpcKey() | |
| QNativeIpcKey(QNativeIpcKey::Type type) | |
| QNativeIpcKey(const QString &key, QNativeIpcKey::Type type = DefaultTypeForOs) | |
| QNativeIpcKey(const QNativeIpcKey &other) | |
| QNativeIpcKey(QNativeIpcKey &&other) | |
| ~QNativeIpcKey() | |
| bool | isEmpty() const |
| bool | isValid() const |
| QString | nativeKey() const |
| void | setNativeKey(const QString &newKey) |
| void | setType(QNativeIpcKey::Type type) |
| void | swap(QNativeIpcKey &other) |
| QString | toString() const |
| QNativeIpcKey::Type | type() const |
| QNativeIpcKey & | operator=(QNativeIpcKey &&other) |
| QNativeIpcKey & | operator=(const QNativeIpcKey &other) |
Miembros públicos estáticos
| const QNativeIpcKey::Type | DefaultTypeForOs |
| QNativeIpcKey | fromString(const QString &text) |
| QNativeIpcKey::Type | legacyDefaultTypeForOs() |
Elementos no miembros relacionados
| size_t | qHash(const QNativeIpcKey &key, size_t seed = 0) |
| void | swap(QNativeIpcKey &value1, QNativeIpcKey &value2) |
| bool | operator!=(const QNativeIpcKey &lhs, const QNativeIpcKey &rhs) |
| bool | operator==(const QNativeIpcKey &lhs, const QNativeIpcKey &rhs) |
Descripción detallada
Las clases ` QSharedMemory ` y ` QSystemSemaphore ` identifican sus recursos mediante un identificador válido en todo el sistema conocido como «clave». Tanto el valor de la clave de bajo nivel como el tipo de clave se encapsulan en Qt mediante la clase ` QNativeIpcKey `.
Estas dos clases también proporcionan los medios para crear claves nativas a partir de un identificador multiplataforma, mediante QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey(). Las aplicaciones nunca deben compartir la entrada de estas funciones, ya que las diferentes versiones de Qt pueden realizar transformaciones distintas, lo que daría lugar a claves nativas diferentes. En su lugar, la aplicación que haya creado el objeto IPC debería comunicar la clave nativa resultante mediante los métodos que se describen a continuación.
Para obtener más detalles sobre los tipos de claves, las limitaciones específicas de cada plataforma y la interoperabilidad con aplicaciones más antiguas o que no sean de Qt, consulta la documentación sobre claves IPC nativas. Esta incluye información importante para aplicaciones en entorno aislado en plataformas de Apple, incluidas todas las aplicaciones obtenidas a través de la App Store de Apple.
Comunicación de claves a otros procesos
Comunicación de claves a otros procesos Qt
Si el otro proceso es compatible con `QNativeIpcKey`, la mejor forma de comunicarse es a través de la representación como cadena obtenida con ` toString()` y analizándola mediante ` fromString()`. Esta representación puede almacenarse en un archivo cuyo nombre sea conocido o pasarse en la línea de comandos a un proceso hijo mediante ` QProcess::setArguments()`.
Si el otro proceso no admite QNativeIpcKey, los dos procesos pueden intercambiar el valor de nativeKey(), pero es probable que el código heredado no pueda ajustar su tipo de clave. La función ` legacyDefaultTypeForOs()` devuelve el tipo que utilizaba el código heredado, que puede no coincidir con la constante ` DefaultTypeForOs `. Esto sigue siendo así incluso si la aplicación antigua no utiliza la misma compilación que la nueva (por ejemplo, si se trata de una aplicación de Qt 5), siempre que las opciones pasadas al script de configuración de Qt sean las mismas.
Comunicación de claves a procesos ajenos a Qt
Al comunicarse con procesos que no son de Qt, la aplicación debe asegurarse de obtener el tipo de clave que utiliza el otro proceso. Esto es especialmente importante en sistemas Unix, donde son habituales tanto PosixRealtime como SystemV.
Representación como cadena de las claves nativas
El formato de la representación como cadena de un `QNativeIpcKey` está pensado para ser estable y, por lo tanto, compatible tanto hacia atrás como hacia adelante, siempre que la versión de Qt en cuestión admita el tipo de clave. Es decir, una versión anterior de Qt no podrá analizar la representación como cadena de un tipo de clave introducido después de su lanzamiento. Sin embargo, el hecho de que se analice correctamente una representación como cadena no implica que las clases de Qt puedan crear correctamente un objeto de ese tipo; las aplicaciones deben verificar la compatibilidad mediante QSharedMemory::isKeyTypeSupported() y QSystemSemaphore::isKeyTypeSupported().
El formato de la representación como cadena se compone de dos componentes, separados por dos puntos (':'). El primer componente es el tipo de clave, descrito en la tabla siguiente. El segundo componente es una carga útil específica del tipo, que utiliza percent-encoding. Para todos los tipos de clave actualmente compatibles, la forma decodificada es idéntica al contenido del campo nativeKey().
| Tipo de clave | Representación como cadena |
| PosixRealtime | "posix" |
| SystemV | "systemv" |
| Windows | "windows" |
| No estándar SystemV | "systemv-" seguido de un número decimal |
Este formato se asemeja a un URI y permite su análisis mediante funciones de análisis de URI/URL, como QUrl. Cuando se analiza mediante dicha API, el tipo de clave aparecerá como scheme, y la carga útil será path. El uso de consultas o fragmentos está reservado.
Véase también QSharedMemory y QSystemSemaphore.
Documentación sobre los tipos de miembros
enum class QNativeIpcKey::Type
Esta enumeración describe el tipo de backend del objeto IPC. Para obtener más información sobre los tipos de clave, consulta la documentación sobre claves IPC nativas.
| Constante | Valor | Descripción |
|---|---|---|
QNativeIpcKey::Type::SystemV | 0x51 | API de X/Open System Initiative (XSI) o System V (SVr4) |
QNativeIpcKey::Type::PosixRealtime | 0x100 | API IEEE 1003.1b (POSIX.1b) |
QNativeIpcKey::Type::Windows | 0x101 | API de Win32 |
Documentación de las funciones miembro
[constexpr noexcept default] QNativeIpcKey::QNativeIpcKey()
Crea un objeto `QNativeIpcKey` de tipo ` DefaultTypeForOs ` con una clave vacía.
[explicit constexpr noexcept] QNativeIpcKey::QNativeIpcKey(QNativeIpcKey::Type type)
QNativeIpcKey::QNativeIpcKey(const QString &key, QNativeIpcKey::Type type = DefaultTypeForOs)
Crea un objeto ` QNativeIpcKey ` que contiene una clave nativa ` key ` (o está vacío en la sobrecarga sin parámetro) para el tipo ` type`.
[noexcept] QNativeIpcKey::~QNativeIpcKey()
Elimina este objeto « QNativeIpcKey ».
[static] QNativeIpcKey QNativeIpcKey::fromString(const QString &text)
Analiza la cadena de la forma text y devuelve el objeto QNativeIpcKey correspondiente. Las representaciones en forma de cadena son útiles para informar a otros procesos de la clave que ha creado este proceso y a la que deben asociarse.
Si no se ha podido analizar la cadena, esta función devuelve un objeto ` invalid `.
Véase también toString() y isValid().
[noexcept] bool QNativeIpcKey::isEmpty() const
Devuelve «true» si la función ` nativeKey()` está vacía.
Véase también ` nativeKey()`.
[noexcept] bool QNativeIpcKey::isValid() const
Devuelve «true» si este objeto contiene un tipo de clave IPC nativa válido. Los tipos no válidos suelen deberse a un error al analizar una representación en forma de cadena mediante la función « fromString()».
Esta función no comprueba si la cadena de la clave es realmente compatible o válida para el sistema operativo actual.
Véanse también type() y fromString().
[static noexcept] QNativeIpcKey::Type QNativeIpcKey::legacyDefaultTypeForOs()
Devuelve el objeto ` Type ` que se corresponde con la clave IPC nativa que utilizaban QSharedMemory y QSystemSemaphore antes de Qt 6.6. Las aplicaciones y bibliotecas que deban mantener la compatibilidad con código que utilice cualquiera de estas clases y que se haya compilado con Qt anterior a la versión 6.6 pueden utilizar esta función para determinar qué tipo de IPC pueden estar utilizando las demás aplicaciones.
Ten en cuenta que esta función depende de que Qt se haya compilado con opciones idénticas en el momento de la configuración.
[noexcept] QString QNativeIpcKey::nativeKey() const
Devuelve la cadena de clave nativa asociada a este objeto.
Véase también setNativeKey() y type().
void QNativeIpcKey::setNativeKey(const QString &newKey)
Establece la clave nativa de este objeto en newKey.
Véase también nativeKey() y setType().
[constexpr] void QNativeIpcKey::setType(QNativeIpcKey::Type type)
Establece el tipo de IPC de este objeto en « type ».
Véase también type() y setNativeKey().
[noexcept] void QNativeIpcKey::swap(QNativeIpcKey &other)
Cambia esta clave y este tipo de IPC nativo por other. Esta operación es muy rápida y nunca falla.
QString QNativeIpcKey::toString() const
Devuelve la representación como cadena de este objeto. Las representaciones como cadena son útiles para informar a otros procesos de la clave que ha creado este proceso y a la que deben asociarse.
Esta función devuelve una cadena nula si el objeto actual es invalid.
Véase también fromString().
[constexpr noexcept] QNativeIpcKey::Type QNativeIpcKey::type() const
Devuelve el tipo de clave asociado a este objeto.
Véase también nativeKey() y setType().
[noexcept] QNativeIpcKey &QNativeIpcKey::operator=(QNativeIpcKey &&other)
QNativeIpcKey &QNativeIpcKey::operator=(const QNativeIpcKey &other)
[noexcept] QNativeIpcKey::QNativeIpcKey(QNativeIpcKey &&other)
QNativeIpcKey::QNativeIpcKey(const QNativeIpcKey &other)
Copia o traslada el contenido de « other ».
Documentación sobre variables de miembro
const QNativeIpcKey::Type QNativeIpcKey::DefaultTypeForOs
Esta variable de expresión constante contiene el tipo IPC nativo predeterminado para el sistema operativo actual. Será ` Type::Windows ` para sistemas Windows y ` Type::PosixRealtime ` en el resto de casos. Ten en cuenta que esta constante difiere de los valores predeterminados de ` QSharedMemory ` y ` QSystemSemaphore ` en la mayoría de los sistemas Unix anteriores a Qt 6.6; consulta legacyDefaultTypeForOs() para obtener más información.
Elementos no miembros relacionados
[noexcept] size_t qHash(const QNativeIpcKey &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] void swap(QNativeIpcKey &value1, QNativeIpcKey &value2)
Intercambia la clave y el tipo IPC nativos « value1 » por « value2 ». Esta operación es muy rápida y nunca falla.
[noexcept] bool operator!=(const QNativeIpcKey &lhs, const QNativeIpcKey &rhs)
[noexcept] bool operator==(const QNativeIpcKey &lhs, const QNativeIpcKey &rhs)
Devuelve «true» si los objetos ` lhs ` y ` rhs ` contienen el mismo contenido (o uno diferente).
© 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.