setlocale.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

setlocale(3C) setlocale(3C)

It should be noted that the locale state is common to all threads within a process.

getlocale_r()

and setlocale_r()

are obsolescent interfaces supported for compatibility with

existing DCE applications. New multithreaded applications should use

getlocale() and setlo-

cale().

Any program that calls

setlocale() before catopen()

with the oﬂag parameter set to

NL_CAT_LOCALE

may behave differently in this release than in previous releases because of the addi-

tion of

LC_MESSAGES to XPG4. In the past,

catopen() was directed to the desired language by LANG.

Now,

catopen() with the oﬂag parameter set to

NL_CAT_LOCALE, is controlled by

LC_MESSAGES.

setlocale() can modify the LC_MESSAGES category. For example, if the environment variables are

set as follows:

LC_MESSAGES="fr_FR.iso88591"

and the following call to setlocale() is made:

setlocale(LC_ALL, "de_DE.iso88591");

followed by a call to catopen(), then

catopen() will open the message catalogs for

de_DE.iso88591

rather than fr_FR.iso88591

If you use

setlocale() and compile/link your application archive on PA-RISC systems, please note

that setlocale() has a dependency on libdld.sl that will require a change to the compile/link

command.

Compile:

cc -Wl,-a,archive -Wl,-E -Wl,+n -l:libdld.sl -o

outﬁle source

Or compile with

CCOPTS and LDOPTS:

export CCOPTS="-Wl,-a,archive

options -Wl,-E -l:libdld.sl"

export LDOPTS="options -E +n -l:libdld.sl"

cc -o outﬁle source

The option

-Wl,-a,archive

is positionally dependent and should occur at the beginning of the com-

pile line. For optimum compatibility in future releases, avoid using archive

libc with other shared

libraries except for

libdld.sl as needed above.

AUTHOR

setlocale(), setlocale_r(),

getlocale(), and getlocale_r() were developed by OSF and

HP.

FILES

/usr/include/langinfo.h

/usr/include/locale.h