Expr

From Base de connaissances eggdrops & TCL
Jump to: navigation, search

expr - Evalue une expression

Syntaxe

expr arg ?arg arg ...?

Description

Concatène arg's (en y ajoutant des séparateurs espaces), évalue le résultat comme expression Tcl, et retourne la valeur. Les opérateurs autorisés dans les expressions Tcl sont un sous ensemble des opérateurs autorisés dans les expressions C, et ils ont les même sens et précédence que les opérateurs C correspondants. Les expressions donnent presque toujours des résultats numériques (entier ou valeurs flottantes). Par exemple,

l'expression
expr 8.2 + 6

Opérandes

Une expression Tcl consiste en une combinaison d'opérandes, d'opérateurs, et de parenthèses. L'espace peut être employé entre les opérandes, opérateurs et parenthèses; il est ignoré par les instructions d'expression. Si possible, les opérandes sont interprétés comme des valeurs entières. Les valeurs entières peuvent être spécifiées en décimal (le cas normal), en octal (si le premier caractère de l'opérande est 0), ou en hexadécimal (si les deux premiers caractères de l'opérande sont 0x). Si un opérande n'est pas un des formats entiers donnés plus haut, alors il est traité comme un nombre flottant si c'est possible. Les nombres flottants peuvent être spécifiés de toutes les manières acceptées par un compilateur compatible ANSI-C (excepté que les suffixes f, F, l, et L ne seront pas autorisés dans la plupart des installations). Par exemple, tous les nombres flottants suivants sont valides : 2.1, 3., 6e4, 7.91e+16. Si aucune interprétation numérique n'est possible, alors un opérande est considéré comme une chaîne (et seulement un ensemble limité d'opérateurs peut lui être appliqué).

Les opérandes peuvent être spécifiés d'une des façons suivantes:

  1. Comme une valeur numérique, soit entière soit flottante.
  2. Comme une variable Tcl, en utilisant la notation standard $. La valeur de la variable sera utilisée comme opérande.
  3. Comme une chaîne entourée de doubles-guillemets. L'analyseur d'expression effectuera les substitution de backslash, de variable, et de commandes sur l'information entre guillemets, et utilisera la valeur résultante comme opérande
  4. Comme une chaîne entourée d'accolades. Les caractères entre l'accolade ouverte et l'accolade fermante correspondante seront utilisés comme opérande sans aucunes substitutions.
  5. Comme une commande Tcl entourée de crochets. La commande sera exécutée et son résultat sera utilisé comme opérande.
  6. Comme une fonction mathématique dont les arguments ont une des formes definies plus haut pour les opérandes , tel que sin($x). Voir ci-dessous pour une liste de fonctions définies.

Ou les substitutions se produisent plus haut (ex. dans les chaînes entre guillemets), elles sont effectuées

effectuée par l'analyseur de commande avant que le processeur d'expression ait été appelé. Comme expliqué ci-dessous, il est préférable d'entourer les expressions dans des accolades pour empêcher l'analyseur de commande d'effectuer des substitutions sur le contenu.

Pour quelques exemples d'expressions simples, supposez que la variable a a pour valeur 3 et la variable b a pour valeur 6.

expr 3.1 + $a
# donne 6.1
expr 2 + "$a.$b"
# donne 5.6
expr 4*[[llength "6 2"]]
# donne 8
expr {{word one} < "word $a"}
# donne 0

Opérateurs

Les opérateurs valides sont listés ci-dessous, groupés en ordre de précédence décroissant:

  • * / % : Multiplication, division, modulo. Aucun de ces opérandes ne peut être appliqué aux opérandes chaîne, et modulo peut être appliqué seulement aux entiers. modulo Modulo aura toujours le même signe que le

diviseur et une valeur absolue inférieure au diviseur.

  • + - : Addition et soustraction. Valides pour tout opérande numérique.
  • <<
  • < > <
  • == != : Booléen égal et différent. Chaque opérateur produit un zéro/un résultat. Valides pour tout types

d'opérande.


  • && : ET logique. Donne 1 si les deux opérandes sont différent de zéro, 0 autrement. Valide seulement pour pour les opérandes booléens et numériques (entiers ou flottants).
  • || : OU logique. Donne 0 si les deux opérandes sont zéro, 1 autrement. Valide seulement pour opérandes

booléens et numériques (entiers ou flottants).

  • x?y:z : If-then-else, comme en C. Si x est évalué différent de zéro, alors le résultat est la valeur de y. Autrement le résultat est la valeur de z. L'opérande x doit avoir une valeur numérique.

Les opérateurs &&, ||, et ?: ont une "évaluation paresseuse", juste comme en C, ce qui signifie que ces opérandes ne ont pas évalués s'ils ne sont pas nécessaires pour déterminer le résultat. Par

exemple, dans la commande
expr {$v ? [[a]] : [[b]]}
seulement un des a ou b sera évalué, dépendant de la valeur de $v. Notez, néanmoins, que ceci est seulement vrai si l'expression entière est entourée d'accolades; autrement l'analyseur Tcl evaluera a et b avant d'appeler la commande expr.

Fonctions mathématiques

