HELPLIB.HLB  —  RTL Routines, STR$  STR$POS_EXTR
    The Extract a Substring of a String routine copies a substring of
    a source string into a destination string.

    Format

      STR$POS_EXTR  destination-string ,source-string ,start-position

                    ,end-position

1  –  Corresponding JSB Entry Point

      STR$POS_EXTR_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$POS_EXTR copies the substring.
    The destination-string argument is the address of a descriptor
    pointing to the destination string.

 source-string

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

    Source string from which STR$POS_EXTR extracts the substring that
    it copies into the destination string. The source-string argument
    is the address of a descriptor pointing to the source string.

 start-position

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference for CALL entry point, by value for JSB
                  entry point

    Relative position in the source string at which STR$POS_EXTR
    begins copying the substring. The start-position argument is the
    address of a signed longword containing the starting position.

 end-position

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference for CALL entry point, by value for JSB
                  entry point

    Relative position in the source string at which STR$POS_EXTR
    stops copying the substring. The end-position argument is the
    address of a signed longword containing the ending position.
Close Help