Copy Null-Terminated String (STRCPYNULL)

Instruction Syntax

Built-in number for STRCPYNULL is 11.
STRCPYNULL (                                                                    
            target_string                   : address of aggregate(*)           
            null_terminated_source_string   : address of aggregate(*)           
) :   space pointer(16) to the target string                                            

Description:

A copy is performed from the storage specified by null terminated source string to the storage specified by target string. The copy terminates after a null (ie. zero) character has been copied. It is expected that sufficient storage exists at the location specified by target string.

Undefined results can occur if the storage locations specified by target string and null terminated source string overlap.

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