MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 9 563
Command Definitions (MAIL-PUTJCW)
NLSUBSTR
NLSUBSTR
NM and CM callable.
Extracts
movelength bytes from the instring to the outstring .
Syntax
CA I16V CA I16
NLSUBSTR(
instring,inlength,outstring,outlength,
I16V 16V I16V
startposition,movelength,langnum,
I16V U16A U16A
flags,error , charset );
Parameters
instring character array (required)
Contains the string from which the substring is extracted. The string can
contain both 1 byte and 2 byte Asian characters.
inlength 16-bit signed integer by value (required)
Contains the length, in bytes, of
instring .
outstring character array (required)
Indicates where
substring is placed.
outlength 16-bit signed integer by reference (required)
Passes the length, in bytes, of
outstring . After a successful call,
outlength returns the actual length of the substring moved to outstring .
startposition 16-bit signed integer by value (required)
Contains the offset into
instring where the substring starts. A value of
zero is the beginning point.
movelength 16-bit signed integer by value (required)
Passes the length, in bytes, of the substring.
langnum 16-bit signed integer by value (required)
Contains the language ID number.
flags 16-bit signed integer by value (required)
Contains the flag word, and is used primarily with Asian languages. It is
meaningless with 1 byte languages. It is used when special treatment is
required:
Bits Value/Meaning
12:4 Used if the first character of a substring is the second byte of a 2 byte