NLgetctab

Purpose

     Finds  and maps  character  collating and  classification
     tables to code points.

Library

     Standard C Library (libc.a)

Syntax

     void NLgetctab (ctfile)
     char *ctfile;

Description

     The NLgetctab subroutine locates  a table file containing
     character  collation and  classification information  and
     maps it  into memory.   AIX provides  international char-
     acter support for  character collation and classification
     in  a ctype  style,  that can  be  user-configured for  a
     process.

     If ctfile  parameter is not  a null value, then  the file
     name given  is the  name of the  file used  for character
     collation  and classification.   If ctfile  is null,  the
     value  of  the environment  variable  NLCTAB  is used  to
     specify the table  file; if NLCTAB is  undefined or null,
     the default file /etc/nls/ctab/default is used.

     The  default  compilation  procedure  builds  a  call  to
     NLgetctab into the runtime startup  code of a program, so
     applications  do  not  normally have  to  call  NLgetctab
     explicitly.   If an  application does  not refer  to col-
     lating and  classification information, the  startup code
     reference is satisfied by a  dummy module; the table file
     is only mapped when needed.

Related Information

     In this book:   "NCcollate, NCcoluniq, NCeqvmap, _NCxcol,
     _NLxcol" and "environment."

     The ctab command in  AIX Operating System Commands Refer-
     ence.

     "Overview of International Character Support" in Managing
     the AIX Operating System.