1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
.TH fmt_human 3
.SH NAME
fmt_human \- write a human readable ASCII representation of a long integer
.SH SYNTAX
.B #include <libowfat/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)
|
