名称

expand_number — 人間に読み込み可能な形式から数を書式化する

ライブラリ

System Utilities Library (libutil, -lutil)

書式

#include < libutil.h>

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

解説

expand_number() 関数は、 buf 文字列を解析し、 num 引数によって指されたアドレスに符号無し 64 ビット量で格納します。

expand_number() 関数は、SI の 2 のべき乗の規約に従います。

接頭辞は、次の通りです:

接頭辞	説明	乗数
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.

エラー

expand_number() 関数は、次の場合に失敗します:

[ EINVAL]

与えられた文字列には、数値を含んでいません。

[ EINVAL]

認識されていない接頭辞が与えられました。

[ ERANGE]

結果が 64 ビットに収まりません。

関連項目

humanize_number(3)

歴史

expand_number() 関数は、 FreeBSD 6.3 ではじめて登場しました。