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
The expand_number() function returns the value 0 if successful; 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
HISTORY
The expand_number() function first appeared in FreeBSD 6.3.