The Copy a Source String Passed by Reference to a Destination
    String routine copies a source string passed by reference to a
    destination string passed by descriptor.

    Format

      STR$COPY_R  destination-string ,word-integer-source-length

                  ,source-string-address

1  –  Corresponding JSB Entry Point

      STR$COPY_R_R8

2  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

3  –  Arguments

 destination-string

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Destination string into which STR$COPY_R copies the source
    string. The destination-string argument is the address of a
    descriptor pointing to the destination string.

    The class field determines the appropriate action.

    See the description of LIB$ANALYZE_SDESC for restrictions
    associated with specific descriptor classes.

 word-integer-source-length

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference

    Length of the source string. The word-integer-source-length
    argument is the address of an unsigned word containing the length
    of the source string.

 source-string-address

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by reference

    Source string that STR$COPY_R copies into the destination string.
    The source-string-address argument is the address of the source
    string.