Operator [] (String Index)
 
Returns a reference to a character in a string

Syntax

Declare Operator [] ( ByRef lhs As String, ByRef rhs As Integer ) As UByte
Declare Operator [] ( ByRef lhs As ZString, ByRef rhs As Integer ) As UByte
Declare Operator [] ( ByRef lhs As WString, ByRef rhs As Integer ) As T

Note that Operator {} (String index) returns a reference. See [CompilerFAQ Compiler FAQ]].

Usage

result = lhs [ rhs ]

Parameters

lhs
The string.
rhs
A zero-based offset from the first character.
T
The wide-character type (varies per platform).

Description

This operator returns a reference to a specific character in a string:
    • This operator must not be used in case of empty string because reference is undefined (inducing runtime error).
    • Otherwise, the user must ensure that the index does not exceed the range "[0, Len(lhs) - 1]". Outside this range, results are undefined.

Example

Dim a As String = "Hello, world!"
Dim i As Integer

For i = 0 To Len(a) - 1
    Print Chr(a[i]);
Next i
Print


Will print
Hello, world!

Differences from QB

  • New to FreeBASIC

See also