Complement String (COMSTR)

Built-in number for COMSTR is 452.
COMSTR (
        receiver_string   : address of aggregate(*) for the result of
                            the complement
        source_string     : address of aggregate(*)
        string_length     : unsigned binary(4,8) value which specifies the
                            length of the two strings
)

Description:   Each byte value of the source string, for the number of bytes indicated by string length, is logically complemented on a bit-by-bit basis (i.e. one's complement). The results are placed in the receiver string. If the strings overlap in storage, predictable results occur only if the overlap is fully coincident.

If the space(s) indicated by the two addresses are not long enough to contain the number of bytes indicated by string length, a space addressing violation (hex 0601) is signalled. Partial results in this case are unpredictable.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment

08 Argument/Parameter

• 0801 Parameter Reference Violation

22 Object Access

• 2202 Object Destroyed
• 220B Object Not Available

24 Pointer Specification

• 2401 Pointer Does Not Exist
• 2402 Pointer Type Invalid

44 Protection Violation

• 4401 Object Domain or Hardware Storage Protection Violation
• 4402 Literal Values Cannot Be Changed