Skip to content

Strings

In C3, multiple string types are available, each suited to different use cases.

String

typedef String = inline char[];
  • Strings are usually the typical type to use, they can be sliced, compared etc ... It is possible to access the length of a String instance through the .len operator.

Caution

A String or ZString created from a string literal, e.g. String s = "abc";, refers to constant data. Writing to it is undefined behaviour. Use an array, e.g. char[4] s = "abc";, to get a modifiable copy. See Modifying string literals.

ZString

typedef ZString = inline char*;
  • ZString is used when working with C code, which expects null-terminated C-style strings of type char*. It is a typedef so converting to a ZString requires an explicit cast. This helps to remind the user to check there is appropriate \0 termination of the string data.

Caution

Ensure the terminal \0 when converting from String to ZString.

WString

typedef WString = inline Char16*;
  • The WString type is similar to ZString but uses Char16*, typically for UTF-16 encoded strings. This type is useful for applications where 16-bit character encoding is required.

DString

typedef DString (OutStream) = void*;
  • DString is a dynamic string builder that supports various string operations at runtime, allowing for flexible manipulation without the need for manual memory allocation.