.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. .TH EXPR "1" "December 2006" "expr 6.7" "User Commands" .SH NAME expr \- evaluate expressions .SH SYNOPSIS .B expr \fIEXPRESSION\fR .br .B expr \fIOPTION\fR .SH DESCRIPTION .\" Add any additional description here .TP \fB\-\-help\fR display this help and exit .TP \fB\-\-version\fR output version information and exit .PP Print the value of EXPRESSION to standard output. A blank line below separates increasing precedence groups. EXPRESSION may be: .TP ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2 .TP ARG1 & ARG2 ARG1 if neither argument is null or 0, otherwise 0 .TP ARG1 < ARG2 ARG1 is less than ARG2 .TP ARG1 <= ARG2 ARG1 is less than or equal to ARG2 .TP ARG1 = ARG2 ARG1 is equal to ARG2 .TP ARG1 != ARG2 ARG1 is unequal to ARG2 .TP ARG1 >= ARG2 ARG1 is greater than or equal to ARG2 .TP ARG1 > ARG2 ARG1 is greater than ARG2 .TP ARG1 + ARG2 arithmetic sum of ARG1 and ARG2 .TP ARG1 \- ARG2 arithmetic difference of ARG1 and ARG2 .TP ARG1 * ARG2 arithmetic product of ARG1 and ARG2 .TP ARG1 / ARG2 arithmetic quotient of ARG1 divided by ARG2 .TP ARG1 % ARG2 arithmetic remainder of ARG1 divided by ARG2 .TP STRING : REGEXP anchored pattern match of REGEXP in STRING .TP match STRING REGEXP same as STRING : REGEXP .TP substr STRING POS LENGTH substring of STRING, POS counted from 1 .TP index STRING CHARS index in STRING where any CHARS is found, or 0 .TP length STRING length of STRING .TP + TOKEN interpret TOKEN as a string, even if it is a .IP keyword like `match' or an operator like `/' .TP ( EXPRESSION ) value of EXPRESSION .PP Beware that many operators need to be escaped or quoted for shells. Comparisons are arithmetic if both ARGs are numbers, else lexicographical. Pattern matches return the string matched between \e( and \e) or null; if \e( and \e) are not used, they return the number of characters matched or 0. .PP Exit status is 0 if EXPRESSION is neither null nor 0, 1 if EXPRESSION is null or 0, 2 if EXPRESSION is syntactically invalid, and 3 if an error occurred. .SH AUTHOR Written by Mike Parker. .SH "REPORTING BUGS" Report bugs to . .SH COPYRIGHT Copyright \(co 2006 Free Software Foundation, Inc. .br This is free software. You may redistribute copies of it under the terms of the GNU General Public License . There is NO WARRANTY, to the extent permitted by law. .SH "SEE ALSO" The full documentation for .B expr is maintained as a Texinfo manual. If the .B info and .B expr programs are properly installed at your site, the command .IP .B info expr .PP should give you access to the complete manual.