QtTaskTree::ExecutableItem Class

Documentación de las funciones miembro

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withAccept(ObjectSignalGetter &&getter) const

Devuelve una copia de this ExecutableItem acoplada a una señal de espera. El getter pasado es una función que devuelve un ObjectSignal que describe el emisor y su señal de espera. Utilice makeObjectSignal() dentro de getter para crear un objeto ObjectSignal.

Cuando this ExecutableItem termina con un error, el Group devuelto termina inmediatamente con un error, sin esperar la señal del awaiter.

Cuando this ExecutableItem finaliza con éxito, el objeto devuelto Group no finaliza inmediatamente, sino que espera a que se envíe la señal de espera. Una vez enviada la señal de espera, el Group devuelto finaliza con éxito. Si la señal de espera se envía antes de que this ExecutableItem finalice, la fase de espera se omite y el Group devuelto finaliza de forma sincrónica.

La conexión con la señal de espera se establece cuando this ExecutableItem está a punto de iniciarse. Si la señal de espera se lanzó antes, esto no se notará después de que se inicie this ExecutableItem .

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withCancel(ObjectSignalGetter &&getter, std::initializer_list<QtTaskTree::GroupItem> postCancelRecipe = {}) const

Hace cancelable una copia de this ExecutableItem . El getter pasado es una función que devuelve un ObjectSignal que describe el emisor y su señal de cancelación. Utiliza makeObjectSignal() dentro de getter para crear un objeto ObjectSignal. Cuando se emite la señal de cancelación, this ExecutableItem se cancela, se ejecuta un postCancelRecipe proporcionado opcionalmente, y el grupo devuelto finaliza con un error.

Si this ExecutableItem finaliza antes de que se emita la señal de cancelación, el grupo devuelto finaliza inmediatamente con el mismo resultado que this ExecutableItem . En este caso, se omite la opción postCancelRecipe.

La conexión con la señal de cancelación se establece cuando this ExecutableItem está a punto de iniciarse. Si la señal de cancelación se activó antes, esto no se notará después de que se inicie this ExecutableItem .

QtTaskTree::Group ExecutableItem::withLog(const QString &logName) const

Adjunta una impresión de depuración personalizada a una copia de this ExecutableItem , emitida al inicio de la tarea y una vez finalizada, y devuelve el elemento acoplado.

La impresión de depuración incluye una marca de tiempo del evento (inicio o fin) y logName para identificar la tarea específica en el registro de depuración.

La impresión de fin contiene la información adicional de si la ejecución fue síncrona o asíncrona, su resultado (el valor descrito por el enum DoneWith ), y el tiempo total de ejecución en milisegundos.

QtTaskTree::Group ExecutableItem::withTimeout(std::chrono::milliseconds timeout, const std::function<void ()> &handler = {}) const

Adjunta QTimeoutTask a una copia de this ExecutableItem , transcurre después de timeout en milisegundos, con un tiempo de espera opcionalmente proporcionado handler, y devuelve el elemento acoplado.

Cuando ExecutableItem termina antes de que pase timeout, el elemento devuelto termina inmediatamente con el resultado de la tarea. De lo contrario, se invoca handler (si se proporciona), se cancela la tarea y el elemento devuelto finaliza con un error.