At v0.1.0

Package: Text

Signature

func At(self, index: uint) -> char8;

Parameters

Returns

The byte at index, or the null character ('\0') when index is at or past Length — an out of range read reports rather than running off the end of the block. A null character is therefore ambiguous: it is also what a string that really holds one reports.

The index is a byte offset, not a character offset, so indexing into a multi-byte UTF-8 sequence yields one byte of it rather than the character.

Example

import Text::String;

func Main() -> int {
    var text = String::From("Rux");

    text.At(0); // 'R'
    text.At(2); // 'x'
    text.At(9); // '\0' -- out of range

    text.Free();
    return 0;
}

See also

• String — the string type
• Length — the bound the index is checked against
• Substring — copy a range of bytes rather than read one
• Data — the bytes without the bounds check