Find Byte (FINDBYTE)

Instruction Syntax

Bound Program Access

Bound Program Access
`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`

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