Tcl supporte les fonctions mathématiques suivantes dans les expressions:

  • abs(arg) : Renvoie la valeur absolue de arg. arg peut être entier ou flottant, et le résultat renvoyé est de la même forme.
  • acos(arg) : Renvoie l'arc cosinus de arg, dans l'intervalle 0,pi radians. arg sera dans l'intervalle -1,1.
  • asin(arg) : Renvoie l'arc sinus de arg, dans l'intervalle -pi/2,pi/2 radians. arg sera dans l'intervalle -1,1.
  • atan(arg) : Renvoie l'arc tangente de arg, dans l'intervalle -pi/2,pi/2 radians.
  • atan2(x, y) : Renvoie l'arc tangente de y/x, dans l'intervalle -pi,pi radians. x et y ne peuvent être tous les deux 0.
  • cos(arg) : Renvoie le cosinus de arg, mesuré en radians.
  • cosh(arg) : Renvoie le cosinus hyperbolique de arg. Si le résultat cause un débordement, une erreur est renvoyée.
  • double(arg) : Si arg est une valeur flottante , retourne arg, autrement convertit arg en flottant et retourne la valeur convertie.
  • exp(arg) : Renvoie l'exponentiel de arg, défini comme e**arg. Si le résultat cause un débordement, une erreur est renvoyée.
  • fmod(x, y) : Renvoie le reste flottant de la division of x par y. Si y est 0, une erreur est renvoyée.
  • hypot(x, y) : Calcule la longueur de l'hypoténuse d'un triangle rectangle(x*x+y*y).
  • int(arg) : Si arg est une valeur entière, retourne arg, autrement convertit arg en entier par truncature et retourne la valeur convertie.
  • log(arg) : Renvoie le logarithme naturel de arg. arg doit être une valeur positive.
  • log10(arg) : Renvoie le logarithme base 10 de arg. arg doit être une valeur positive.


  • round(arg) : Si arg est une valeur entière, retourne arg, autrement convertit arg en entier arrondi et retourne la valeur convertie.
  • sin(arg) : Renvoie le sinus de arg, mesuré en radians.
  • sinh(arg) : Renvoie le sinus hyperbolique de arg. Si résultat cause un débordement, une erreur est renvoyée.
  • sqrt(arg) : Renvoie la racine carrée de arg. arg doit être non-négatif.
  • srand(arg) : Le arg, qui doit être un entier, est utilisé pour réinitialiser la graine du generateur de nombre aléatoire. Renvoie le premier nombre aléatoire de cette graine. Chaque interpréteur a sa propre graine.
  • tan(arg) : Renvoie la tangente de arg, mesurée en radians.
  • tanh(arg) : Renvoie la tangente hyperbolique de arg.

Types, débordement et précision

Tous les calculs internes impliquant des entiers sont fait avec le type C long, et tous calculs internes impliquant des flottants sont fait avec le type C double. Pendant la conversion d'une chaîne en valeur flottante, le débordement d'exposant est détecté et donne une erreur Tcl. Pour la conversion d'une chaîne en entier, la detection du débordement depend du comportement de quelques routines dans la bibliothèque C locale, donc il doit être considéré comme non fiable. Dans tous les cas, le débordement entier n'est généralement pas détecté avec fiabilité dans les résultats intermédiaires. Le débordement flottant est détecté par le matériel, qui est généralement fiable.

La conversion dans les representations internes des opérandes entiers, flottants, et chaînes est faite automatiquement si besoin. Pour les calculs arithmétiques, les entiers sont utilisés jusqu'a ce qu'un nombre flottant soit introduit, après lequel les flottants sont utilisés. Par exemple:

expr 5 / 4
# renvoie 1, alors que
expr 5 / 4.0 
expr 5 / ( [[string length "abcd"]] + 0.0 ) 
# renvoient 1.25.

Les valeurs flottantes sont toujours renvoyées avec un "." ou un e ainsi elles ne ressemblent pas aux valeur entières. Par exemple:

expr 20.0/5.0 
# retourne 4.0 et non pas 4.

Opérations sur les chaines

Les valeurs chaîne peuvent être employées comme opérandes des opérateurs de comparaison, bien que l'evaluateur d'expression essaye de comparer si possible des entiers ou des flottants. Si un des opérandes d'une comparaison est une chaîne et que l'autre a une valeur numérique, l'opérande numérique est converti en une chaîne en utilisant le spécificateur de format C sprintf %d pour les entiers et %g pour les valeurs flottantes. Par exemple, les commandes

expr {"0x03" > "2"} 
expr {"0y" < "0x12"}

renvoient toutes les deux 1. La première comparaison est faite en utilisant la comparaison entière, et la seconde est faite en utilisant la comparaison de chaînes après que le second opérande ait été converti en la chaîne 18. parce que Tcl a tendance a traiter les valeurs comme des nombres chaque fois que possible, ce n'est généralement pas une bonne idée d'utiliser des operateurs comme == quand vous desirez une comparaison de chaînes et les valeurs des opérandes pourraient être arbitraires; il est préférable dans ces cas d'utiliser la commande string.

Considérations de performance

Entourez les expressions d'accolades pour la rapidité et le stockage le moins encombrant. Ceci permet au compilateur bytecode Tcl de générer le meilleur code.

Comme mentionné plus haut, les expressions sont substituées deux fois: une fois par l'analyseur Tcl et une fois par la commande expr. Par exemple, les commandes

set a 3 
set b {$a + 2} 
expr $b*4

retourne 11, pas un multiple de 4. Ceci parce que l'analyseur Tcl substituera en premier $a + 2 pour la variable b, ensuite la commande expr evaluera l'expression $a + 2*4.

La plupart des expressions n'exigent pas une seconde passe de substitutions. Soit elles sont entourées d'accolades ou, sinon, leurs substitutions de variable et de commandes donnent des nombres ou des chaînes qui eux-même n'exigent pas de substitutions. Néanmoins, parce que quelques expressions non entourées d'accolades nécéssitent deux passes de substitutions, le compilateur bytecode doit emettre des instructions supplémentaires pour gérer cette situation. Le code le plus couteux est requis pour les expressions non entourées d'accolades qui contiennent des substitutions de commandes. Ces expressions doivent être implémentées par la génération de nouveau code chaque fois que l'expression est exécutée.

Voir également