You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
|
|
.TH fmt_human 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
fmt_human \- write a human readable ASCII representation of a long integer
|
|
|
|
|
.SH SYNTAX
|
|
|
|
|
.B #include <fmt.h>
|
|
|
|
|
|
|
|
|
|
size_t \fBfmt_human\fP(char *\fIdest\fR,unsigned long long \fIsource\fR);
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
fmt_human writes a human readable ASCII representation of \fIsource\fR
|
|
|
|
|
to \fIdest\fR and returns the number of bytes written. The result
|
|
|
|
|
resembles the file size output of "ls -H"; 1000 becomes "1.0k", 1000000
|
|
|
|
|
becomes "1.0M" and so on for "G" and "T".
|
|
|
|
|
|
|
|
|
|
fmt_human does not append \\0.
|
|
|
|
|
|
|
|
|
|
If \fIdest\fR equals FMT_LEN (i.e. is zero), fmt_human returns the number
|
|
|
|
|
of bytes it would have written.
|
|
|
|
|
|
|
|
|
|
The output of fmt_human can not exceed 11 (assuming unsigned long long
|
|
|
|
|
has 64 bits).
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
fmt_humank(3), scan_human(3)
|
