1 .\" Copyright (c) 2000 Andries Brouwer (aeb@cwi.nl)
3 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
9 .\" The GNU General Public License's references to "object code"
10 .\" and "executables" are to be interpreted as the output of any
11 .\" document formatting or typesetting system, including
12 .\" intermediate and printed output.
14 .\" This manual is distributed in the hope that it will be useful,
15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 .\" GNU General Public License for more details.
19 .\" You should have received a copy of the GNU General Public
20 .\" License along with this manual; if not, see
21 .\" <http://www.gnu.org/licenses/>.
24 .TH STRFMON 3 2015-07-23 "Linux" "Linux Programmer's Manual"
26 strfmon, strfmon_l \- convert monetary value to a string
29 .B #include <monetary.h>
31 .BI "ssize_t strfmon(char *" s ", size_t " max ", const char *" format ,
34 .BI "ssize_t strfmon_l(char *" s ", size_t " max ", locale_t " locale ",
35 .B const char *" format , "...);"
40 function formats the specified monetary amount
41 according to the current locale
42 and format specification
45 result in the character array
52 function performs the same task,
54 the locale specified by
60 is the special locale object
64 or is not a valid locale object handle.
66 Ordinary characters in
71 Conversion specifiers are introduced by a \(aq%\(aq
73 Immediately following it there can be zero or more
74 of the following flags:
77 The single-byte character
79 is used as the numeric fill character (to be used with
80 a left precision, see below).
81 When not specified, the space character is used.
84 Do not use any grouping characters that might be defined
85 for the current locale.
86 By default, grouping is enabled.
89 The ( flag indicates that negative amounts should be enclosed between
91 The + flag indicates that signs should be handled
92 in the default way, that is, amounts are preceded by the locale's
93 sign indication, for example, nothing for positive, "\-" for negative.
96 Omit the currency symbol.
99 Left justify all fields.
100 The default is right justification.
102 Next, there may be a field width: a decimal digit string specifying
103 a minimum field width in bytes.
105 A result smaller than this width is padded with spaces
106 (on the left, unless the left-justify flag was given).
108 Next, there may be a left precision of the form "#" followed by
109 a decimal digit string.
110 If the number of digits left of the
111 radix character is smaller than this, the representation is
112 padded on the left with the numeric fill character.
113 Grouping characters are not counted in this field width.
115 Next, there may be a right precision of the form "." followed by
116 a decimal digit string.
117 The amount being formatted is rounded to
118 the specified number of digits prior to formatting.
119 The default is specified in the
123 items of the current locale.
124 If the right precision is 0, no radix character is printed.
125 (The radix character here is determined by
127 and may differ from that specified by
130 Finally, the conversion specification must be ended with a
131 conversion character.
132 The three conversion characters are
135 (In this case, the entire specification must be exactly "%%".)
136 Put a \(aq%\(aq character in the result string.
141 is converted using the locale's international currency format.
146 is converted using the locale's national currency format.
150 function returns the number of characters placed
153 not including the terminating null byte,
154 provided the string, including the terminating null byte, fits.
159 returns \-1, and the contents of the array is undefined.
161 For an explanation of the terms used in this section, see
167 Interface Attribute Value
170 T} Thread safety MT-Safe locale
173 T} Thread safety MT-Safe
177 POSIX.1-2001, POSIX.1-2008.
183 strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]",
191 [€ **1234,57] [EUR **1 234,57]
206 [ **1234,57 €] [ **1.234,57 EUR]
208 [ Fr. **1234.57] [ CHF **1'234.57]
210 [ $**1234.57] [ AUD**1,234.57]
212 [ £**1234.57] [ GBP**1,234.57]