.TH NUMFMT "1" "ژوئیه ۲۰۲۶" "GNU coreutils 9.11" "دستورهای کاربری"
.SH "نام (NAME)"
numfmt \- تبدیل اعداد از و به رشته‌های خوانا برای انسان
.SH "خلاصه دستور (SYNOPSIS)"
.B numfmt
[\fI\,گزینه\/\fR]... [\fI\,عدد\/\fR]...
.SH "توضیحات (DESCRIPTION)"
.PP
قالب‌بندی مجدد \fIعدد\fRها، یا اعدادی که از ورودی استاندارد دریافت می‌شوند در صورتی که مقداری مشخص نشده باشد.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-\-debug\fR
چاپ هشدارهای مربوط به ورودی نامعتبر
.TP
\fB\-d\fR, \fB\-\-delimiter\fR=\fI\,X\/\fR
استفاده از X به عنوان جداکننده فیلدها به جای فاصله‌های خالی
.TP
\fB\-\-field\fR=\fI\,FIELDS\/\fR
جایگزینی اعداد در این فیلدهای ورودی (پیش‌فرض=۱)؛
برای جزئیات بیشتر به بخش FIELDS در زیر مراجعه کنید
.TP
\fB\-\-format\fR=\fI\,FORMAT\/\fR
استفاده از قالب ممیز شناور به سبک printf؛
برای جزئیات به بخش FORMAT در زیر مراجعه کنید
.TP
\fB\-\-from\fR=\fI\,UNIT\/\fR
مقیاس‌بندی خودکار اعداد ورودی به واحدهای UNIT؛ پیش‌فرض 'none' است؛
برای جزئیات به بخش UNIT در زیر مراجعه کنید
.TP
\fB\-\-from\-unit\fR=\fI\,N\/\fR
مشخص کردن اندازه واحد ورودی (به جای مقدار پیش‌فرض ۱)
.TP
\fB\-\-grouping\fR
استفاده از گروه‌بندی ارقام تعریف‌شده توسط محلی‌سازی (locale)، مثلاً 1,000,000.
این گزینه در محیط محلی C/POSIX بی‌اثر است
.TP
\fB\-\-header\fR[=\fI\,N\/\fR]
چاپ (بدون تبدیل) اولین N خط هدر؛
در صورت مشخص نشدن، N به طور پیش‌فرض ۱ است
.TP
\fB\-\-invalid\fR=\fI\,MODE\/\fR
حالت مواجهه با اعداد نامعتبر؛
\fIMODE\fR می‌تواند یکی از موارد زیر باشد: abort (پیش‌فرض)، fail، warn، ignore
.TP
\fB\-\-padding\fR=\fI\,N\/\fR
فاصله‌گذاری خروجی تا N کاراکتر؛
مقدار مثبت N راست‌چین می‌کند و مقدار منفی N چپ‌چین می‌کند؛
اگر خروجی پهن‌تر از N باشد فاصله‌گذاری نادیده گرفته می‌شود؛
پیش‌فرض این است که در صورت یافتن فاصله خالی، به طور خودکار فاصله پر شود
.TP
\fB\-\-round\fR=\fI\,METHOD\/\fR
استفاده از \fIMETHOD\fR برای گرد کردن هنگام مقیاس‌بندی؛ \fIMETHOD\fR می‌تواند یکی از موارد زیر باشد:
up، down، from\-zero (پیش‌فرض)، towards\-zero، nearest
.TP
\fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
افزودن پسوند \fISUFFIX\fR به اعداد خروجی،
و پذیرش یک پسوند اختیاری \fISUFFIX\fR در اعداد ورودی
.TP
\fB\-\-unit\-separator\fR=\fI\,SEP\/\fR
درج \fISEP\fR بین عدد و واحد در خروجی،
و پذیرش \fISEP\fR اختیاری در اعداد ورودی
.TP
\fB\-\-to\fR=\fI\,UNIT\/\fR
مقیاس‌بندی خودکار اعداد خروجی به واحدهای UNIT؛ بخش UNIT در زیر را ببینید
.TP
\fB\-\-to\-unit\fR=\fI\,N\/\fR
اندازه واحد خروجی (به جای مقدار پیش‌فرض ۱)
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
جداکننده خطوط NUL است، نه خط جدید
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SS "گزینه‌های واحد (UNIT options):"
.TP
none
هیچ مقیاس‌بندی خودکاری انجام نمی‌شود؛ پسوندها باعث بروز خطا خواهند شد
.TP
auto
پذیرش پسوند یک یا دو حرفی اختیاری:
1K = 1000, 1k = 1000,
1Ki = 1024,
1M = 1000000,
1Mi = 1048576,
.TP
si
پذیرش پسوند یک حرفی اختیاری:
1k = 1000, 1K = 1000,
1M = 1000000,
\&...
.TP
iec
پذیرش پسوند یک حرفی اختیاری:
1K = 1024, 1k = 1024,
1M = 1048576,
\&...
.TP
iec\-i
پذیرش پسوند دو حرفی اختیاری:
1Ki = 1024, 1ki = 1024,
1Mi = 1048576,
\&...
.SS "بخش FIELDS از محدوده‌های فیلد به سبک cut(1) پشتیبانی می‌کند:"
.TP
N
فیلد N‌ام، شمارش از ۱
.TP
N\-
از فیلد N‌ام تا انتهای خط
.TP
N\-M
از فیلد N‌ام تا فیلد M‌ام (شامل هر دو)
.TP
\fB\-M\fR
از اولین فیلد تا فیلد M‌ام (شامل هر دو)
.TP
\-
تمام فیلدها
.PP
فیلدها و محدوده‌های چندگانه را می‌توان با ویرگول (,) جدا کرد.
.PP
قالب \fBFORMAT\fR باید برای چاپ یک آرگومان ممیز شناور '%f' مناسب باشد.
علامت نقل‌قول اختیاری (%'f) ویژگی \fB\-\-grouping\fR را فعال می‌کند (اگر توسط لوکال جاری پشتیبانی شود).
مقدار عرض اختیاری (%10f) خروجی را فاصله‌گذاری می‌کند. مقدار صفر اختیاری (%010f) عدد را با صفر پر می‌کند. مقادیر منفی اختیاری (%\-10f) خروجی را چپ‌چین می‌کند. دقت اختیاری (%.1f) دقت تعیین‌شده در ورودی را بازنویسی می‌کند.
.PP
در صورت تبدیل موفقیت‌آمیز تمام اعداد ورودی، وضعیت خروج ۰ خواهد بود.
به طور پیش‌فرض، numfmt با اولین خطای تبدیل با وضعیت خروج ۲ متوقف می‌شود.
با گزینه \fB\-\-invalid\fR=\fI\,'fail'\/\fR برای هر خطای تبدیل یک هشدار چاپ شده و وضعیت خروج ۲ خواهد بود. با \fB\-\-invalid\fR=\fI\,'warn'\/\fR هر خطای تبدیل گزارش می‌شود اما وضعیت خروج ۰ است. با \fB\-\-invalid\fR=\fI\,'ignore'\/\fR خطاهای تبدیل گزارش نمی‌شوند و وضعیت خروج ۰ خواهد بود.
.SH "مثال‌ها (EXAMPLES)"
.nf
$ numfmt --to=si 1000
-> "1.0k"

$ numfmt --to=iec 2048
-> "2.0K"

$ numfmt --to=iec-i 4096
-> "4.0Ki"

$ echo 1K | numfmt --from=si
-> "1000"

$ echo 1K | numfmt --from=iec
-> "1024"

$ df -B1 | numfmt --header --field 2-4 --to=si
$ ls -l  | numfmt --header --field 5 --to=iec
$ ls -lh | numfmt --header --field 5 --from=iec --padding=10
$ ls -lh | numfmt --header --field 5 --from=iec --format %10f
.fi
.SH "نویسنده (AUTHOR)"
نوشته شده توسط Assaf Gordon.
.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/numfmt>
.br
یا به صورت محلی از طریق: info \(aq(coreutils) numfmt invocation\(aq