|
|
|
|
|
|
|
|
- Déclaration
- Propriétés spécifiques à la description des variables de type TâcheParallèle
- Fonctions WLangage utilisant des variables de type TâcheParallèle
TâcheParallèle (Type de variable) En anglais : ParallelTask
Le type TâcheParallèle permet de manipuler une tâche, c'est-à-dire une procédure exécutée par un thread dans le cadre de la programmation parallèle. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
// Déclare une variable pour manipuler une tâche parallèle
t est une TâcheParallèle
// Construit une tâche parallèle et déclenche son exécution sur une procédure
t = TâcheParallèleExécute(Proc, ("Premier paramètre", 2))
// Construit une tâche parallèle
t est une TâcheParallèle(Proc, ("Premier paramètre", 2))
// Déclenche l'exécution de la tâche parallèle
TâcheParallèleExécute(t)
// Décrit une tâche parallèle
d est une Description de TâcheParallèle
d.Procédure = Proc
d.Paramètre[1] = "Premier paramètre"
d.Paramètre[2] = 2
// Construit une tâche parallèle et déclenche son exécution
t est une TâcheParallèle = TâcheParallèleExécute(d)
Dans ce cas, la tâche n'est pas décrite. La variable devra être affectée avec une tâche existante ou avec le résultat d'une des fonctions d'exécution des tâches parallèles.
Décrire une tâche parallèle via le type TâcheParallèle Masquer les détails
MaVariable est une TâcheParallèle(<Procédure> [, <Paramètres> [, <Options>]])
<Procédure> : Chaîne de caractères ou variable de type Procédure Procédure à exécuter. Ce paramètre peut correspondre : - au nom de la procédure à exécuter.
- au nom de la variable de type Procédure correspondant à la procédure à exécuter.
<Paramètres> : Liste de valeurs entre parenthèses et séparées par des virgules Paramètres de la procédure à exécuter. Cette liste de paramètres est de la forme :
(<Paramètre 1>, ..., <Paramètre N>)
où : - <Paramètre 1> : Premier paramètre de la procédure.
- ...
- <Paramètre N> : Nième paramètre de la procédure.
<Options> : Constante optionnelle de type Entier Options de la tâche à exécuter : | | | tpoCopieComplèteContexteHFSQL | Provoque la copie immédiate du contexte HFSQL courant.
Conseillé par exemple si la tâche parallèle doit tenir compte des positions en cours dans les fichiers et requêtes du contexte de l'appelant. | tpoCopieDifféréeContexteHFSQL
(Valeur par défaut) | Provoque une copie légère du contexte HFSQL lors du premier accès aux données HFSQL. | | tpoCopieLégèreContexteHFSQL | Provoque la copie immédiate d'une partie du contexte HFSQL courant.
Seuls les répertoires où se trouvent les fichiers de données en HFSQL Classic et/ou les connexions en HFSQL Client/Serveur sont mémorisés. | | tpoThreadPrincipal | Exécute la tâche dans le thread principal.
Attention : Cette constante ne peut pas être utilisée pour exécuter une tâche parallèle dans le thread principal depuis le thread principal. |
Dans ce cas, la tâche est décrite et sa description ne peut plus être modifiée. La tâche n'est pas planifiée automatiquement, une déclaration seule ne provoquera donc pas l'exécution de la tâche. Il faut appeler une des fonctions d'exécution des tâches pour déclencher l'exécution de la tâche.
Décrire une tâche parallèle via une Description de TâcheParallèle Masquer les détails
MaVariable est une TâcheParallèle(<Description>)
<Description> : Variable de type Description de TâcheParallèle Nom de la variable de type Description de TâcheParallèle décrivant la tâche. Dans ce cas, la tâche est décrite et sa description ne peut plus être modifiée. La tâche n'est pas planifiée automatiquement, une déclaration seule ne provoquera donc pas l'exécution de la tâche. Il faut appeler une des fonctions d'exécution des tâches pour déclencher l'exécution de la tâche. Remarques Propriétés spécifiques à la description des variables de type TâcheParallèle Les propriétés suivantes peuvent être utilisées pour manipuler une tâche parallèle :
| | | | Nom de la propriété | Type manipulé | Effet |
|---|
| Annulée | Booléen | - Vrai si la tâche est annulée,
- Faux dans le cas contraire.
Cette propriété est disponible en lecture seulement. | | Etat | Constante de type Entier | Etat de la tâche : - tpeAnnulée : la tâche parallèle est annulée (fonction TâcheParallèleAnnule).
- tpeAnnulationDemandée : une demande d'annulation a été faite sur la tâche parallèle (fonction TâcheParallèleDemandeAnnulation).
- tpeAttenteExécution : la tâche parallèle est en attente d'exécution.
- tpeAttentePrécédente : la tâche parallèle attend l'exécution d'une tâche parallèle précédente.
- tpeExécutionEnCours : la tâche parallèle est en cours d'exécution.
- tpeNonPlanifiée : la tâche parallèle n'est pas planifiée.
- tpeTerminée : la tâche parallèle est terminée.
Cette propriété est disponible en lecture seulement. | | Identifiant | Entier | Identifiant de tâche. Cet identifiant peut être utilisé par exemple à des fins de débogage. Cette propriété est disponible en lecture seulement. | | Terminée | Booléen | - Vrai si la tâche est terminée,
- Faux dans le cas contraire.
Cette propriété est disponible en lecture seulement. | | ValeurRenvoyée | Valeur renvoyée par la tâche. | Attention : - Si la tâche est toujours en cours, la propriété ValeurRenvoyée attend la fin de la tâche.
- Si la tâche est terminée sans erreur fatale, la propriété renvoie la ou les valeurs de retour de la procédure de la tâche.
Cette propriété est disponible en lecture seulement. |
Fonctions WLangage utilisant des variables de type TâcheParallèle - Fonctions classiques :
- Fonctions proposant une syntaxe préfixée :
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|