نام (NAME)

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

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

numfmt [OPTION]... [NUMBER]...

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

--debug: چاپ هشدارها دربارهٔ ورودی نامعتبر
--grouping: استفاده از گروه‌بندی ارقام تعریف‌شده توسط محلی‌سازی (locale)، به عنوان مثال 1,000,000 (به این معنی که در محلی‌سازی C/POSIX هیچ تأثیری ندارد)
-d, --delimiter <X>: استفاده از X به جای نویسهٔ فاصله برای جداکنندهٔ فیلد
--field <FIELDS> [پیش‌فرض: 1]: جایگزینی اعداد در این فیلدهای ورودی؛ بخش FIELDS را در زیر ببینید
--format <FORMAT>: استفاده از FORMAT ممیز شناور به سبک printf؛ برای جزئیات بخش FORMAT را در زیر ببینید
--from <UNIT> [پیش‌فرض: none]: مقیاس‌بندی خودکار اعداد ورودی به UNITها؛ بخش UNIT را در زیر ببینید
--from-unit <N> [پیش‌فرض: 1]: مشخص کردن اندازهٔ واحد ورودی
--to <UNIT> [پیش‌فرض: none]: مقیاس‌بندی خودکار اعداد خروجی به UNITها؛ بخش UNIT را در زیر ببینید
--to-unit <N> [پیش‌فرض: 1]: اندازهٔ واحد خروجی
--padding <N>: فاصله‌گذاری (pad) خروجی تا N نویسه؛ مقدار مثبت N تراز راست و مقدار منفی N تراز چپ ایجاد می‌کند؛ اگر خروجی پهن‌تر از N باشد، فاصله‌گذاری نادیده گرفته می‌شود؛ حالت پیش‌فرض این است که اگر نویسهٔ فاصله‌ای یافت شود، فاصله‌گذاری به طور خودکار انجام گیرد
--header[=<N>]: چاپ (بدون تبدیل) N خط نخست سرآیند؛ در صورت مشخص نشدن، پیش‌فرض N برابر ۱ است
--round <METHOD> [پیش‌فرض: from-zero]: استفاده از METHOD برای گرد کردن هنگام مقیاس‌بندی
مقادیر ممکن:

up
down
from-zero
towards-zero
nearest

--suffix <SUFFIX>: چاپ SUFFIX پس از هر عدد قالب‌بندی‌شده، و پذیرش ورودی‌هایی که به صورت اختیاری با SUFFIX خاتمه می‌یابند
--unit-separator <STRING>: استفاده از STRING برای جدا کردن عدد از هر واحد هنگام چاپ؛ به صورت پیش‌فرض، از هیچ جداکننده‌ای استفاده نمی‌شود
--invalid <INVALID> [پیش‌فرض: abort]: تنظیم حالت شکست برای ورودی نامعتبر
مقادیر ممکن:

abort
fail
warn
ignore

-z, --zero-terminated: جداکنندهٔ خط NUL است، نه خط جدید (newline)
-h, --help: نمایش راهنما
-V, --version: نمایش نسخه

اطلاعات تکمیلی (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 مناسب باشد. علامت گفتاورد اختیاری (%'f) گزینهٔ --grouping را فعال خواهد کرد (در صورت پشتیبانی محلی‌سازی فعلی). مقدار پهنای اختیاری (%10f) خروجی را فاصله‌گذاری می‌کند. پهنای صفر اختیاری (%010f) عدد را با صفر پر می‌کند. مقادیر منفی اختیاری (%-10f) تراز چپ اعمال می‌کنند. دقت اختیاری (%.1f) دقت تعیین‌شده از ورودی را باطل می‌کند.

نسخه (VERSION)

v(uutils coreutils) 0.11.0