StrSetChar

Sets a single character into a string or buffer. Use this function to build up a string, character by character, and terminate the string with the end-of-string character 0 (zero). (If you use a string without a terminator in a function that expects a string, or in a Cicode expression, you could get invalid results.) To use the string to build up a buffer, you do not need the terminating 0 (zero).

Syntax

StrSetChar(sText, iOffset, Char)

sText:

The destination string. Must be a String type variable.

iOffset:

The offset in the string, commencing at 0.

Char:

The ASCII character to set into the string.

Return Value

0 (zero) if successful, otherwise an error code is returned.

Related Functions

StrGetChar

Example

! Set chars in buffer, Buf is NOT a valid string

! and cannot be used where a normal string would be used.

FOR i = 0 To length DO

StrSetChar(Buf, i, 30 + i);

END

StrSetChar(sStr, 0, 13); ! put CR into string

StrSetChar(sStr, 1, 0); ! terminate so may be used as a normal string

See Also

String Functions

Using the Caret Escape Sequence Character