7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  13 .\"
  14 .TH STRFMON 3C "Jun 23, 2014"
  15 .SH NAME
  16 strfmon, strfmon_l \- convert monetary values to string
  17 .SH SYNOPSIS
  18 .LP
  19 .nf
  20 #include <monetary.h>
  21 
  22 \fBssize_t\fR \fBstrfmon\fR(\fBchar *restrict\fR \fIs\fR, \fBsize_t\fR \fImaxsize\fR,
  23     \fBconst char *restrict\fR \fIformat\fR, ...);
  24 .fi
  25 .LP
  26 .nf
  27 \fBssize_t\fR \fBstrfmon\fR(\fBchar *restrict\fR \fIs\fR, \fBsize_t\fR \fImaxsize\fR,
  28     \fBlocale_t\fR \fIloc\fR, \fBconst char *restrict\fR \fIformat\fR, ...);
  29 .fi
  30 .SH DESCRIPTION
  31 These functions are used to format strings containing numeric quantities using
  32 rules that are specific to a given locale.  For example, in the United States,
  33 currencies are formatted using the dollar sign
  34 .RB ( $ )
  35 and include two decimal digits (cents).
  36 .LP
  37 Each character from the
  38 .I format
  39 is copied to the output buffer supplied by
  40 .IR s .
  41 Furthermore, when a percent
  42 .RB ( % )
  43 character is encountered, this triggers an expansion, as follows:
  44 .LP
  45 Immediately following the
  46 .B %
  47 character there shall be zero or more flags, as indicated below:

   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  13 .\"
  14 .TH STRFMON 3C "Jun 23, 2014"
  15 .SH NAME
  16 strfmon, strfmon_l \- convert monetary values to string
  17 .SH SYNOPSIS
  18 .LP
  19 .nf
  20 #include <monetary.h>
  21 
  22 \fBssize_t\fR \fBstrfmon\fR(\fBchar *restrict\fR \fIs\fR, \fBsize_t\fR \fImaxsize\fR,
  23     \fBconst char *restrict\fR \fIformat\fR, ...);
  24 .fi
  25 .LP
  26 .nf
  27 \fBssize_t\fR \fBstrfmon_l\fR(\fBchar *restrict\fR \fIs\fR, \fBsize_t\fR \fImaxsize\fR,
  28     \fBlocale_t\fR \fIloc\fR, \fBconst char *restrict\fR \fIformat\fR, ...);
  29 .fi
  30 .SH DESCRIPTION
  31 These functions are used to format strings containing numeric quantities using
  32 rules that are specific to a given locale.  For example, in the United States,
  33 currencies are formatted using the dollar sign
  34 .RB ( $ )
  35 and include two decimal digits (cents).
  36 .LP
  37 Each character from the
  38 .I format
  39 is copied to the output buffer supplied by
  40 .IR s .
  41 Furthermore, when a percent
  42 .RB ( % )
  43 character is encountered, this triggers an expansion, as follows:
  44 .LP
  45 Immediately following the
  46 .B %
  47 character there shall be zero or more flags, as indicated below: