NLGETFILE(3,L)              AIX Technical Reference              NLGETFILE(3,L)



-------------------------------------------------------------------------------
NLgetfile



PURPOSE

Gets parameter file for international character support.

LIBRARY

Standard C Library (libc.a)

SYNTAX

int NLgetfile (filename)
char *filename;

DESCRIPTION

In the multibyte environment, the NLgetfile subroutine is a front-end to
setlocale.  If the variable NLFILE is not defined and the parameter is passed
to it as a NULL pointer, NLgetfile sets the locale to the default C locale;
otherwise, NLgetfile passes the parameter to setlocale and behaves as if
setlocale (LC_ALL, filename) were called (see "setlocale").

RETURN VALUE

When NLgetfile succeeds, 0 is returned.

When NLgetfile does not succeed, -1 is returned.

RELATED INFORMATION

In this book:  "getenv, NLgetenv," "NLgetctab," "setlocale," and
"environment."

"Introduction to International Character Support" in Managing the AIX Operating
System.

AIX Guide to Multibyte Character Set (MBCS) Support.














Processed November 7, 1990      NLGETFILE(3,L)                                1