_klib_String Struct Reference

A variable-length text string in UTF-8 encoding. The string is automatically expanded if required. NULL is an acceptable value for a string, and operations done on NULL strings are generally safe -- the NULL value is silently converted to an empty string when this happens. This conversion is not done in the _new() methods -- a NULL passed to _new() cretes a valid NULL string. However, methods whose names end in _safe() will always upgrade a NULL string to an empty String, so that clients classes need not do specific NULL checks themselves. More...

#include <klib_string.h>

Data Fields
klib_Object	base
char *	str
	The C-languge represention of this UTF-8.

---

Detailed Description

A variable-length text string in UTF-8 encoding. The string is automatically expanded if required. NULL is an acceptable value for a string, and operations done on NULL strings are generally safe -- the NULL value is silently converted to an empty string when this happens. This conversion is not done in the _new() methods -- a NULL passed to _new() cretes a valid NULL string. However, methods whose names end in _safe() will always upgrade a NULL string to an empty String, so that clients classes need not do specific NULL checks themselves.

---

Field Documentation

klib_Object _klib_String::base

char* _klib_String::str

The C-languge represention of this UTF-8.

Note that this value is liable to change as the string's length increases. Callers should not normally modify it

---

The documentation for this struct was generated from the following file:

• klib/include/klib_string.h