HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

401

402

403

404

405

406

407

408

409

410

setlocale(3C) setlocale(3C)

The structure returned through a call to

getlocale() is overwritten during the next call to getlo-

cale()

. Be sure to save these values if they are to be used after a subsequent

getlocale() call.

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 addition

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, 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 compile

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