ssize_t
strfmon(char * restrict s, size_t maxsize, const char * restrict format, ...)
)
function places characters into the array pointed to by
s
as controlled by the string pointed to by
format.
No more than
maxsize
bytes are placed into the array.
The format string is composed of zero or more directives: ordinary characters (not %), which are copied unchanged to the output stream; and conversion specifications, each of which results in fetching zero or more subsequent arguments. Each conversion specification is introduced by the % character. After the %, the following appear in sequence:
%'
character is written.
NULL
byte is not more than
maxsize,
strfmon()
returns the number of bytes placed into the array pointed to by
s,
not including the terminating
NULL
byte.
Otherwise, -1 is returned,
the contents of the array are indeterminate,
and
errno
is set to indicate the error.
)
function will fail if:
E2BIG]EINVAL]ENOMEM])
function
conforms to
IEEE Std 1003.1-2001 (``POSIX.1'') .
The
strfmon()
function was implemented by
Alexey Zelkin <phantom@FreeBSD.org>.
This manual page was written by Jeroen Ruigrok van der Werven <asmodai@FreeBSD.org> based on the standard's text.
)
function does not correctly handle multibyte characters in the
format
argument.