diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
| commit | 96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c (patch) | |
| tree | 70686b943e33a6e939ad265acb7ddfef70b91f32 /man/man3/strfmon.3 | |
| parent | 8f4ed6463206e8ede815c72085c7305dafc2e4fc (diff) | |
| download | man-pages-96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c.tar.gz | |
Revert "src.mk, All pages: Move man* to man/"
This reverts commit 70ac1c4785fc1e158ab2349a962dba2526bf4fbc.
Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/>
Reported-by: Petr Vorel <pvorel@suse.cz>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man/man3/strfmon.3')
| -rw-r--r-- | man/man3/strfmon.3 | 206 |
1 files changed, 0 insertions, 206 deletions
diff --git a/man/man3/strfmon.3 b/man/man3/strfmon.3 deleted file mode 100644 index 40342a9005..0000000000 --- a/man/man3/strfmon.3 +++ /dev/null @@ -1,206 +0,0 @@ -.\" Copyright (c) 2000 Andries Brouwer (aeb@cwi.nl) -.\" -.\" SPDX-License-Identifier: GPL-2.0-or-later -.\" -.TH STRFMON 3 2021-03-22 "Linux man-pages (unreleased)" -.SH NAME -strfmon, strfmon_l \- convert monetary value to a string -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.B #include <monetary.h> -.PP -.BI "ssize_t strfmon(char *restrict " s ", size_t " max , -.BI " const char *restrict " format ", ...);" -.BI "ssize_t strfmon_l(char *restrict " s ", size_t " max ", locale_t " locale , -.BI " const char *restrict " format ", ...);" -.fi -.SH DESCRIPTION -The -.BR strfmon () -function formats the specified monetary amount -according to the current locale -and format specification -.I format -and places the -result in the character array -.I s -of size -.IR max . -.PP -The -.BR strfmon_l () -function performs the same task, -but uses -the locale specified by -.IR locale . -The behavior of -.BR strfmon_l () -is undefined if -.I locale -is the special locale object -.B LC_GLOBAL_LOCALE -(see -.BR duplocale (3)) -or is not a valid locale object handle. -.PP -Ordinary characters in -.I format -are copied to -.I s -without conversion. -Conversion specifiers are introduced by a \(aq%\(aq -character. -Immediately following it there can be zero or more -of the following flags: -.TP -.BI = f -The single-byte character -.I f -is used as the numeric fill character (to be used with -a left precision, see below). -When not specified, the space character is used. -.TP -.B \(ha -Do not use any grouping characters that might be defined -for the current locale. -By default, grouping is enabled. -.TP -.BR ( " or " + -The ( flag indicates that negative amounts should be enclosed between -parentheses. -The + flag indicates that signs should be handled -in the default way, that is, amounts are preceded by the locale's -sign indication, for example, nothing for positive, "\-" for negative. -.TP -.B ! -Omit the currency symbol. -.TP -.B \- -Left justify all fields. -The default is right justification. -.PP -Next, there may be a field width: a decimal digit string specifying -a minimum field width in bytes. -The default is 0. -A result smaller than this width is padded with spaces -(on the left, unless the left-justify flag was given). -.PP -Next, there may be a left precision of the form "#" followed by -a decimal digit string. -If the number of digits left of the -radix character is smaller than this, the representation is -padded on the left with the numeric fill character. -Grouping characters are not counted in this field width. -.PP -Next, there may be a right precision of the form "." followed by -a decimal digit string. -The amount being formatted is rounded to -the specified number of digits prior to formatting. -The default is specified in the -.I frac_digits -and -.I int_frac_digits -items of the current locale. -If the right precision is 0, no radix character is printed. -(The radix character here is determined by -.BR LC_MONETARY , -and may differ from that specified by -.BR LC_NUMERIC .) -.PP -Finally, the conversion specification must be ended with a -conversion character. -The three conversion characters are -.TP -.B % -(In this case, the entire specification must be exactly "%%".) -Put a \(aq%\(aq character in the result string. -.TP -.B i -One argument of type -.I double -is converted using the locale's international currency format. -.TP -.B n -One argument of type -.I double -is converted using the locale's national currency format. -.SH RETURN VALUE -The -.BR strfmon () -function returns the number of characters placed -in the array -.IR s , -not including the terminating null byte, -provided the string, including the terminating null byte, fits. -Otherwise, it sets -.I errno -to -.BR E2BIG , -returns \-1, and the contents of the array is undefined. -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.ad l -.nh -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.BR strfmon () -T} Thread safety MT-Safe locale -T{ -.BR strfmon_l () -T} Thread safety MT-Safe -.TE -.hy -.ad -.sp 1 -.SH STANDARDS -POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLES -The call -.PP -.in +4n -.EX -strfmon(buf, sizeof(buf), "[%\(ha=*#6n] [%=*#6i]", - 1234.567, 1234.567); -.EE -.in -.PP -outputs -.PP -.in +4n -.EX -[€ **1234,57] [EUR **1 234,57] -.EE -.in -.PP -in the -.I nl_NL -locale. -The -.IR de_DE , -.IR de_CH , -.IR en_AU , -and -.I en_GB -locales yield -.PP -.in +4n -.EX -[ **1234,57 €] [ **1.234,57 EUR] -[ Fr. **1234.57] [ CHF **1\(aq234.57] -[ $**1234.57] [ AUD**1,234.57] -[ £**1234.57] [ GBP**1,234.57] -.EE -.in -.SH SEE ALSO -.BR duplocale (3), -.BR setlocale (3), -.BR sprintf (3), -.BR locale (7) |