NLREPCHAR

Syntax

             CA        CA         I16V          CV           I16V
  NLREPCHAR (inbuffer, outbuffer, bufferlength, replacechar, langnum,
  
    U16A   U16A
    error, charset);

Parameters

inbuffer

character array (required)

Passes the nondisplayable characters to be replaced.

outbuffer

character array (required)

Returns the replaced character string.

bufferlength

16-bit signed integer by value (required)

Passes the length, in bytes, of inbuffer.

replacechar

character by value (required)

Contains the replacement character to be used.

langnum

16-bit signed integer by value (required)

Contains the language ID number.

error

16-bit unsigned integer array (required)

Returns two elements: the first element is the error number; the second element is reserved and always returns 0. The possible error number values are:

Value

Meaning

0

Successful

1

*NLS not installed

2

*Specified language not configured

3

Invalid replacement character

4

Invalid length parameter

5

*NLS internal error

6

*NLS internal error

7

Invalid charset table entry

8

Overlapping strings, outbuffer overwrites inbuffer

* Do not apply to calls with a langnum equal to 0 (NATIVE3000/XL).

charset

16-bit unsigned integer array (optional)

Passes the character set definition for the language used, as returned in NLINFO itemnum= 12. If this parameter is present, langnum is ignored, and this intrinsic is more efficient.

Related Information

Intrinsics

NLCOLLATE, NLKEYCOMPARE, NLSCANMOVE, NLSWITCHBUF, NLSTRANSLATE

Manual

Native Language Programmer's Guide