.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH JOIN 1 "2026-09-01"
.SH "نام (NAME)"
join \- نوشتن یک خط در خروجی استاندارد به ازای هر جفت خط ورودی با فیلدهای پیوند یکسان. فیلد پیوند پیش‌فرض نخستین فیلد است که با نویسه‌های فاصله جدا می‌شود.

هنگامی که FILE1 یا FILE2 (نه هر دو) برابر \- باشد، ورودی استاندارد خوانده می‌شود.
.SH "خلاصه دستور (SYNOPSIS)"
\fBjoin\fR [OPTION]... FILE1 FILE2
.SH "توضیحات (DESCRIPTION)"
به ازای هر جفت از خطوط ورودی با فیلدهای پیوند یکسان، یک خط در خروجی استاندارد می‌نویسد. فیلد پیوند پیش‌فرض، نخستین فیلد است که با نویسه‌های فاصله (blanks) جدا می‌شود.
.PP
هنگامی که FILE1 یا FILE2 (نه هر دو) برابر با \- باشد، ورودی استاندارد خوانده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR \fI<FILENUM>\fR
همچنین خطوط جفت‌نشده از فایل FILENUM را چاپ می‌کند؛ که در آن FILENUM برابر با 1 یا 2 است و با FILE1 یا FILE2 مطابقت دارد

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
1
.IP \(bu 2
2
.RE
.TP
\fB\-v\fR \fI<FILENUM>\fR
مشابه \-a FILENUM، اما از نمایش خطوط پیوند‌خورده در خروجی جلوگیری می‌کند

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
1
.IP \(bu 2
2
.RE
.TP
\fB\-e\fR \fI<EMPTY>\fR
جایگزین کردن فیلدهای ورودی ناموجود با EMPTY
.TP
\fB\-i\fR, \fB\-\-ignore\-case\fR
نادیده گرفتن تفاوت حروف کوچک و بزرگ هنگام مقایسه فیلدها
.TP
\fB\-j\fR \fI<FIELD>\fR
معادل \*(Aq\-1 FIELD \-2 FIELD\*(Aq
.TP
\fB\-o\fR \fI<FORMAT>\fR
پیروی از FORMAT هنگام ساخت خط خروجی
.TP
\fB\-t\fR \fI<CHAR>\fR
استفاده از CHAR به عنوان جداکننده فیلد در ورودی و خروجی
.TP
\fB\-1\fR \fI<FIELD>\fR
پیوند بر اساس این FIELD از فایل 1
.TP
\fB\-2\fR \fI<FIELD>\fR
پیوند بر اساس این FIELD از فایل 2
.TP
\fB\-\-check\-order\fR
بررسی اینکه ورودی به درستی مرتب شده باشد، حتی اگر تمام خطوط ورودی قابل جفت‌شدن باشند
.TP
\fB\-\-nocheck\-order\fR
بررسی نکردن مرتب‌بودن صحیح ورودی
.TP
\fB\-\-header\fR
در نظر گرفتن خط نخست در هر فایل به عنوان سربرگ فیلدها و چاپ آن‌ها بدون تلاش برای جفت‌کردن
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
جداکننده خطوط NUL است، نه خط جدید (newline)
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخه
.SH "نسخه (VERSION)"
v(uutils coreutils) 0.11.0