VMS Help  —  RTL Routines, STR$  STR$DUPL_CHAR
    The Duplicate Character n Times routine generates a string
    containing n duplicates of the input character. If the
    destination string is an "empty" dynamic-length string
    descriptor, STR$DUPL_CHAR allocates and initializes the string.

    Format

      STR$DUPL_CHAR  destination-string [,repetition-count]

                     [,ASCII-character]

1  –  Corresponding JSB Entry Point

      STR$DUPL_CHAR_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$DUPL_CHAR writes repetition-
    count copies of the input character. The destination-string
    argument is the address of a descriptor pointing to the
    destination string. The maximum length of the destination string
    for a 32-bit descriptor is 2**16-1, or 65,535, bytes.

    On Alpha systems, the maximum length of the destination string
    for all 64-bit descriptor classes, except varying strings, is
    2**64-1 bytes. The maximum length of a varying-length string is
    2**16-1 for both 32-bit and 64-bit descriptors.

 repetition-count

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Number of times ASCII-character is duplicated; this is an
    optional argument (if omitted, the default is 1). The repetition-
    count argument is the address of a signed longword containing the
    number.

 ASCII-character

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

    ASCII character that STR$DUPL_CHAR writes repetition-count times
    into the destination string. The ASCII-character argument is the
    address of a character string containing this character. This is
    an optional argument; if omitted, the default is a space.
Close Help