Man page - rust-numfmt(1)

Packages contains this manual

Manual

numfmt

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXTRA
VERSION

NAME

numfmt - Convert numbers from/to human-readable strings

SYNOPSIS

numfmt [ -d | --delimiter ] [ --field ] [ --format ] [ --from ] [ --from-unit ] [ --to ] [ --to-unit ] [ --padding ] [ --header ] [ --round ] [ --suffix ] [ --invalid ] [ -h | --help ] [ -V | --version ] [ NUMBER ]

DESCRIPTION

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

--from = UNIT [default: none]

auto-scale input numbers to UNITs; see UNIT below

--from-unit = N [default: 1]

specify the input unit size

--to = UNIT [default: none]

auto-scale output numbers to UNITs; see UNIT below

--to-unit = N [default: 1]

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