---
name: "fmt_human"
section: "3"
platform: "linux"
package: "libowfat-dev"
version: "0.32-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/fmt_human"
---

# fmt\_human(3)

write a human readable ASCII representation of a long integer

## 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)](/fmt_humank/3.md), scan\_human(3)