 |
» |
|
|
|
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)
|
