Description
La fonction Choose renvoie le choix de la liste qui correspond à la valeur de l'argument "index".
Arguments
"index" est un nombre ou une expression numérique qui indique l'index du choix. Sa valeur doit être comprise entre 1 et le nombre de choix disponibles. Si elle est hors limite, Choose renvoie une valeur par défaut. (Cette valeur dépend du type de choix. Par exemple, si les choix sont de type nombre, la valeur par défaut est 0 ; si les choix sont de type chaîne, la valeur par défaut est la chaîne vide ("")).
"choix" correspond aux valeurs de choix disponibles. Tous les choix doivent être du même type. Un choix peut être de type "simple" (Nombre, Devise, Chaîne, Booléen, Date, Heure ou Date/heure) ou de type "plage" (plage de nombres, plage de devises, plage de chaînes, plage de dates, plage d'heures ou plage de valeurs de type date/heure), mais non un tableau.
Résultat
Valeur provenant de la liste de choix fournie. Le type de la valeur renvoyée est le même que le type des choix.
Action
La fonction Choose renvoie le choix de la liste qui correspond à la valeur de l'argument "index". Par exemple, si "index" a la valeur 1, la fonction renvoie "choix1" ; si "index" a la valeur 2, la fonction renvoie "choix2", etc.
Exemple d'utilisation
Dans certains cas, la fonction Choose peut être utilisée à la place des opérateurs If-Then-Else ou des structures de contrôle Select. Par exemple, si vous mappez une valeur d'index avec une valeur de chaîne, il peut être plus simple d'utiliser Choose.
La fonction Choose peut également être préférable à une structure de commande lors de la création de formules de sélection d'enregistrements pour qu'elles puissent être empilées sur le serveur de la base de données.
Pour obtenir une explication des techniques en question, voir "Utilisation de formules améliorées de sélection d'enregistrements" dans le chapitre Conception de rapports Web optimisés du Guide de l'utilisateur de Crystal Reports.
Exemples
Choose (3, "Poor", "Fair", "Good", "Excellent")
Renvoie la chaîne "Bon".
Choose (2, 10 To 20, 100 To 200, 60 To 70)
Renvoie la valeur de plage de nombres "100 à 200".
L'exercice financier d'une société commence le 1er juillet (début du troisième trimestre civil), et son service commercial souhaite faire apparaître sur chaque commande l'indication du trimestre financier en cours.
Choose (DatePart ("q", {Orders.Order Date}),
"third fiscal quarter", "fourth fiscal quarter",
"first fiscal quarter", "second fiscal quarter")Par exemple, si {Commandes.Date de commande} a la valeur du 18 février 1996, l'appel de fonction DatePart renvoie la valeur 1 puisque cette date se situe dans le premier trimestre civil. Autrement dit, la formule renvoie le choix occupant la position 1, soit la chaîne "troisième trimestre financier".
Commentaires
Chaque argument de la fonction Choose est évalué avant que le choix ne soit renvoyé. Par conséquent, il est conseillé d'être prudent lors de l'utilisation de la fonction Choose. Exemple : si l'une des valeurs de choix implique une division par zéro, une erreur sera générée même si ce choix n'est pas celui qui est renvoyé par la fonction.