.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.50.1.
.TH EXPR "1" "July 2026" "GNU coreutils 9.11" "دستورات کاربر"
.SH "نام (NAME)"
expr \- ارزیابی و محاسبه عبارات حسابی، رشته‌ای و منطقی
.SH "خلاصه دستور (SYNOPSIS)"
.B expr
\fI\,عبارت\/\fR
.br
.B expr
\fI\,گزینه\/\fR
.SH "توضیحات (DESCRIPTION)"
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
چاپ مقدار \fIعبارت\fR در خروجی استاندارد. خطوط خالی زیر گروه‌های دارای اولویت تقدم فزاینده را جدا می‌کنند. \fIعبارت\fR می‌تواند یکی از موارد زیر باشد:
.TP
ARG1 | ARG2
اگر \fIARG1\fR نه تهی (null) باشد و نه ۰، مقدار \fIARG1\fR و در غیر این صورت \fIARG2\fR
.TP
ARG1 & ARG2
اگر هیچ‌یک از آرگومان‌ها تهی یا ۰ نباشند، مقدار \fIARG1\fR و در غیر این صورت ۰
.TP
ARG1 < ARG2
\fIARG1\fR کوچک‌تر از \fIARG2\fR است
.TP
ARG1 <= ARG2
\fIARG1\fR کوچک‌تر یا مساوی با \fIARG2\fR است
.TP
ARG1 = ARG2
\fIARG1\fR برابر با \fIARG2\fR است
.TP
ARG1 != ARG2
\fIARG1\fR نابرابر با \fIARG2\fR است
.TP
ARG1 >= ARG2
\fIARG1\fR بزرگ‌تر یا مساوی با \fIARG2\fR است
.TP
ARG1 > ARG2
\fIARG1\fR بزرگ‌تر از \fIARG2\fR است
.TP
ARG1 + ARG2
حاصل‌جمع حسابی \fIARG1\fR و \fIARG2\fR
.TP
ARG1 \- ARG2
تفاضل حسابی \fIARG1\fR و \fIARG2\fR
.TP
ARG1 * ARG2
حاصل‌ضرب حسابی \fIARG1\fR و \fIARG2\fR
.TP
ARG1 / ARG2
خارج‌قسمت حسابی تقسیم \fIARG1\fR بر \fIARG2\fR
.TP
ARG1 % ARG2
باقی‌مانده حسابی تقسیم \fIARG1\fR بر \fIARG2\fR
.TP
STRING : REGEXP
تطابق الگوی مهارشده (anchored) عبارت منظم \fIREGEXP\fR در \fISTRING\fR
.TP
match STRING REGEXP
مشابه \fBSTRING : REGEXP\fR
.TP
substr STRING POS LENGTH
زیررشته‌ای از \fISTRING\fR، که در آن شمارش موقعیت \fIPOS\fR از ۱ آغاز می‌شود
.TP
index STRING CHARS
موقعیت (اندیس) در \fISTRING\fR که در آن هر یک از نویسه‌های \fICHARS\fR یافت شود، یا ۰
.TP
length STRING
طول رشته \fISTRING\fR
.TP
+ TOKEN
تفسیر \fITOKEN\fR به عنوان یک رشته، حتی اگر یک کلمه کلیدی مانند
.B match
یا عملگری مانند
.B /
باشد
.TP
( EXPRESSION )
مقدار \fIعبارت\fR (EXPRESSION)
.PP
توجه داشته باشید که بسیاری از عملگرها برای استفاده در پوسته (Shell) باید اسکیپ یا نقل‌قول‌بندی (کوتیشن) شوند.
مقایسه‌ها در صورتی که هر دو آرگومان عدد باشند، به‌صورت حسابی انجام می‌شوند؛ در غیر این صورت مقایسه بر اساس ترتیب لغت‌نامه‌ای (lexicographical) خواهد بود.
تطابق‌های الگو، رشته منطبق‌شده میان
.B \e(
و
.B \e)
یا مقدار تهی (null) را برمی‌گردانند؛ اگر از
.B \e(
و
.B \e)
استفاده نشود، تعداد نویسه‌های منطبق‌شده یا ۰ بازگردانده می‌شود.
.PP
وضعیت خروج برابر ۰ است اگر \fIعبارت\fR نه تهی باشد و نه ۰؛ ۱ است اگر \fIعبارت\fR تهی یا ۰ باشد؛ ۲ است اگر ساختار دستوری \fIعبارت\fR نامعتبر باشد؛ و ۳ است اگر خطایی رخ داده باشد.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Mike Parker، James Youngman، و Paul Eggert.
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش اشکالات به: bug\-coreutils@gnu.org
.br
صفحه خانگی GNU coreutils: <https://www.gnu.org/software/coreutils>
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: <https://www.gnu.org/gethelp>
.br
گزارش اشکالات ترجمه به: <https://translationproject.org/team>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل در <https://www.gnu.org/software/coreutils/expr>
.br
یا در دسترس به‌صورت محلی از طریق: \fBinfo \(aq(coreutils) expr invocation\(aq\fR