EXPAND_NUMBER(3) | MidnightBSD Library Functions Manual | EXPAND_NUMBER(3) |
expand_number
—
format a number from human readable form
System Utilities Library (libutil, -lutil)
#include
<libutil.h>
int
expand_number
(const char *buf,
uint64_t *num);
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 |
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.
The expand_number
() function will fail
if:
The expand_number
() function first
appeared in FreeBSD 6.3.
July 20, 2019 | midnightbsd-3.1 |