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_humank 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
fmt_humank \- write a human readable ASCII representation of a long integer
|
|
|
|
|
.SH SYNTAX
|
|
|
|
|
.B #include <fmt.h>
|
|
|
|
|
|
|
|
|
|
size_t \fBfmt_humank\fP(char *\fIdest\fR,unsigned long long \fIsource\fR);
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
fmt_humank 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"; 1024 becomes "1.0k", 1048576
|
|
|
|
|
becomes "1.0M" and so on for "G" and "T".
|
|
|
|
|
|
|
|
|
|
fmt_humank does not append \\0.
|
|
|
|
|
|
|
|
|
|
If \fIdest\fR equals FMT_LEN (i.e. is zero), fmt_humank returns the number
|
|
|
|
|
of bytes it would have written.
|
|
|
|
|
|
|
|
|
|
The output of fmt_humank can not exceed 11 (assuming unsigned long long
|
|
|
|
|
has 64 bits).
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
fmt_human(3), scan_humank(3)
|
