#include <unicode.h>
Inheritance diagram for ucommon::UString:
Protected Member Functions | |
void | add (unicode_t unicode) |
Add (append) unicode to a utf8 encoded string. | |
ucs4_t | at (int position) |
Return unicode character found at a specific codepoint in the string. | |
unsigned | ccount (ucs4_t character) |
Count occurrences of a unicode character in string. | |
UString | copy (strsize_t offset, strsize_t size) |
Convenience method for substring extraction. | |
strsize_t | count (void) |
Count codepoints in current string. | |
void | cut (strsize_t offset, strsize_t size=0) |
Cut (remove) text from string using codepoint offsets. | |
char * | find (ucs4_t character, strsize_t start=0) |
Find first occurrence of character in string. | |
size_t | get (unicode_t unicode, size_t size) |
Extract a unicode byte sequence from utf8 object. | |
UString | get (strsize_t codepoint, strsize_t size=0) |
Get a new string object as a substring of the current object. | |
UString | left (strsize_t size) |
Convenience method for left of string. | |
char * | operator() (int offset) |
Reference a string in the object by codepoint offset. | |
UString | operator() (int codepoint, strsize_t size) |
Get a new substring through object expression. | |
size_t | operator() (unicode_t unicode, size_t size) |
Extract a unicode byte sequence from utf8 object. | |
ucs4_t | operator[] (int position) |
Reference a unicode character in string object by array offset. | |
void | paste (strsize_t offset, char *text, strsize_t size=0) |
Insert (paste) text into string using codepoint offsets. | |
char * | rfind (ucs4_t character, strsize_t end=npos) |
Find last occurrence of character in string. | |
UString | right (strsize_t offset) |
Convenience method for right of string. | |
void | set (unicode_t unicode) |
Set a utf8 encoded string based on unicode data. | |
UString (UString &existing) | |
Construct a copy of a string object. | |
UString (unicode_t *text, unicode_t *end) | |
Create a string for a substring. | |
UString (char *text, strsize_t size) | |
Create a string from null terminated text up to a maximum specified size. | |
UString (unicode_t text) | |
Create a utf8 aware string for a null terminated unicode string. | |
UString (strsize_t size) | |
Create an empty string with a buffer pre-allocated to a specified size. | |
UString () | |
Create a new empty utf8 aware string object. | |
virtual | ~UString () |
Destroy string. |
This is derived from the classic uCommon String class by adding operations that are utf8 encoding aware.
Definition at line 193 of file unicode.h.
ucommon::UString::UString | ( | strsize_t | size | ) | [protected] |
Create an empty string with a buffer pre-allocated to a specified size.
size | of buffer to allocate. |
ucommon::UString::UString | ( | unicode_t | text | ) | [protected] |
Create a utf8 aware string for a null terminated unicode string.
text | of ucs4 encoded data. |
ucommon::UString::UString | ( | char * | text, | |
strsize_t | size | |||
) | [protected] |
Create a string from null terminated text up to a maximum specified size.
text | to use for string. | |
size | limit of new string. |
Create a string for a substring.
The end of the substring is a pointer within the substring itself.
text | to use for string. | |
end | of text in substring. |
ucommon::UString::UString | ( | UString & | existing | ) | [protected] |
Construct a copy of a string object.
Our copy inherits the same reference counted instance of cstring as in the original.
existing | string to copy from. |
virtual ucommon::UString::~UString | ( | ) | [protected, virtual] |
Destroy string.
De-reference cstring. If last reference to cstring, then also remove cstring from heap.
void ucommon::UString::add | ( | unicode_t | unicode | ) | [protected] |
ucs4_t ucommon::UString::at | ( | int | position | ) | [protected] |
Return unicode character found at a specific codepoint in the string.
position | of codepoint in string, negative values computed from end. |
Reimplemented from ucommon::String.
unsigned ucommon::UString::ccount | ( | ucs4_t | character | ) | [protected] |
Count occurrences of a unicode character in string.
character | code to search for. |
Convenience method for substring extraction.
offset | into string. | |
size | of string to return. |
Reimplemented from ucommon::String.
Definition at line 316 of file unicode.h.
References ucommon::String::operator()().
Here is the call graph for this function:
strsize_t ucommon::UString::count | ( | void | ) | [inline, protected] |
Count codepoints in current string.
Reimplemented from ucommon::String.
Definition at line 355 of file unicode.h.
References ucommon::str().
Here is the call graph for this function:
Cut (remove) text from string using codepoint offsets.
offset | to start of text field to remove. | |
size | of text field to remove or 0 to remove to end of string. |
Reimplemented from ucommon::String.
Find first occurrence of character in string.
character | code to search for. | |
start | offset in string in codepoints. |
size_t ucommon::UString::get | ( | unicode_t | unicode, | |
size_t | size | |||
) | [protected] |
Extract a unicode byte sequence from utf8 object.
unicode | data buffer. | |
size | of data buffer. |
Get a new string object as a substring of the current object.
codepoint | offset of substring. | |
size | of substring in codepoints or 0 if to end. |
Reimplemented from ucommon::String.
Convenience method for left of string.
size | of substring to gather in codepoints. |
Reimplemented from ucommon::String.
Definition at line 299 of file unicode.h.
References ucommon::String::operator()().
Here is the call graph for this function:
char* ucommon::UString::operator() | ( | int | offset | ) | [protected] |
Reference a string in the object by codepoint offset.
Positive offsets are from the start of the string, negative from the end.
offset | to string position. |
Reimplemented from ucommon::String.
Get a new substring through object expression.
codepoint | offset of substring. | |
size | of substring or 0 if to end. |
Reimplemented from ucommon::String.
size_t ucommon::UString::operator() | ( | unicode_t | unicode, | |
size_t | size | |||
) | [inline, protected] |
Extract a unicode byte sequence from utf8 object.
unicode | data buffer. | |
size | of data buffer. |
Definition at line 283 of file unicode.h.
References ucommon::String::get().
Here is the call graph for this function:
ucs4_t ucommon::UString::operator[] | ( | int | position | ) | [inline, protected] |
Reference a unicode character in string object by array offset.
position | of codepoint offset to character. |
Reimplemented from ucommon::String.
Insert (paste) text into string using codepoint offsets.
offset | to start paste. | |
text | to paste. | |
size | of text to paste. |
Reimplemented from ucommon::String.
Find last occurrence of character in string.
character | code to search for. | |
end | offset to start from in codepoints. |
Convenience method for right of string.
offset | of substring from right in codepoints. |
Reimplemented from ucommon::String.
Definition at line 307 of file unicode.h.
References ucommon::String::operator()().
Here is the call graph for this function:
void ucommon::UString::set | ( | unicode_t | unicode | ) | [protected] |