Browse Prior Art Database

Language Independent Interface for Handling Concurrent Dual Currencies Within the Same Locale

IP.com Disclosure Number: IPCOM000014018D
Original Publication Date: 2001-May-30
Included in the Prior Art Database: 2003-Jun-19
Document File: 4 page(s) / 99K

Publishing Venue

IBM

Abstract

Disclosed is a language independent service that converts numeric values to monetary strings while catering for concurrent dual currency formats. There is a need to support dual currency formats concurrently as witnessed recently in some European countries requiring the concurrent support of the national currency and the regional EURO currency. This service relies on a locale to provide localization at run time to cater to local preferences. The service is designed as a procedure call to allow its use by a wide number of programming languages on a variety of processing platforms. The syntax of the service ACEEFMON is: Syntax void ACEEFMON [Locale_Handle], String_in, Maxsize, Format, String_out, Result, [fc] ACEE_HANDLE *Locale_Handle; COMPLEX16 *String_in;

This text was extracted from a PDF file.
This is the abbreviated version, containing approximately 47% of the total text.

Page 1 of 4

  Language Independent Interface for Handling Concurrent Dual Currencies Within the Same Locale

Disclosed is a language independent service that converts numeric values to monetary strings while catering for concurrent dual currency formats. There is a need to support dual currency formats concurrently as witnessed recently in some European countries requiring the concurrent support of the national currency and the regional EURO currency. This service relies on a locale to provide localization at run time to cater to local preferences. The service is designed as a procedure call to allow its use by a wide number of programming languages on a variety of processing platforms. The syntax of the service (ACEEFMON) is:

Syntax void ACEEFMON ([Locale_Handle], String_in, Maxsize,

            Format, String_out, Result, [fc]) ACEE_HANDLE *Locale_Handle;

COMPLEX16 *String_in;

     INT4 *Maxsize; VSTRING *Format; VSTRING *String_out; INT4 *Result; FEED_BACK *fc;

where: Locale_Handle (input/optional)

    Points to the locale to be used by this service. If none is specified, the current active locale is used.

String_in (input)

    Contains the value of the string to be formatted. Maxsize (input)

    Specifies the maximum number of bytes (including the string terminator) that may be placed in the String_out parameter.

Format (input)

Contains the input numeric characters and the conversion specifications.

The FORMAT parameter specifies a character string that can contain plain characters and conversion specifications. Plain characters are copied to the output stream. Conversion specifications result in the fetching of the String_in argument which is converted and formatted. The results are undefined if there are insufficient arguments for the FORMAT parameter. If the FORMAT parameter is exhausted while arguments remain, the excess arguments are ignored. A conversion specification consists of a percent character (%), optional flags, optional field width, optional left precision, optional right precision, and a required conversion character that determines the conversion to be performed.

1

Page 2 of 4

Flags Action

= f An = followed by a single character f specifies that the character f should be used as the numeric fill character. The default numeric fill character is the space character. This option does not affect other fill operations, such as field-width filling, which always uses the space as the fill character.

 ^ Do not format the currency amount with the grouping characters. The default is to insert the grouping characters if defined for the current locale.
+ or ( Specifies the style of representing positive and negative currency amounts. Only one of + or ( may be specified. If + is specified, the locale's equivalent of + and - are used (for example, in USA: the empty (null) string when positive and - (minus sign) if negative). If ( is specified, the locale's equivalent of enclosing negative amounts within parenthesis is used. If this option is not included, a default spe...