man/expr.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH EXPR "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 expr \- evaluate expressions
   5 .SH SYNOPSIS
   6 .B expr
   7 \fIEXPRESSION\fR
   8 .br
   9 .B expr
  10 \fIOPTION\fR
  11 .SH DESCRIPTION
  12 .\" Add any additional description here
  13 .TP
  14 \fB\-\-help\fR
  15 display this help and exit
  16 .TP
  17 \fB\-\-version\fR
  18 output version information and exit
  19 .PP
  20 Print the value of EXPRESSION to standard output.  A blank line below
  21 separates increasing precedence groups.  EXPRESSION may be:
  22 .TP
  23 ARG1 | ARG2
  24 ARG1 if it is neither null nor 0, otherwise ARG2
  25 .TP
  26 ARG1 & ARG2
  27 ARG1 if neither argument is null or 0, otherwise 0
  28 .TP
  29 ARG1 < ARG2
  30 ARG1 is less than ARG2
  31 .TP
  32 ARG1 <= ARG2
  33 ARG1 is less than or equal to ARG2
  34 .TP
  35 ARG1 = ARG2
  36 ARG1 is equal to ARG2
  37 .TP
  38 ARG1 != ARG2
  39 ARG1 is unequal to ARG2
  40 .TP
  41 ARG1 >= ARG2
  42 ARG1 is greater than or equal to ARG2
  43 .TP
  44 ARG1 > ARG2
  45 ARG1 is greater than ARG2
  46 .TP
  47 ARG1 + ARG2
  48 arithmetic sum of ARG1 and ARG2
  49 .TP
  50 ARG1 \- ARG2
  51 arithmetic difference of ARG1 and ARG2
  52 .TP
  53 ARG1 * ARG2
  54 arithmetic product of ARG1 and ARG2
  55 .TP
  56 ARG1 / ARG2
  57 arithmetic quotient of ARG1 divided by ARG2
  58 .TP
  59 ARG1 % ARG2
  60 arithmetic remainder of ARG1 divided by ARG2
  61 .TP
  62 STRING : REGEXP
  63 anchored pattern match of REGEXP in STRING
  64 .TP
  65 match STRING REGEXP
  66 same as STRING : REGEXP
  67 .TP
  68 substr STRING POS LENGTH
  69 substring of STRING, POS counted from 1
  70 .TP
  71 index STRING CHARS
  72 index in STRING where any CHARS is found, or 0
  73 .TP
  74 length STRING
  75 length of STRING
  76 .TP
  77 + TOKEN
  78 interpret TOKEN as a string, even if it is a
  79 .IP
  80 keyword like `match' or an operator like `/'
  81 .TP
  82 ( EXPRESSION )
  83 value of EXPRESSION
  84 .PP
  85 Beware that many operators need to be escaped or quoted for shells.
  86 Comparisons are arithmetic if both ARGs are numbers, else lexicographical.
  87 Pattern matches return the string matched between \e( and \e) or null; if
  88 \e( and \e) are not used, they return the number of characters matched or 0.
  89 .PP
  90 Exit status is 0 if EXPRESSION is neither null nor 0, 1 if EXPRESSION is null
  91 or 0, 2 if EXPRESSION is syntactically invalid, and 3 if an error occurred.
  92 .SH AUTHOR
  93 Written by Mike Parker.
  94 .SH "REPORTING BUGS"
  95 Report bugs to <bug\-coreutils@gnu.org>.
  96 .SH COPYRIGHT
  97 Copyright \(co 2007 Free Software Foundation, Inc.
  98 .br
  99 This is free software.  You may redistribute copies of it under the terms of
 100 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 101 There is NO WARRANTY, to the extent permitted by law.
 102 .SH "SEE ALSO"
 103 The full documentation for
 104 .B expr
 105 is maintained as a Texinfo manual.  If the
 106 .B info
 107 and
 108 .B expr
 109 programs are properly installed at your site, the command
 110 .IP
 111 .B info expr
 112 .PP
 113 should give you access to the complete manual.