QtTaskTree::ExecutableItem Class

Documentation des fonctions membres

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

Renvoie une copie de this ExecutableItem associée à un observateur de signal. La fonction getter passée est une fonction renvoyant un ObjectSignal qui décrit l'émetteur et le signal qu'il attend. Utilisez makeObjectSignal() à l'intérieur de getter pour créer un objet ObjectSignal.

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

Lorsque this ExecutableItem se termine avec succès, l'Group renvoyé ne se termine pas immédiatement, mais attend que le signal d'attente soit envoyé. Une fois le signal d'attente envoyé, l'Group renvoyé 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 l'Group renvoyé se termine de manière synchrone.

La connexion au signal de l'attendant est établie lorsque this ExecutableItem est sur le point de démarrer. Si le signal d'attente a été déclenché auparavant, cela ne sera pas pris en compte une fois que this ExecutableItem aura démarré.

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

Rend annulable une copie de this ExecutableItem . La fonction getter passée est une fonction renvoyant un 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é, un postCancelRecipe fourni de manière facultative est exécuté, et le Group renvoyé se termine par une erreur.

Lorsque this ExecutableItem s’achève avant l’émission du signal d’annulation, le Group renvoyé se termine immédiatement avec le même résultat que celui obtenu par this ExecutableItem . Dans ce cas, la fonction postCancelRecipe, fournie en option, 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, cela ne sera pas pris en compte une fois que this ExecutableItem aura été lancé.

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

Ajoute un message de débogage personnalisé à une copie de this ExecutableItem , générée au démarrage de la tâche et à la fin de celle-ci, puis renvoie l'élément associé.

Le message de débogage comprend un horodatage de l’événement (début ou fin) ainsi que l’ logName permettant d’identifier la tâche spécifique dans le journal de débogage.

Le message de fin contient des informations supplémentaires indiquant si l’exécution était synchrone ou asynchrone, son résultat (la valeur décrite par l’énumération DoneWith ) et la durée totale d’exécution en millisecondes.

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

Associe l'QTimeoutTask à une copie de l'this ExecutableItem , qui expire après timeout en millisecondes, avec un délai d'expiration fourni de manière facultative handler, et renvoie l'élément couplé.

Lorsque l’ ExecutableItem se termine avant l’expiration de timeout, l’élément renvoyé se termine immédiatement avec le résultat de la tâche. Sinon, handler est appelé (s’il est fourni), la tâche est annulée et l’élément renvoyé se termine avec une erreur.