FCOUNTRY C-3

NAME

fcountry - establish Country format structure

SYNOPSIS

#include <cbase/dtypes.h>

int fcountry (country)

char *country;

DESCRIPTION

Fcountry establishes a formatting set. When a program starts, the formatting for U.S.A. is already established. This function allows the formatting set to be changed (see NOTES).

Country is a string containing the desired format set name, or, if country is an empty string or a NULL pointer, the current setting of the environment string COUNTRY is used. If COUNTRY is not defined, fcountry returns an error (see DIAGNOSTICS).

The value of country or the environment string COUNTRY can be the name of either an internal format set (using international phone number conventions) or an external format set (naming a country: "usa", "italy", etc.). If the selected country value is invalid (no format set exists for the named value), an error is returned and the last valid internal format set is

used.

This function can be called several times but after the first call no additional work is done unless the country name actually changes.

SEE ALSO

C/Base Reference Manual Chapter 13, "Formatting Data Values"

DIAGNOSTICS

Fcountry returns a negative value on error. If the named country is not defined, FNOENTRY is returned and the last established internal formatting set are used for formatting parameters. The error names are defined in <cbase/dtypes.h>.

NOTES

Before the first formatting function is started, an implicit call is made to this function. This function is provided to allow the calling program to check the setting of COUNTRY and print an error if so desired. Otherwise, errors are silently ignored and the U.S.A. format set remains in use.