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.