rust-numfmt1
Convert numbers from/to human-readable strings
Usage
numfmt [{-d | --delimiter}]
[--field]
[--format]
[--from]
[--from-unit]
[--to]
[--to-unit]
[--padding]
[--header]
[--round]
[--suffix]
[--invalid]
[{-h | --help}]
[{-V | --version}]
[NUMBER]
Overview
Convert numbers from/to human-readable strings
Options
-
-d, --delimiter=X -
use X instead of whitespace for field delimiter
--field=FIELDS [default: 1]-
replace the numbers in these input fields; see FIELDS below
-
--format=FORMAT -
use printf style floating-point FORMAT; see FORMAT below for details
|
auto-scale input numbers to UNITs; see UNIT below |
|---|---|
|
specify the input unit size |
|
auto-scale output numbers to UNITs; see UNIT below |
|
the output unit size |
-
--padding=N -
pad the output to N characters; positive N will right-align; negative N will left-align; padding is ignored if the output is wider than N; the default is to automatically pad if a whitespace is found
-
--header=N -
print (without converting) the first N header lines; N defaults to 1 if not specified
--round=METHOD [default: from-zero]-
use METHOD for rounding when scaling
[possible values: up, down, from-zero, towards-zero, nearest]
-
--suffix=SUFFIX -
print SUFFIX after each formatted number, and accept inputs optionally ending with SUFFIX
--invalid=INVALID [default: abort]-
set the failure mode for invalid input
[possible values: abort, fail, warn, ignore]
-
-h, --help -
Print help
-
-V, --version -
Print version
Extra
UNIT options:
- none: no auto-scaling is done; suffixes will trigger an error - auto: accept optional single/two letter suffix:
1K = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576,
- si: accept optional single letter suffix:
1K = 1000, 1M = 1000000, ...
- iec: accept optional single letter suffix:
1K = 1024, 1M = 1048576, ...
- iec-i: accept optional two-letter suffix:
1Ki = 1024, 1Mi = 1048576, ...
- FIELDS supports cut(1) style field ranges:
N N'th field, counted from 1
N- from N'th field, to end of line
N-M from N'th to M'th field (inclusive)
-M from first to M'th field (inclusive)
- all fields
Multiple fields/ranges can be separated with commas
FORMAT must be suitable for printing one floating-point argument %f. Optional quote (%'f) will enable --grouping (if supported by current locale). Optional width value (%10f) will pad output. Optional zero (%010f) width will zero pad the number. Optional negative values (%-10f) will left align. Optional precision (%.1f) will override the input determined precision.
Version
v0.0.30
Releases
2 releases since Debian 12 (Bookworm); the text changed 1 time.
-V since Debian 13 (Trixie);
-h since Debian 13 (Trixie).
--debug until Debian 12 (Bookworm);
--field until Debian 12 (Bookworm);
--from until Debian 12 (Bookworm);
--from-unit until Debian 12 (Bookworm);
--grouping until Debian 12 (Bookworm);
--invalid until Debian 12 (Bookworm);
--round until Debian 12 (Bookworm);
--to until Debian 12 (Bookworm);
--to-unit until Debian 12 (Bookworm);
--zero-terminated until Debian 12 (Bookworm);
-M until Debian 12 (Bookworm);
-z until Debian 12 (Bookworm).