Find Byte (FINDBYTE)

Built-in number for FINDBYTE is 20.
FINDBYTE (
          source_string      : address of aggregate(*)
          search_character   : signed binary(4) - rightmost byte specifies
                                                  the search character  OR
                               unsigned binary(1)  OR
                               aggregate(1)
) :   space pointer(16) to the first character in the string that matches the
      search character

Description:   The string specified by source string is searched for the value specified by search character. The search terminates when the value is found and a space pointer to the character is returned.

The results are undefined if the source string does not contain the search character.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment

24 Pointer Specification

• 2401 Pointer Does Not Exist

44 Protection Violation

• 4401 Object Domain or Hardware Storage Protection Violation