original/man1/expr.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH EXPR "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 expr \- evaluate expressions
   5 .SH SYNOPSIS
   6 .B expr
   7 \fI\,EXPRESSION\/\fR
   8 .br
   9 .B expr
  10 \fI\,OPTION\/\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, James Youngman, and Paul Eggert.
  94 .SH "REPORTING BUGS"
  95 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  96 .br
  97 Report expr translation bugs to <http://translationproject.org/team/>
  98 .SH COPYRIGHT
  99 Copyright \(co 2016 Free Software Foundation, Inc.
 100 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 101 .br
 102 This is free software: you are free to change and redistribute it.
 103 There is NO WARRANTY, to the extent permitted by law.
 104 .SH "SEE ALSO"
 105 Full documentation at: <http://www.gnu.org/software/coreutils/expr>
 106 .br
 107 or available locally via: info \(aq(coreutils) expr invocation\(aq