نام (NAME)

numfmt - تبدیل اعداد از و به رشته‌های خوانا برای انسان

خلاصه دستور (SYNOPSIS)

numfmt [گزینه]... [عدد]...

توضیحات (DESCRIPTION)

قالب‌بندی مجدد عددها، یا اعدادی که از ورودی استاندارد دریافت می‌شوند در صورتی که مقداری مشخص نشده باشد.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

--debug: چاپ هشدارهای مربوط به ورودی نامعتبر
-d, --delimiter=X: استفاده از X به عنوان جداکننده فیلدها به جای فاصله‌های خالی
--field=FIELDS: جایگزینی اعداد در این فیلدهای ورودی (پیش‌فرض=۱)؛ برای جزئیات بیشتر به بخش FIELDS در زیر مراجعه کنید
--format=FORMAT: استفاده از قالب ممیز شناور به سبک printf؛ برای جزئیات به بخش FORMAT در زیر مراجعه کنید
--from=UNIT: مقیاس‌بندی خودکار اعداد ورودی به واحدهای UNIT؛ پیش‌فرض 'none' است؛ برای جزئیات به بخش UNIT در زیر مراجعه کنید
--from-unit=N: مشخص کردن اندازه واحد ورودی (به جای مقدار پیش‌فرض ۱)
--grouping: استفاده از گروه‌بندی ارقام تعریف‌شده توسط محلی‌سازی (locale)، مثلاً 1,000,000. این گزینه در محیط محلی C/POSIX بی‌اثر است
--header[=N]: چاپ (بدون تبدیل) اولین N خط هدر؛ در صورت مشخص نشدن، N به طور پیش‌فرض ۱ است
--invalid=MODE: حالت مواجهه با اعداد نامعتبر؛ MODE می‌تواند یکی از موارد زیر باشد: abort (پیش‌فرض)، fail، warn، ignore
--padding=N: فاصله‌گذاری خروجی تا N کاراکتر؛ مقدار مثبت N راست‌چین می‌کند و مقدار منفی N چپ‌چین می‌کند؛ اگر خروجی پهن‌تر از N باشد فاصله‌گذاری نادیده گرفته می‌شود؛ پیش‌فرض این است که در صورت یافتن فاصله خالی، به طور خودکار فاصله پر شود
--round=METHOD: استفاده از METHOD برای گرد کردن هنگام مقیاس‌بندی؛ METHOD می‌تواند یکی از موارد زیر باشد: up، down، from-zero (پیش‌فرض)، towards-zero، nearest
--suffix=SUFFIX: افزودن پسوند SUFFIX به اعداد خروجی، و پذیرش یک پسوند اختیاری SUFFIX در اعداد ورودی
--unit-separator=SEP: درج SEP بین عدد و واحد در خروجی، و پذیرش SEP اختیاری در اعداد ورودی
--to=UNIT: مقیاس‌بندی خودکار اعداد خروجی به واحدهای UNIT؛ بخش UNIT در زیر را ببینید
--to-unit=N: اندازه واحد خروجی (به جای مقدار پیش‌فرض ۱)
-z, --zero-terminated: جداکننده خطوط NUL است، نه خط جدید
--help: نمایش این راهنما و خروج
--version: نمایش اطلاعات نسخه و خروج

گزینه‌های واحد (UNIT options):

none: هیچ مقیاس‌بندی خودکاری انجام نمی‌شود؛ پسوندها باعث بروز خطا خواهند شد
auto: پذیرش پسوند یک یا دو حرفی اختیاری: 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576,
si: پذیرش پسوند یک حرفی اختیاری: 1k = 1000, 1K = 1000, 1M = 1000000, ...
iec: پذیرش پسوند یک حرفی اختیاری: 1K = 1024, 1k = 1024, 1M = 1048576, ...
iec-i: پذیرش پسوند دو حرفی اختیاری: 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...

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

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

فیلدها و محدوده‌های چندگانه را می‌توان با ویرگول (,) جدا کرد.

قالب FORMAT باید برای چاپ یک آرگومان ممیز شناور '%f' مناسب باشد. علامت نقل‌قول اختیاری (%'f) ویژگی --grouping را فعال می‌کند (اگر توسط لوکال جاری پشتیبانی شود). مقدار عرض اختیاری (%10f) خروجی را فاصله‌گذاری می‌کند. مقدار صفر اختیاری (%010f) عدد را با صفر پر می‌کند. مقادیر منفی اختیاری (%-10f) خروجی را چپ‌چین می‌کند. دقت اختیاری (%.1f) دقت تعیین‌شده در ورودی را بازنویسی می‌کند.

در صورت تبدیل موفقیت‌آمیز تمام اعداد ورودی، وضعیت خروج ۰ خواهد بود. به طور پیش‌فرض، numfmt با اولین خطای تبدیل با وضعیت خروج ۲ متوقف می‌شود. با گزینه --invalid='fail' برای هر خطای تبدیل یک هشدار چاپ شده و وضعیت خروج ۲ خواهد بود. با --invalid='warn' هر خطای تبدیل گزارش می‌شود اما وضعیت خروج ۰ است. با --invalid='ignore' خطاهای تبدیل گزارش نمی‌شوند و وضعیت خروج ۰ خواهد بود.

مثال‌ها (EXAMPLES)

$ 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

نویسنده (AUTHOR)

نوشته شده توسط Assaf Gordon.

گزارش اشکالات (REPORTING BUGS)

گزارش اشکالات به: bug-coreutils@gnu.org
صفحه خانگی GNU coreutils: https://www.gnu.org/software/coreutils
راهنمای عمومی استفاده از نرم‌افزارهای گنو: https://www.gnu.org/gethelp
گزارش اشکالات ترجمه به https://translationproject.org/team

حق نشر (COPYRIGHT)

حق نشر © 2026 Free Software Foundation, Inc. مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

همچنین ببینید (SEE ALSO)

مستندات کامل در: https://www.gnu.org/software/coreutils/numfmt
یا به صورت محلی از طریق: info '(coreutils) numfmt invocation'