expr

Évalue une expression

expr arg ?arg arg ...?

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éséance 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 est évaluée à 14.2. Les expressions Tcl diffèrent des expressions C dans le sens ou les opérandes sont spécifiés. De plus, les expressions Tcl supportent les opérandes non-numériques et les comparaisons de chaînes.

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 définies 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 par les instructions des expressions. Néanmoins, une couche de substitution supplémentaire peut déjà avoir été 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.

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

• - + ~ ! Moins unaire, plus unitaire, NOT bit à bit, NOT logique. Aucun de ces opérateurs ne peut être appliqué aux opérandes chaîne, et NOT bit à bit peut seulement être appliqué aux entiers.
• * / % 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.
• « » Décalage à gauche et à droite. Valides seulement pour les opérandes entiers. Un décalage à droite propage toujours le bit de signe.
• < > ⇐ >= Booléens inférieur à, supérieur à, inférieur à ou égal, et supérieur à ou égal. Chaque opérateur donne 1 si la condition est vraie, 0 autrement. Ces opérateurs peuvent être appliqués aux chaînes aussi bien qu'aux opérandes numériques, dans le cas des chaînes, une comparaison est utilisée.
• == != Booléen égal et différent. Chaque opérateur produit un zéro/un résultat. Valides pour tout types d'opérande.
• & ET Bit à bit. Valide pour des opérandes entiers seulement.
• ^ OU exclusif Bit à bit. Valide pour des opérandes entiers seulement.
• | OU Bit à bit. Valide pour des opérandes entiers seulement.
• && 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.

Voir le manuel C pour plus de détails sur les résultats produits par chaque opérateur. Tous les opérateurs binaire sont groupés de gauche à droite à l'intérieur d'un même niveau de préséance. Par exemple, la commande expr 4*2 < 7 retourne 0.

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 évaluera [a] et [b] avant d'appeler la commande expr.

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.
• ceil(arg) : Renvoie la plus petite valeur entière non inférieure à arg.
• 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.
• floor(arg) : Renvoie la plus grande valeur entière non supérieure à arg.
• 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 troncature 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.
• pow(x, y) : Calcule la valeur de x élevé à la puissance y. Si x est négatif, y doit être une valeur entière.
• rand() : Renvoie un nombre flottant compris entre zéro et juste inférieur à un ou, en termes mathématiques, l'intervalle [0,1]. La graine vient de l'horloge interne de la machine ou peut être fixée manuellement avec la fonction srand.
• 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 générateur 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.