QProcessEnvironment Class
La clase QProcessEnvironment contiene las variables de entorno que se pueden pasar a un programa. Más información...
| Encabezado: | #include <QProcessEnvironment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QProcessEnvironment forma parte de las clases de entrada/salida y redes, y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QProcessEnvironment
| Categoría | Tipos comparables |
|---|---|
| igualdad | QProcessEnvironment |
Tipos públicos
(since 6.3) enum | Initialization { InheritFromParent } |
Funciones públicas
| QProcessEnvironment() | |
(since 6.3) | QProcessEnvironment(QProcessEnvironment::Initialization) |
| QProcessEnvironment(const QProcessEnvironment &other) | |
| ~QProcessEnvironment() | |
| void | clear() |
| bool | contains(const QString &name) const |
(since 6.3) bool | inheritsFromParent() const |
| void | insert(const QString &name, const QString &value) |
| void | insert(const QProcessEnvironment &e) |
| bool | isEmpty() const |
| QStringList | keys() const |
| void | remove(const QString &name) |
| void | swap(QProcessEnvironment &other) |
| QStringList | toStringList() const |
| QString | value(const QString &name, const QString &defaultValue = QString()) const |
| QProcessEnvironment & | operator=(const QProcessEnvironment &other) |
Miembros públicos estáticos
| QProcessEnvironment | systemEnvironment() |
Elementos no miembros relacionados
| bool | operator!=(const QProcessEnvironment &lhs, const QProcessEnvironment &rhs) |
| bool | operator==(const QProcessEnvironment &lhs, const QProcessEnvironment &rhs) |
Descripción detallada
El entorno de un proceso se compone de un conjunto de pares clave=valor conocidos como variables de entorno. La clase `QProcessEnvironment` engloba ese concepto y permite manipular fácilmente dichas variables. Está pensada para utilizarse junto con ` QProcess`, con el fin de configurar el entorno de los procesos hijos. No se puede utilizar para modificar el entorno del proceso actual.
El entorno del proceso que realiza la llamada se puede obtener utilizando ` QProcessEnvironment::systemEnvironment()`.
En sistemas Unix, los nombres de las variables distinguen entre mayúsculas y minúsculas. Ten en cuenta que el entorno Unix permite que tanto los nombres como los contenidos de las variables contengan datos binarios arbitrarios (excepto el carácter NUL). QProcessEnvironment conservará dichas variables, pero no admite la manipulación de variables cuyos nombres o valores no puedan codificarse según la configuración regional actual (véase QString::toLocal8Bit).
En Windows, los nombres de las variables no distinguen entre mayúsculas y minúsculas, pero conservan el uso de mayúsculas y minúsculas. QProcessEnvironment se comporta en consecuencia.
Consideraciones de seguridad
Ampliar el entorno de un proceso con nuevas variables de entorno o modificar PATH puede exponer el sistema a vulnerabilidades de seguridad, por ejemplo, mediante la ejecución de un binario no fiable. Por lo tanto, se recomienda validar todas las entradas del usuario antes de pasarlas al entorno del proceso.
Véase también QProcess, QProcess::systemEnvironment() y QProcess::setProcessEnvironment().
Documentación sobre tipos de miembros
[since 6.3] enum QProcessEnvironment::Initialization
Esta enumeración contiene un token que se utiliza para resolver ambigüedades en los constructores.
| Constante | Valor | Descripción |
|---|---|---|
QProcessEnvironment::InheritFromParent | 0 | Se creará un ` QProcessEnvironment ` que, al establecerse en un ` QProcess`, hará que este herede las variables de su padre. |
Esta enumeración se introdujo en Qt 6.3.
Documentación de las funciones miembro
QProcessEnvironment::QProcessEnvironment()
Crea un nuevo objeto `QProcessEnvironment`. Este constructor crea un entorno vacío. Si se aplica a un ` QProcess`, esto provocará que se eliminen las variables de entorno actuales (excepto `PATH` y `SystemRoot` en Windows).
[noexcept, since 6.3] QProcessEnvironment::QProcessEnvironment(QProcessEnvironment::Initialization)
Crea un objeto que, al asignarse a QProcess, hará que este se ejecute con las variables de entorno heredadas de su proceso padre.
Nota: El objeto creado no almacena por sí mismo ninguna variable de entorno, sino que simplemente indica a QProcess que se encargue de heredar el entorno en el momento en que se inicie el nuevo proceso. Añadir cualquier variable de entorno al objeto creado desactivará la herencia del entorno y dará lugar a un entorno que contenga únicamente las variables de entorno añadidas.
Si se desea una versión modificada del entorno padre, comience con el valor de retorno de ` systemEnvironment() ` y modifíquelo (pero tenga en cuenta que los cambios en el entorno del proceso padre realizados después de su creación no se reflejarán en el entorno modificado).
Esta función se introdujo en Qt 6.3.
Véanse también ` inheritsFromParent()` y ` systemEnvironment()`.
QProcessEnvironment::QProcessEnvironment(const QProcessEnvironment &other)
Crea un objeto `QProcessEnvironment` que es una copia de ` other`.
[noexcept] QProcessEnvironment::~QProcessEnvironment()
Libera los recursos asociados a este objeto ` QProcessEnvironment `.
void QProcessEnvironment::clear()
Elimina todos los pares clave=valor de este objeto ` QProcessEnvironment `, dejándolo vacío.
Si el entorno se ha creado mediante ` QProcessEnvironment::InheritFromParent `, permanece sin cambios.
Véase también ` isEmpty()` y ` systemEnvironment()`.
bool QProcessEnvironment::contains(const QString &name) const
Devuelve ` true ` si se encuentra la variable de entorno con el nombre ` name ` en este objeto ` QProcessEnvironment `.
Véase también insert() y value().
[since 6.3] bool QProcessEnvironment::inheritsFromParent() const
Devuelve ` true ` si este ` QProcessEnvironment ` se ha creado utilizando ` QProcessEnvironment::InheritFromParent`.
Esta función se introdujo en Qt 6.3.
Véase también isEmpty().
void QProcessEnvironment::insert(const QString &name, const QString &value)
Inserta la variable de entorno con el nombre « name » y el contenido « value » en este objeto « QProcessEnvironment ». Si dicha variable ya existía, se sustituye por el nuevo valor.
En la mayoría de los sistemas, insertar una variable sin contenido tendrá el mismo efecto para las aplicaciones que si la variable no se hubiera establecido en absoluto. Sin embargo, para garantizar que no haya incompatibilidades, para eliminar una variable, utiliza la función remove().
Véase también contains(), remove() y value().
void QProcessEnvironment::insert(const QProcessEnvironment &e)
Inserta el contenido de e en este objeto QProcessEnvironment. Las variables de este objeto que también existan en e se sobrescribirán.
Esta es una función sobrecargada.
bool QProcessEnvironment::isEmpty() const
Devuelve ` true ` si este objeto ` QProcessEnvironment ` está vacío, es decir, si no hay ningún par clave=valor establecido.
Este método también devuelve ` true ` para los objetos que se hayan creado mediante ` QProcessEnvironment::InheritFromParent`.
Véase también clear(), systemEnvironment(), insert() y inheritsFromParent().
QStringList QProcessEnvironment::keys() const
Devuelve una lista que contiene todos los nombres de variables de este objeto ` QProcessEnvironment `.
La lista devuelta está vacía en el caso de los objetos creados mediante ` QProcessEnvironment::InheritFromParent`.
void QProcessEnvironment::remove(const QString &name)
Elimina la variable de entorno identificada por name de este objeto QProcessEnvironment. Si dicha variable no existía previamente, no ocurre nada.
Véase también contains(), insert() y value().
[noexcept] void QProcessEnvironment::swap(QProcessEnvironment &other)
Cambia esta instancia del entorno de proceso por other. Esta operación es muy rápida y nunca falla.
[static] QProcessEnvironment QProcessEnvironment::systemEnvironment()
La función `systemEnvironment` devuelve el entorno del proceso que la invoca.
Se devuelve como un ` QProcessEnvironment`. Esta función no almacena en caché el entorno del sistema. Por lo tanto, es posible obtener una versión actualizada del entorno si se han llamado funciones de biblioteca C de bajo nivel como ` setenv ` o ` putenv `.
Sin embargo, hay que tener en cuenta que las llamadas repetidas a esta función volverán a crear el objeto ` QProcessEnvironment `, lo cual es una operación que no carece de importancia.
Véase también QProcess::systemEnvironment().
QStringList QProcessEnvironment::toStringList() const
Convierte este objeto ` QProcessEnvironment ` en una lista de cadenas, una por cada variable de entorno que esté definida. El nombre de la variable de entorno y su valor están separados por el carácter de igualdad («=»).
El contenido de ` QStringList ` devuelto por esta función es adecuado para su visualización. No se recomienda su uso junto con la función `QProcess::setEnvironment` debido a posibles problemas de codificación en Unix y a un peor rendimiento.
Véase también systemEnvironment(), QProcess::systemEnvironment() y QProcess::setProcessEnvironment().
QString QProcessEnvironment::value(const QString &name, const QString &defaultValue = QString()) const
Busca en este objeto QProcessEnvironment una variable identificada por name y devuelve su valor. Si no se encuentra la variable en este objeto, se devuelve en su lugar defaultValue.
Véase también contains(), insert() y remove().
QProcessEnvironment &QProcessEnvironment::operator=(const QProcessEnvironment &other)
Copia el contenido del objeto other QProcessEnvironment en este.
Elementos no miembros relacionados
[noexcept] bool operator!=(const QProcessEnvironment &lhs, const QProcessEnvironment &rhs)
Devuelve « true » si los objetos del entorno del proceso « lhs » y « rhs » son diferentes.
Véase también operator==().
[noexcept] bool operator==(const QProcessEnvironment &lhs, const QProcessEnvironment &rhs)
Devuelve ` true ` si los objetos del entorno del proceso ` lhs ` y ` rhs ` son iguales.
Se considera que dos objetos ` QProcessEnvironment ` son iguales si tienen el mismo conjunto de pares clave=valor. La comparación de las claves se realiza distinguiendo entre mayúsculas y minúsculas en aquellas plataformas en las que el entorno distingue entre mayúsculas y minúsculas.
Véase también operator!=() y contains().
© 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.