numfmt man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

NUMFMT(1)			 User Commands			     NUMFMT(1)

NAME
       numfmt - Convert numbers from/to human-readable strings

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

DESCRIPTION
       Reformat	 NUMBER(s),  or	 the  numbers  from standard input if none are
       specified.

       Mandatory arguments to long options are	mandatory  for	short  options
       too.

       --debug
	      print warnings about invalid input

       -d, --delimiter=X
	      use X instead of whitespace for field delimiter

       --field=N
	      replace the number in input field N (default is 1)

       --format=FORMAT
	      use  printf  style  floating-point  FORMAT; see FORMAT below for
	      details

       --from=UNIT
	      auto-scale input numbers to UNITs; default is 'none';  see  UNIT
	      below

       --from-unit=N
	      specify the input unit size (instead of the default 1)

       --grouping
	      use  locale-defined  grouping  of	 digits, e.g. 1,000,000 (which
	      means it has no effect in the C/POSIX locale)

       --header[=N]
	      print (without converting) the first N header lines; N  defaults
	      to 1 if not specified

       --invalid=MODE
	      failure  mode for invalid numbers: MODE can be: abort (default),
	      fail, warn, ignore

       --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	white‐
	      space is found

       --round=METHOD
	      use  METHOD  for rounding when scaling; METHOD can be: up, down,
	      from-zero (default), towards-zero, nearest

       --suffix=SUFFIX
	      add SUFFIX to output numbers,  and  accept  optional  SUFFIX  in
	      input numbers

       --to=UNIT
	      auto-scale output numbers to UNITs; see UNIT below

       --to-unit=N
	      the output unit size (instead of the default 1)

       --help display this help and exit

       --version
	      output version information and exit

   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, ...

       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 nega‐
       tive width values (%-10f) will left-pad output.

       Exit status is 0 if all input numbers were successfully converted.   By
       default,	 numfmt will stop at the first conversion error with exit sta‐
       tus 2.  With --invalid='fail' a warning is printed for each  conversion
       error  and the exit status is 2.	 With --invalid='warn' each conversion
       error is diagnosed, but the exit status is 0.  With  --invalid='ignore'
       conversion errors are not diagnosed and the exit status is 0.

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 | numfmt --header --field 2 --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
       Written by Assaf Gordon.

REPORTING BUGS
       Report numfmt bugs to bug-coreutils@gnu.org
       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
       General help using GNU software: <http://www.gnu.org/gethelp/>
       Report numfmt translation bugs to <http://translationproject.org/team/>

COPYRIGHT
       Copyright  ©  2013  Free Software Foundation, Inc.  License GPLv3+: GNU
       GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free  to	change	and  redistribute  it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO
       The  full  documentation	 for numfmt is maintained as a Texinfo manual.
       If the info and numfmt programs are properly installed  at  your	 site,
       the command

	      info coreutils 'numfmt invocation'

       should give you access to the complete manual.

GNU coreutils 8.21		  March 2014			     NUMFMT(1)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net