106 lines
2.7 KiB
Groff
106 lines
2.7 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH EXPR "1" "April 2025" "GNU coreutils 9.7" "User Commands"
|
|
.SH NAME
|
|
expr \- evaluate expressions
|
|
.SH SYNOPSIS
|
|
.B expr
|
|
\fI\,EXPRESSION\/\fR
|
|
.br
|
|
.B expr
|
|
\fI\,OPTION\/\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
|
|
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, James Youngman, and Paul Eggert.
|
|
.SH "REPORTING BUGS"
|
|
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
|
|
.br
|
|
Report any translation bugs to <https://translationproject.org/team/>
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2025 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
Full documentation <https://www.gnu.org/software/coreutils/expr>
|
|
.br
|
|
or available locally via: info \(aq(coreutils) expr invocation\(aq
|