decode

Decodes a single code point.

This function removes one or more code units from the start of a string, and returns the decoded code point which those code units represent.

The input to this function MUST be validly encoded. This is enforced by the function's in-contract.

Supersedes: This function supersedes std.utf.decode(), however, note that the function codePoints() supersedes it more conveniently.