1034
Text String Processing Instructions Section 3-31
Description Within the text string designated by S1, INS$(657) inserts the text string des-
ignated by S2, after the beginning word designated by S3, and outputs the
result to D as text string data (with NUL added at the end).
The maximum number of characters that can be inserted is 4,095 (0FFF hex).
If there are more than that, only 4,095 characters will be output to D (with NUL
added as the 4,096th character).
If either S1 or S2 is NUL, then the text string designated by the other one of
them will be output to D just as it is. If S1 and S2 are both NUL, then two NUL
characters (0000 hex) will be output to D.
Flags
Precautions The maximum number of characters for S1 and S2 is 4,095 (0FFF hex). If
there are more than that (i.e., if there is no NUL before the 4,096th character),
an error will be generated and the Error Flag will turn ON.
The range for the beginning position designated by S3 is 0 to 4,095. If the set-
ting is outside of this range, an error will be generated and the Error Flag will
turn ON.
If 0000 (hex) is output to D, the Equals Flag will turn ON.
Do not overlap the destination words designated by D with the text string data
designated by S2. If these overlap, the operation will not be executed properly.
Example In this example, INS$(657) is used to insert two characters.
→
→
Inserted characters
→
Name Label Operation
Error Flag ER ON if more than 4,095 characters are designated by S1 or
S2.
ON if S3 exceeds 4,095 (0FFF hex).
ON if the Communications Port Enabled Flag for the com-
munications port number specified as the Com Port num-
ber for Background Execution is OFF when background
processing is specified (CP1H only).
OFF in all other cases.
Equals Flag = ON if 0000 (hex) is output to D.
OFF in all other cases.
S2: D200
S3: D400
S1: D100
D101
D102
D103
D104
D: D300
D301
D302
D303
D304
D305
D100
D200
D400
D300
Text string ABCDEFJKGHI
Text string JK
Text string ABCDEFGHI
To Next Page
Loading...
