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



-------------------------------------------------------------------------------
NLxin



PURPOSE

Performs EBCDIC-to-ASCII translation.

LIBRARY

Standard C Library (libc.a)

SYNTAX

int
NLxin (s1, s2, n)
char *s1, *s2;
int n;

DESCRIPTION

The NLxin routine performs EBCDIC-to-ASCII translation based on the translation
table named by the environment variable NLIN.  If NLIN is not defined or is
invalid, NLxin uses the default universal EBCDIC-to-ASCII translation table.

s1 is a pointer to an output buffer used to store the translated ASCII data.

s2 is a pointer to the null-terminated EBCDIC character data to be translated.

n is the count of the number of bytes available in s1.

NLxin uses the value of the environment variable NLIN as a path name to the
EBCDIC-to-ASCII translation table.  (The inspection of the environment variable
NLIN is performed only at the first invocation of NLxin within a process.
Subsequent invocations of NLxin from the same process will use the translation
table obtained at the first invocation.)

The byte values from the array s2 are used to index into the translation table
to obtain the ASCII byte that is placed into the character array pointed to by
s1.  The translation proceeds on a byte-by-byte basis until a null-byte is
encountered in the array pointed to by s2, or n bytes have been placed in the
array pointed to by s1.

RETURN VALUE

NLxin returns the number of bytes placed in s1.

RELATED INFORMATION

The axeb, ebxa, and genxlt commands in AIX Operating System Commands Reference.




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

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



The discussion on environment variables in AIX Operating System Programming
Tools and Interfaces.





















































Processed November 7, 1990        NLXIN(3,L)                                  2