ILE COBOL Language Reference
- identifier-3 or literal-1
- The subject field.
- identifier-5 or literal-3
- The substitution field.
The subject field and the substitution field must have the same
length. The following replacement rules apply:
- If the subject field is a figurative constant, it is considered to be a
1-character nonnumeric literal. Each character in the inspected item
equivalent to the figurative constant is replaced by the single-character
substitution field, which must be 1 character in length.
- If the substitution field is a figurative constant, the substitution field
is considered to be the same length as the subject field. Each
non-overlapping occurrence of the subject field in the inspected item is
replaced by the substitution field.
- When the subject and substitution fields are character-strings, each
non-overlapping occurrence of the subject field in the inspected item is
replaced by the character-string specified in the substitution field.
- Once replacement has occurred in a given character position in the
inspected item, no further replacement for that character position is made in
this execution of the INSPECT statement.
When the CHARACTERS phrase is used, literal-3 or identifier-5 must be 1
character in length, and literal-2 or identifier-4 must be 1 character in
length.
When neither the BEFORE nor AFTER phrase is specified, the following
actions take place when the INSPECT REPLACING statement is executed:
- If CHARACTERS is specified, the substitution field must be
1 character in length. Each character in the inspected field is
replaced by the substitution field, beginning at the leftmost character and
continuing to the rightmost.
- If ALL is specified, each non-overlapping occurrence of the subject field
in the inspected item is replaced by the substitution field, beginning at the
leftmost character and continuing to the rightmost.
- If LEADING is specified, each contiguous non-overlapping occurrence of the
subject field in the inspected item is replaced by the substitution field,
provided that the leftmost such occurrence is at the point where comparison
began in the first comparison cycle for which this substitution field is
eligible to participate.
- If FIRST is specified, the leftmost occurrence of the subject
field in the inspected item is replaced by the substitution field.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.