Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
EXPAND_NUMBER(3)	 BSD Library Functions Manual	      EXPAND_NUMBER(3)

NAME
     expand_number -- format a number from human readable form

LIBRARY
     System Utilities Library (libutil,	-lutil)

SYNOPSIS
     #include <libutil.h>

     int
     expand_number(const char *buf, uint64_t *num);

DESCRIPTION
     The expand_number() function parses the buf string	and stores a unsigned
     64-bit quantity at	*num.

     The expand_number() function is case-insensitive and follows the SI power
     of	two convention.

     The suffixes are:

	   Suffix    Description    Multiplier
	   K	     kilo	    1024
	   M	     mega	    1048576
	   G	     giga	    1073741824
	   T	     tera	    1099511627776
	   P	     peta	    1125899906842624
	   E	     exa	    1152921504606846976

RETURN VALUES
     Upon successful completion, the value 0 is	returned; otherwise the
     value -1 is returned and the global variable errno	is set to indicate the
     error.

ERRORS
     The expand_number() function will fail if:

     [EINVAL]		The given string contains no digits.

     [EINVAL]		An unrecognized	suffix was given.

     [ERANGE]		Result doesn't fit into	64 bits.

SEE ALSO
     humanize_number(3)

HISTORY
     The expand_number() function first	appeared in FreeBSD 6.3.

BSD				 July 20, 2019				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=expand_number&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help