String function (LotusScript® Language)

Returns a string consisting of a particular character repeated a number of times. The character is specified as a string, or a value interpreted as a locale-sensitive ASCII character code.

Syntax

String[$] ( stringLen , { charCode | stringExpr } )

Elements

stringLen

A numeric expression whose value is the number of characters to put in the returned string. LotusScript® rounds stringLen to the nearest integer.

charCode

A numeric expression of data type Long. If LotusScript® is running on a native ASCII platform, the value is interpreted as a code in the platform-native character set. If LotusScript® is running on a native EBCDIC platform, the value is interpreted as the ASCII equivalent for the platform's current locale. Both single-byte and double-byte characters are acceptable.

stringExpr

Any string expression. The first character in this string is the character to be used in the returned string.

Return value

String returns a Variant of DataType 8 (String), and String$ returns a String.

Example