/** @file  ../include/monetary.h

 @internalComponent

 */

 /** @fn  strfmon(char *  s, size_t maxsize, const char *  format, ...)

 @param s

 @param maxsize

 @param format

 @param ...

 @return   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.

 @code

  = f A ' = '

  character followed by another character f which is used as the numeric fill character.

  ^ Do not use grouping characters, regardless of the current locale default.

  + Represent positive values by prefixing them with a positive sign,

  and negative values by prefixing them with a negative sign.

  This is the default.

  ( Enclose negative values in parentheses.

  ! Do not include a currency symbol in the output.

  - Left justify the result.

  Only valid when a field width is specified.

 @endcode

 @code

  i The double

  argument is formatted as an international monetary amount.

  n The double

  argument is formatted as a national monetary amount.

  % A '%'

  character is written.

 @endcode

   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.

  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: Zero or more of the following flags: = f A ' = '

 character followed by another character f which is used as the numeric fill character. ^ Do not use grouping characters, regardless of the current locale default. + Represent positive values by prefixing them with a positive sign,

 and negative values by prefixing them with a negative sign.

 This is the default. ( Enclose negative values in parentheses. ! Do not include a currency symbol in the output. - Left justify the result.

 Only valid when a field width is specified. An optional minimum field width as a decimal number.

 By default, there is no minimum width. A ' \# '

 sign followed by a decimal number specifying the maximum

 expected number of digits after the radix character. A ' . '

 character followed by a decimal number specifying the number

 the number of digits after the radix character. One of the following conversion specifiers: i The double

 argument is formatted as an international monetary amount. n The double

 argument is formatted as a national monetary amount. \% A '\%'

 character is written.

 Examples:

 @code

 #include <string.h>

 #include <stdio.h>

 #include <monetary.h>

 int main()

 {

     char buf[50];

     strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]",1234.567, 1234.567);

     printf("%s

 ",buf);

 }

 @endcode

  Output

 @code

 [ **1234.57] [ **1234.57]

 @endcode

 @see localeconv()

 @publishedAll

 @externallyDefinedApi

 */