NLREPCHAR

Syntax

             CA        CA         I16V
  NLREPCHAR (inbuffer, outbuffer, bufferlength,
             CV           I16V     U16A   U16A
             replacechar, langnum, 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

* Does 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