INTERNATIONAL VERSION
Page 1 (printed 6/20/89)
NL_INIT(S) UNIX System V NL_INIT(S)
Name
nl_init - initialises native language support operation
Syntax
int nl_init(lang)
char *lang;
Description
The nl_init routine is provided as an alternative interface
to the setlocale(S) routine, for programs written to the
X/OPEN Portability Guide standard.
The nl_init routine initialises native language support
operation for the language identified by lang, which is a
pointer to a string containing settings of language,
territory and codeset as defined for the LANG environment
variable (see environ(M)).
Typically, nl_init is used to bind program operation to the
user's specified language requirements, for example:
nl_init(getenv("LANG"));
A call to nl_init will fail if the string pointed to by lang
does not identify a valid language/territory/codeset
combination. In this case, operation will continue for the
language identified on the last successful call.
Return Value
If successful, nl_init will return 0 (zero). Otherwise, -1
will be returned.
See Also
environ(M), locale(M), getenv(S), setlocale(S)
Notes
Calls to nl_init can be used to switch operation from one
supported language to another. It is not necessary to call
nl_init to set the initial language for an application; this
is done by the automatic setlocale call at program startup.
The nl_init routine is not as flexible an interface as that
provided by setlocale.
Value Added
nl_init is an extension of AT&T System V provided by the
Santa Cruz Operation.
(printed 6/20/89)