HP 3000 Manuals HP 3000 Manuals
NLREPCHAR
NM and CM callable.
Replaces all nondisplayable control characters in the string with the
replacement character. Nondisplayable characters are those with
attribute 3 (undefined graphic character) or 5 (control code), as
returned by itemnum=12 of the NLINFO intrinsic.
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
* 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
Commands None
Manuals Native Language Programmer's Guide (32650-90022)