STRFMON(3) | Library Functions Manual | STRFMON(3) |
strfmon
, strfmon_l
— convert monetary value to string
#include
<monetary.h>
ssize_t
strfmon
(char *restrict s,
size_t maxsize, const char *restrict
format, ...);
#include
<monetary.h>
#include <xlocale.h>
ssize_t
strfmon_l
(char *restrict s,
size_t maxsize, locale_t loc,
const char *restrict format,
...);
The
strfmon
()
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.
While the
strfmon
()
function uses the current locale, the
strfmon_l
()
function may be passed a locale directly. See
xlocale(3) for more information.
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:
=
f=
’ character followed by
another character f which is used as the numeric
fill character.^
+
(
!
-
#
’ sign followed by a decimal
number specifying the maximum expected number of digits after the radix
character..
’ character followed by a
decimal number specifying the number of digits after the radix
character.If the total number of resulting bytes, including the terminating
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.
The strfmon
() function will fail if:
#include <stdio.h> #include <monetary.h> #include <locale.h> int main() { char buf[200]; setlocale(LC_ALL, "en_US"); (void)strfmon (buf, sizeof(buf)-1, "%n" , 123456.78); printf("%s0, buf); }
The strfmon
() 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.
The strfmon
() function does not correctly
handle multibyte characters in the format
argument.
October 12, 2002 | macOS 14.6 |