oracular (3) fmt_human.3.gz

NAME

       fmt_human - write a human readable ASCII representation of a long integer

SYNTAX

       #include <libowfat/fmt.h>

       size_t fmt_human(char *dest,unsigned long long source);

DESCRIPTION

       fmt_human  writes a human readable ASCII representation of source to dest 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 dest 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).

SEE ALSO

       fmt_humank(3), scan_human(3)

                                                                                                    fmt_human(3)