qc.hlp (Table of Contents; Topic list)
setlocale
 Summary                                   Up Contents Index Back
────────────────────────────────────────────────────────────────────────────
 
     The setlocale function controls the program's location-dependent
     behavior, such as the formatting of dates or monetary values.
     The <category> argument specifies which groups of functions are
     affected, and the <locale> argument specifies the location whose
     conventions are to be followed.
 
     The <category> argument must be one of the following manifest
     constants, defined in LOCALE.H:
 
     LC_ALL         LC_MONETARY
     LC_COLLATE     LC_NUMERIC
     LC_CTYPE       LC_TIME
 
     (See Locale Categories for more information on these constants.)
 
     The <locale> argument is a pointer to a string specifying the
     name of the locale. If <locale> is an empty string, the locale is
     the implementation-defined native environment. A value of "C"
     specifies the minimal ANSI-conforming environment for C
     translation. This is the only locale supported in Microsoft
     QuickC version 2.5.
 
     If the <locale> argument is a NULL pointer, setlocale returns a
     pointer to the string associated with the category of the
     program's locale. The program's current locale setting is not
     changed.
 
     Return Value
 
     If valid <locale> and <category> arguments are given, setlocale
     returns a pointer to the string associated with the specified
     category for the new locale. If <locale> or <category> is invalid,
     the setlocale function returns a NULL pointer, and the program's
     current locale settings are not changed.
 
     The pointer to a string returned by setlocale can be used in
     subsequent calls to restore that part of the program's locale
     information. Later calls to setlocale overwrite the string.
                                    -♦-