Provided by: manpages-zh_1.5.1-1_all bug

NAME

       expr - 求一个表达式的值

 SYNOPSIS
       expr arg ?arg arg ...?
_________________________________________________________________

 DESCRIPTION
       连接(concatenate)所有 arg (在它们中间添加分隔符空格),把结果作为一个Tcl
       表示式来求值(evaluate)并返回结果。在  Tcl  表达式中允许的操作符式在   C
       表达式中允许的操作符的一个子集,并且它们与相应的                      C
       操作符有相同意义和优先级。表达式几乎总是产生一个数值结果(整数或浮点数的值)。例如,表达式
              expr 8.2 + 6
       求值出            14.2.             Tcl            表达式与           C
       表达式在操作数指定的方式上有区别。还有,Tcl
       表达式支持非数值操作符和字符串比较。

 OPERANDS
       一个                                                                Tcl
       表达式由操作符、操作数和括号的组合构成。在操作符、操作数和括号之间可使用白空格;它被表达式的指令所忽略。指定整数值可以使用十进制(通常的情况)、八进制(如果操作数的第一个字符是
       0)、或十六进制(如果操作数的前两个字符是
       0x)。如果一个操作数没有上述的整数格式,则如果可能的话把它作为浮点数对待。指定浮点数可以使用任何遵从
       ANSI 的 C 编译器可接受方式(除了在多数安装(installation)中不允许 fFlL                后缀)。例如,下列的数都是有效的浮点数:
       2.1、3.、6e4、7.91e+16。如果没有可能的数值解释,则一个操作数被作为字符串来保留(并且对它只提供一组有限的操作符)。

       可以用下列方式指定操作数:

       [1]    为一个数值值,要么是整数要么是浮点数。

       [2]    作为一个 Tcl 变量,使用标准的 $ 记号。变量的值将被用作操作数。

       [3]    作为用双引号包围起来的一个字符串。表达式分析器将在引号之间的信息上完成反斜杠、变量和命令替换,并把结果值用作操作数。

       [4]    作为用花括号包围起来的一个字符串。在左花括号和相匹配的右花括号之间的字符将被用作操作数而不做任何替换。

       [5]    作为一个用方括号包围起来的                                   Tcl
              命令。命令将被执行并且它的结果将被用作操作数。

       [6]    作为一个数学函数,它的参数可以是操作数的任何上述形式,比如
              sin($x)。参见下面的已定义的函数的一个列表。

       在上述替换发生的地方(例如在被引用起来的字符串当中),他们由表达式的指令来完成。但是,在调用表达式处理器之前命令分析器可能已-
       完成了一个额外的替换层。如下面讨论的那样,通常最好把表达式包围在花括号中来防止命令分析器在这些内容上进行替换。

       举一些简单的表达式的例子,假设变量a   的值是  3  并且变量   b    的值是
       6。则下面的每行左边的命令将生成右边的值。
              expr 3.1 + $a           6.1
              expr 2 + "$a.$b"        5.6
              expr 4*[llength "6 2"]  8
              expr {{word one} < "word $a"}0

 OPERATORS
       下面列出了有效的操作符,用优先级的降序分组:

       -  +  ~  !          一元(Unary,也译为单目)减,一元加,位(bit-wise)
                           NOT,逻
                           NOT。这些操作符不能提供给字符串操作数,并且位   NOT
                           只能提供给整数。

       *  /  %             乘,除,求余。这些操作符不能提供给字符串操作数,并且求余只能提供给整数。余数将总是与除数有相同的符号并且绝对值小于除数。

       +  -                加和减。对任何数值操作数均有效。

       <<  >>              左移和右移。只对整数操作数有效。一右移总是传播(propagate)符号位。

       <  >  <=  >=        Boolean
                           小于,大于,小于等于,大于等于。如果条件是真则每个操作符产生
                           1,否则
                           0。这些操作符可以象提供给数值操作数一样提供给字符串,在这种情况下使用字符串比较。

       ==  !=              Boolean
                           等于和不等于。每个操作符产生一个零/一结果。对所有操作数类型有效。

       &                   位与。只对整数操作数有效。

       ^                   位异或。只对整数操作数有效。

       |                   位或。只对整数操作数有效。

       &&                  逻加搿H绻礁霾僮魇际欠橇阍蛏梢桓 1,否则生成
                           0。只对 boolean 和数值(整数或浮点数)操作数有效。

       ||                  逻蓟颉H绻礁霾僮魇际橇阍蛏梢桓   0,否则生成
                           1。只对 boolean 和数值(整数或浮点数)操作数有效。

       x?y:z               If-then-else,如同     C      语言那样。如果      x
                           求值为非零,则结果是     y    的值。否则结果是    z
                           的值。x操作数必须是一个数值值。

       参见                                                                  C
       手册来得到对每个操作符的生成结果的更详细的描述。所有相同的优先级的二元操作符从左至右的组合(group)。例如,命令
              expr 4*2 < 7
       返回 0.

       &&,       ||,       和       ?:       操作符“惰性求值”,如同        C
       语言那样,这意味着如果操作数对确定结果不是必须的则不被求值。例如,命令
              expr {$v ? [a] : [b]}
       中实际上只有       [a][b]中的一个将被求值,依赖于      $v
       的值。注意,这只在整个表达式被包围在花括号中时是真的;否则          Tcl
       分析器将在调用 expr  命令之前求值 [a][b] 二者。

 MATH FUNCTIONS
       Tcl 支持在表达式中的下列数学函数:

              abs         cosh        log        sqrt
              acos        double      log10      srand
              asin        exp         pow        tan
              atan        floor       rand       tanh
              atan2       fmod        round
              ceil        hypot       sin
              cos         int         sinh

       abs(arg)
              返回                                                         arg
              的绝对值。Arg可以要么式整数要么是浮点数,并且结果以同样的形式返回。

       acos(arg)
              返回  arg  的反余弦,值域是  [0,pi] 弧度。Arg的定义域是 [-1,1]。
              .TP asin(arg) 返回 arg 的反正弦,值域是  [-pi/2,pi/2]  弧度。Arg
              的定义域是 [-1,1]。

       atan(arg)
              返回 arg 的反正切,值域是 [-pi/2,pi/2] 弧度。

       atan2(x, y)
              返回 y/x 的反正切,值域是 [-pi,pi] 和,xy  不能都是 0。

       ceil(arg)
              返回不小于 arg 的最小的整数值。

       cos(arg)
              返回 arg 的余弦,单位是弧度。

       cosh(arg)
              返回 arg 的双曲余弦,如果结果导致溢出,返回一个错误。

       double(arg)
              如果      arg       是一个浮点值,返回      arg;否则把      arg
              转换成浮点数并返回转换后的值。

       exp(arg)
              返回 arg 的指数,定义为 e**arg。如果结果导致溢出,返回一个错误。

       floor(arg)
              返回不大于 arg 的最大整数值。

       fmod(x, y)
              返回 x 除以 y 得到的浮点余数。如果 y 是 0,返回一个错误。

       hypot(x, y)
              计算一个直角三角形的斜边的长度(x*x+y*y)。

       int(arg)
              如果      arg       是一个整数值,返回      arg,否则通过截取arg
              (的整数部分)来把它转换成整数并返回转换后的值。

       log(arg)
              返回 arg 的自然对数。Arg  必须是正数值。

       log10(arg)
              返回 arg 的以10 为底的对数(常用对数)。Arg必须是正数值。

       pow(x, y)
              计算 xy 次幂。如果 x 是负数,y  必须是一个整数值。

       rand() 返回一个大于等于零且小于                                       1
              的一个(随机)浮点数,这个范围用数学术语是区间[0,1)。种子来自机器的内部时钟或用
              srand 函数人为设定。

       round(arg)
              如果   arg    是一个整数,返回    arg,否则通过四舍五入把    arg
              转换成整数并返回转换后的值。

       sin(arg)
              返回 arg 的正弦,单位是弧度。

       sinh(arg)
              返回 arg 的双曲正弦。如果结果导致溢出,返回一个错误。

       sqrt(arg)
              返回 arg 的开方。Arg  必须是非负数。

       srand(arg)
               arg
              必须是一个整数,它被用于重置随机数生成器的种子。返回用这个种子生成的第一个随机数。每个解释器都有它自己的种子。

       tan(arg)
              返回 arg 的正切。单位是弧度。

       tanh(arg)
              返回 arg 的双曲正切。

       除了这些预定义的函数之外,应用可以使用       Tcl_CreateMathFunc      ()
       定义增补的函数。

 TYPES, OVERFLOW,  PRECISION
       所有涉及整数的内部运算用            C             类型             long
       处置。并且所有涉及浮点数的内部运算用        C        类型        double
       处置。当把一个字符串转换成一个浮点数的时候,若检测到指数溢出则导致一个
       Tcl         错误。对于从字符串转换成整数,溢出检测依赖于在本地        C
       库中的一些例程的行为,所以它应被作为不可靠的来看待。在任何情况下,对中间结果通常不能可靠的检测整数的上溢和下溢。浮点数上溢和下溢的检测通常达到由硬件支持的程度,普遍非常可靠。

       整数,浮点数、和字符串的内部表示之间的转换按需要自动完成。对于算术计算,在浮点数介入之前使用整数,此后使用浮点数。例如,
              expr 5 / 4
       返回 1,而
              expr 5 / 4.0
              expr 5 / ( [string length "abcd"] + 0.0 )
       都返回       1.25。        返回的浮点值总是带着一个“.”或一个        e
       所以它们看起来不象整数值。例如,
              expr 20.0/5.0
       返回 4.0, 而不是 4.

 STRING OPERATIONS
       字符串可被用做比较操作符的操作数,尽管表达式求值器尽可能的尝试着作为整数或浮点数来做比较。如果一个比较的操作数中的一个是字符串而其他是数值值,数值操作数被转换回字符串,对整数值使用
       C sprintf  格式指定符 %d ,对浮点数值使用 %g。例如,命令
              expr {"0x03" > "2"}
              expr {"0y" < "0x12"}
       都返回
       1。做第一个比较使用了整数比较,而做第二个比较在把第二个操作数转换成字符串
       18之后使用了字符串比较。因为                                        Tcl
       趋向于尽可能的把值作为数值对待,在你事实上想进行字符串比较并且操作符的值可以是任意的的时候使用象
       ==  这样的操作符通常不是个好主意;在这种情况下最好使用 string命令。

 PERFORMANCE CONSIDERATIONS
       要得到最快的速度和最小的存储需求,就要把表达式包围在花括号中。这允许
       Tcl 字节码编译器生成最好的代码。

       象上面所提及的那样,表达式被替换两次:  一次由  Tcl  解释器,一次由 expr
       命令。例如,命令
              set a 3
              set b {$a + 2}
              expr $b*4
       返回 11,而不是 4 的倍数。这是因为 Tcl 分析器将首先把变量 b替换成 $a  +
       2,接着 expr  命令将求值表达式 $a + 2*4。

       多数表达式不需要两轮替换。要它们被包围在花括号中,要么它们的变量和命令替换生成数值或本身不需要替换的字符串。但是,因为一些未用化括号包围起来的表达式需要两轮替换,字节码编译器必须散布(emit)额外的指令来处理这些情况。对于未用化括号包围起来的表达式,代价最高昂的代码是包含命令替换的代码。必须通过在每次执行这个表达式时生成新的代码来实现这些表达式。

 KEYWORDS
       arithmetic, boolean, compare, expression, fuzzy comparison

[[2001/07/22

 Linux man:
       http://cmpp.linuxforum.net