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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

351

352

353

354

355

356

357

358

359

360

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

setlocale(3C) setlocale(3C)

getlocale() and setlocale() are thread-safe. 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

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