.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH NUMFMT 1 "2026-09-01"
.SH "نام (NAME)"
numfmt \- تبدیل اعداد از/به رشته‌های خوانا برای انسان
.SH "خلاصه دستور (SYNOPSIS)"
\fBnumfmt\fR [OPTION]... [NUMBER]...
.SH "توضیحات (DESCRIPTION)"
تبدیل اعداد از/به رشته‌های خوانا برای انسان
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-debug\fR
چاپ هشدارها دربارهٔ ورودی نامعتبر
.TP
\fB\-\-grouping\fR
استفاده از گروه‌بندی ارقام تعریف‌شده توسط محلی‌سازی (locale)، به عنوان مثال 1,000,000 (به این معنی که در محلی‌سازی C/POSIX هیچ تأثیری ندارد)
.TP
\fB\-d\fR, \fB\-\-delimiter\fR \fI<X>\fR
استفاده از X به جای نویسهٔ فاصله برای جداکنندهٔ فیلد
.TP
\fB\-\-field\fR \fI<FIELDS>\fR [پیش‌فرض: 1]
جایگزینی اعداد در این فیلدهای ورودی؛ بخش FIELDS را در زیر ببینید
.TP
\fB\-\-format\fR \fI<FORMAT>\fR
استفاده از FORMAT ممیز شناور به سبک printf؛ برای جزئیات بخش FORMAT را در زیر ببینید
.TP
\fB\-\-from\fR \fI<UNIT>\fR [پیش‌فرض: none]
مقیاس‌بندی خودکار اعداد ورودی به UNITها؛ بخش UNIT را در زیر ببینید
.TP
\fB\-\-from\-unit\fR \fI<N>\fR [پیش‌فرض: 1]
مشخص کردن اندازهٔ واحد ورودی
.TP
\fB\-\-to\fR \fI<UNIT>\fR [پیش‌فرض: none]
مقیاس‌بندی خودکار اعداد خروجی به UNITها؛ بخش UNIT را در زیر ببینید
.TP
\fB\-\-to\-unit\fR \fI<N>\fR [پیش‌فرض: 1]
اندازهٔ واحد خروجی
.TP
\fB\-\-padding\fR \fI<N>\fR
فاصله‌گذاری (pad) خروجی تا N نویسه؛ مقدار مثبت N تراز راست و مقدار منفی N تراز چپ ایجاد می‌کند؛ اگر خروجی پهن‌تر از N باشد، فاصله‌گذاری نادیده گرفته می‌شود؛ حالت پیش‌فرض این است که اگر نویسهٔ فاصله‌ای یافت شود، فاصله‌گذاری به طور خودکار انجام گیرد
.TP
\fB\-\-header\fR[=\fI<N>\fR]
چاپ (بدون تبدیل) N خط نخست سرآیند؛ در صورت مشخص نشدن، پیش‌فرض N برابر ۱ است
.TP
\fB\-\-round\fR \fI<METHOD>\fR [پیش‌فرض: from\-zero]
استفاده از METHOD برای گرد کردن هنگام مقیاس‌بندی

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
up
.IP \(bu 2
down
.IP \(bu 2
from\-zero
.IP \(bu 2
towards\-zero
.IP \(bu 2
nearest
.RE
.TP
\fB\-\-suffix\fR \fI<SUFFIX>\fR
چاپ SUFFIX پس از هر عدد قالب‌بندی‌شده، و پذیرش ورودی‌هایی که به صورت اختیاری با SUFFIX خاتمه می‌یابند
.TP
\fB\-\-unit\-separator\fR \fI<STRING>\fR
استفاده از STRING برای جدا کردن عدد از هر واحد هنگام چاپ؛ به صورت پیش‌فرض، از هیچ جداکننده‌ای استفاده نمی‌شود
.TP
\fB\-\-invalid\fR \fI<INVALID>\fR [پیش‌فرض: abort]
تنظیم حالت شکست برای ورودی نامعتبر

\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
abort
.IP \(bu 2
fail
.IP \(bu 2
warn
.IP \(bu 2
ignore
.RE
.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 "اطلاعات تکمیلی (EXTRA)"
گزینه‌های UNIT:

\- none: هیچ مقیاس‌بندی خودکاری انجام نمی‌شود؛ پسوندها موجب بروز خطا خواهند شد

\- auto: پذیرش پسوند تک‌حرفی یا دوحرفی اختیاری:

    1K = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576,

\- si: پذیرش پسوند تک‌حرفی اختیاری:

    1K = 1000, 1M = 1000000, ...

\- iec: پذیرش پسوند تک‌حرفی اختیاری:

    1K = 1024, 1M = 1048576, ...

\- iec\-i: پذیرش پسوند دوحرفی اختیاری:

    1Ki = 1024, 1Mi = 1048576, ...

\- FIELDS از محدوده‌های فیلد به سبک cut(1) پشتیبانی می‌کند:

    N فیلد Nام، شمارش از ۱
    N\- از فیلد Nام تا انتهای خط
    N\-M از فیلد Nام تا فیلد Mام (شامل هر دو)
    \-M از اولین فیلد تا فیلد Mام (شامل هر دو)
    \- تمام فیلدها

فیلدها/محدوده‌های چندگانه را می‌توان با کاما از هم جدا کرد

FORMAT باید برای چاپ یک آرگومان ممیز شناور %f مناسب باشد.
علامت گفتاورد اختیاری (%\*(Aqf) گزینهٔ \-\-grouping را فعال خواهد کرد (در صورت پشتیبانی محلی‌سازی فعلی).
مقدار پهنای اختیاری (%10f) خروجی را فاصله‌گذاری می‌کند. پهنای صفر اختیاری (%010f)
عدد را با صفر پر می‌کند. مقادیر منفی اختیاری (%\-10f) تراز چپ اعمال می‌کنند.
دقت اختیاری (%.1f) دقت تعیین‌شده از ورودی را باطل می‌کند.
.SH "نسخه (VERSION)"
v(uutils coreutils) 0.11.0