QtTaskTree::Storage Class
template <typename StorageStruct> class QtTaskTree::StorageUna plantilla de clase para el intercambio de datos personalizado en el árbol de tareas en ejecución. Más información...
| Encabezado: | #include <qtasktree.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS TaskTree) target_link_libraries(mytarget PRIVATE Qt6::TaskTree) |
| qmake: | QT += tasktree |
| Desde: | Qt 6.11 |
| Heredado de: | QtTaskTree::StorageBase |
| Estado: | Versión preliminar |
Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| Storage() | |
| Storage(const FirstArg &firstArg, const Args &... args) | |
| StorageStruct * | activeStorage() const |
| StorageStruct & | operator*() const |
| StorageStruct * | operator->() const |
Descripción detallada
La plantilla de clase Storage se encarga de crear y destruir dinámicamente objetos del tipo personalizado « StorageStruct ». La creación y la destrucción las gestiona el árbol de tareas en ejecución. Si se coloca un objeto Storage dentro de un elemento « Group », el árbol de tareas en ejecución crea el objeto « StorageStruct » cuando se inicia el grupo y antes de que se llame al controlador de configuración del grupo. Posteriormente, cada vez que se invoque a cualquier controlador dentro de este grupo, el árbol de tareas activa la instancia del objeto StorageStruct creada previamente. Esto incluye todos los controladores de configuración y finalización de tareas y grupos dentro del grupo en el que se colocó el objeto Storage, así como dentro de los grupos anidados. Cuando se pasa una copia del objeto `Storage` al manejador mediante la captura lambda, el manejador puede acceder a la instancia activada por el árbol de tareas en ejecución mediante los métodos ` Storage::operator->()`, ` Storage::operator*()` o ` activeStorage()`. Si dos manejadores capturan el mismo objeto `Storage`, uno de ellos puede almacenar allí datos personalizados y el otro puede leerlos posteriormente. Cuando el grupo finaliza, la instancia del objeto ` StorageStruct ` creada previamente se destruye tras la llamada al controlador `done` del grupo.
Un ejemplo de intercambio de datos entre tareas:
const Storage<QString> storage;
const auto onFirstDone = [storage](const FirstWorker &task) {
// Assings QString, taken from the first task result, to the active QString instance
// of the Storage object.
*storage = task.getResultAsString();
};
const auto onSecondSetup = [storage](SecondWorker &task) {
// Reads QString from the active QString instance of the Storage object and use it to
// configure the second task before start.
task.configureWithString(*storage);
};
const Group root {
// The running task tree creates QString instance when root in entered
storage,
// The done handler of the first task stores the QString in the storage
FirstWorkerTask(..., onFirstDone),
// The setup handler of the second task reads the QString from the storage
SecondWorkerTask(onSecondSetup, ...)
};Dado que el grupo raíz ejecuta sus tareas de forma secuencial, el controlador « onFirstDone » siempre se llama antes que el controlador « onSecondSetup ». Esto significa que los datos de « QString », leídos de « storage » dentro del cuerpo del controlador « onSecondSetup », ya han sido establecidos por el controlador « onFirstDone ». Siempre puedes confiar en ello en el modo de ejecución « sequential ».
Los componentes internos de Storage se comparten entre todas sus copias. Por eso, las copias del objeto Storage dentro de las capturas lambda de los controladores siguen haciendo referencia a la misma instancia de Storage. Puedes colocar varios objetos Storage dentro de un elemento Group, siempre que no incluyan copias del mismo objeto Storage. De lo contrario, se activará una comprobación (assert) en tiempo de ejecución que incluirá un mensaje de error. Sin embargo, puedes colocar copias del mismo objeto `Storage` en diferentes elementos ` Group ` de la misma receta. En este caso, el árbol de tareas en ejecución creará varias instancias de los objetos ` StorageStruct ` (una por cada copia) y se producirá el «sombreado de almacenamiento». El sombreado de almacenamiento funciona de manera similar al sombreado de variables en C++ dentro de los bloques de código anidados:
Storage<QString> storage;
const Group root {
storage, // Top copy, 1st instance of StorageStruct
onGroupSetup([storage] { ... }), // Top copy is active
Group {
storage, // Nested copy, 2nd instance of StorageStruct,
// shadows Top copy
onGroupSetup([storage] { ... }) // Nested copy is active
},
Group {
onGroupSetup([storage] { ... }) // Top copy is active
}
};Los objetos «Storage» también pueden utilizarse para pasar los datos iniciales al árbol de tareas ejecutado y para leer los datos finales del árbol de tareas antes de que este finalice. Para ello, utiliza « onStorageSetup()» o « onStorageDone()», respectivamente.
Nota: Si utilizas un objeto Storage inaccesible dentro del controlador, ya sea porque te has olvidado de incluir el almacenamiento en la receta o porque lo has incluido, pero no en ningún grupo antecesor del controlador, es probable que se produzca un fallo, precedido por el siguiente mensaje: «El almacenamiento al que se hace referencia no es accesible en el árbol en ejecución». Se devolverá un nullptr, lo que podría provocar un fallo en el código que realiza la llamada. Es posible que no se haya añadido ningún almacenamiento al árbol o que no se pueda acceder al almacenamiento desde el lugar donde se hace referencia a él.
Documentación de las funciones miembro
Storage::Storage()
Crea un objeto «Storage» para el tipo « StorageStruct » especificado. Cada vez que el objeto « QTaskTree » en ejecución entra en un « Group » en el que se encuentra dicho «Storage», crea el objeto « StorageStruct » utilizando el constructor por defecto.
Nota: Todas las copias del objeto ` this ` se consideran la misma instancia de `Storage`.
[explicit] template <
typename FirstArg,
typename... Args,
std::enable_if_t<!std::is_same_v<q20::remove_cvref_t<FirstArg>, Storage<StorageStruct>>, bool> = true
>
Storage::Storage(const FirstArg &firstArg, const Args &... args)
Crea un almacenamiento para el tipo « StorageStruct » indicado. Los valores « firstArg » y « args » pasados se almacenan al crear el almacenamiento y son utilizados posteriormente por el « QTaskTree » en ejecución para construir el « StorageStruct » con el « args » almacenado.
Nota: Todas las copias de un objeto this se consideran la misma instancia de Storage.
StorageStruct *Storage::activeStorage() const
Devuelve un puntero al objeto « StorageStruct » activo, creado por el árbol de tareas en ejecución. Utiliza esta función únicamente desde el interior del cuerpo del controlador de cualquier elemento « GroupItem » incluido en la receta; de lo contrario, podría producirse un fallo del sistema. Asegúrate de que «Storage» se encuentre en cualquier grupo antecesor del elemento de grupo del controlador.
Nota: El puntero devuelto es válido mientras el grupo que creó esta instancia siga en ejecución.
Véase también operator->() y operator*().
[noexcept] StorageStruct &Storage::operator*() const
Devuelve una referencia al objeto « StorageStruct » activo, creado por el árbol de tareas en ejecución. Utiliza esta función únicamente desde el interior del cuerpo del controlador de cualquier elemento « GroupItem » incluido en la receta; de lo contrario, podría producirse un fallo del sistema. Asegúrate de que «Storage» se encuentre en cualquier grupo antecesor del elemento de grupo del controlador.
Nota: La referencia devuelta es válida mientras el grupo que creó esta instancia siga en ejecución.
Véase también activeStorage() y operator->().
[noexcept] StorageStruct *Storage::operator->() const
Devuelve un puntero al objeto « StorageStruct » activo, creado por el árbol de tareas en ejecución. Utiliza esta función únicamente desde el interior del cuerpo del controlador de cualquier elemento « GroupItem » incluido en la receta; de lo contrario, podría producirse un fallo del sistema. Asegúrate de que «Storage» se encuentre en cualquier grupo antecesor del elemento de grupo del controlador.
Nota: El puntero devuelto es válido mientras el grupo que creó esta instancia siga en ejecución.
Véase también activeStorage() y operator*().
© 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.