QtTaskTree::ExecutableItem Class

Documentation des fonctions membres

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

Renvoie une copie de this ExecutableItem couplée à un émetteur de signaux. L'objet getter transmis est une fonction renvoyant un objet ObjectSignal qui décrit l'émetteur et son signal en attente. Utilisez makeObjectSignal() à l'intérieur de getter pour créer un objet ObjectSignal.

Lorsque this ExecutableItem se termine par une erreur, le Group renvoyé se termine immédiatement par une erreur, sans attendre le signal de l'attendeur.

Lorsque this ExecutableItem se termine avec succès, l'objet Group renvoyé ne se termine pas immédiatement mais attend que le signal d'attente soit envoyé. Après l'envoi du signal d'attente, le retour de Group se termine avec succès. Si le signal d'attente est envoyé avant que this ExecutableItem ne se termine, la phase d'attente est ignorée et Group se termine de manière synchrone.

La connexion au signal d'attente est établie lorsque this ExecutableItem est sur le point d'être lancé. Si le signal d'attente a été déclenché avant, on ne le remarquera pas après le démarrage de this ExecutableItem .

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

Rend une copie de this ExecutableItem annulable. L'objet getter transmis est une fonction renvoyant un objet ObjectSignal qui décrit l'émetteur et son signal d'annulation. Utilisez makeObjectSignal() à l'intérieur de getter pour créer un objet ObjectSignal. Lorsque le signal d'annulation est émis, this ExecutableItem est annulé, postCancelRecipe est exécuté et le groupe retourné se termine par une erreur.

Lorsque this ExecutableItem se termine avant l'émission du signal d'annulation, le groupe renvoyé se termine immédiatement avec le même résultat que this ExecutableItem . Dans ce cas, l'adresse postCancelRecipe, fournie à titre facultatif, est ignorée.

La connexion au signal d'annulation est établie lorsque this ExecutableItem est sur le point d'être lancé. Si le signal d'annulation a été déclenché auparavant, il ne sera pas remarqué après le démarrage de this ExecutableItem .

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

Attache une impression de débogage personnalisée à une copie de this ExecutableItem , émise au démarrage de la tâche et une fois la tâche terminée, et renvoie l'élément couplé.

L'impression de débogage comprend un horodatage de l'événement (début ou fin) et logName pour identifier la tâche spécifique dans le journal de débogage.

La sortie imprimée de fin contient des informations supplémentaires, à savoir si l'exécution était synchrone ou asynchrone, son résultat (la valeur décrite par l'enum DoneWith ) et la durée totale de l'exécution en millisecondes.

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

Attache QTimeoutTask à une copie de this ExecutableItem , s'écoulant après timeout en millisecondes, avec un délai facultatif handler, et renvoie l'élément couplé.

Lorsque ExecutableItem se termine avant que timeout ne passe, l'élément renvoyé se termine immédiatement avec le résultat de la tâche. Dans le cas contraire, handler est invoqué (s'il est fourni), la tâche est annulée et l'élément retourné se termine par une erreur.