A Unicode (UTF-8) text string.
|
VuoText | VuoText_makeFromJson (json_object *js) |
|
json_object * | VuoText_getJson (const VuoText value) |
|
char * | VuoText_getSummary (const VuoText value) |
|
VuoText | VuoText_make (const char *unquotedString) |
|
size_t | VuoText_length (const VuoText text) |
|
bool | VuoText_isLessThan (const VuoText text1, const VuoText text2) |
|
bool | VuoText_isLessThanCaseInsensitive (const VuoText text1, const VuoText text2) |
|
bool | VuoText_isLessThanNumeric (const VuoText text1, const VuoText text2) |
|
bool | VuoText_compare (VuoText text1, VuoTextComparison comparison, VuoText text2) |
|
size_t | VuoText_findFirstOccurrence (const VuoText string, const VuoText substring, const size_t startIndex) |
|
size_t | VuoText_findLastOccurrence (const VuoText string, const VuoText substring) |
|
VuoText | VuoText_substring (const VuoText string, int startIndex, int length) |
|
VuoText | VuoText_append (VuoText *texts, size_t textsCount) |
|
VuoText | VuoText_appendWithSeparator (VuoList_VuoText texts, VuoText separator, bool includeEmptyParts) |
|
VuoText * | VuoText_split (VuoText text, VuoText separator, bool includeEmptyParts, size_t *partsCount) |
|
VuoText | VuoText_makeWithMaxLength (const void *data, const size_t maxLength) |
| Creates a VuoText value from an untrusted source (one that might not contain a NULL terminator within its memory page). More...
|
|
VuoText | VuoText_makeFromCFString (const void *cfString) |
| Creates a VuoText value from a CFStringRef . More...
|
|
VuoText | VuoText_makeFromData (const unsigned char *data, const unsigned long size) |
| Attempts to interpret data as UTF-8 text. More...
|
|
VuoText | VuoText_makeFromUtf32 (const uint32_t *data, size_t length) |
| Create a new VuoText string from an array of UTF-32 values. More...
|
|
VuoText | VuoText_makeFromMacRoman (const char *string) |
| Creates a new VuoText from a MacRoman-encoded string. More...
|
|
size_t | VuoText_byteCount (const VuoText text) |
| Returns the number of bytes in the text, not including the null terminator. More...
|
|
bool | VuoText_isEmpty (const VuoText text) |
| Returns true if text is empty (is NULL or is non-NULL with zero length). More...
|
|
bool | VuoText_isPopulated (const VuoText text) |
| Returns true if text is not empty. More...
|
|
bool | VuoText_areEqual (const VuoText text1, const VuoText text2) |
| Returns true if the two texts represent the same Unicode string (even if they use different UTF-8 encodings or Unicode character decompositions). More...
|
|
VuoList_VuoInteger | VuoText_findOccurrences (const VuoText string, const VuoText substring) |
| Returns a list containing all occurrences of substring in string . More...
|
|
VuoText | VuoText_insert (const VuoText string, int startIndex, const VuoText newText) |
| Returns a new string with newText inserted at the startIndex . More...
|
|
VuoText | VuoText_removeAt (const VuoText string, int startIndex, int length) |
| Returns a new string where characters from startIndex to startIndex + length are removed. More...
|
|
VuoText | VuoText_replace (VuoText subject, VuoText stringToFind, VuoText replacement) |
| Returns a new string in which each occurrence of stringToFind in subject has been replaced with replacement . More...
|
|
VuoText | VuoText_truncateWithEllipsis (const VuoText subject, int maxLength, VuoTextTruncation where) |
| If subject is less than or equal to maxLength Unicode characters long, returns subject . More...
|
|
VuoText | VuoText_trim (const VuoText text) |
| Returns a new string consisting of text without the whitespace at the beginning and end. More...
|
|
VuoText | VuoText_changeCase (const VuoText text, VuoTextCase textCase) |
| Returns a new string with the text characters cased in the textCase style. More...
|
|
uint32_t * | VuoText_getUtf32Values (const VuoText text, size_t *length) |
| Returns an array of unicode 32 bit decimal values for each character in a string. More...
|
|
char * | VuoText_format (const char *format,...) VUOTEXT_FORMAT_ATTRIBUTE |
| Returns a new string formatted using the printf-style format string. More...
|
|
VuoText | VuoText_makeFromString (const char *str) |
| Automatically generated function. More...
|
|
char * | VuoText_getString (const VuoText value) |
| Automatically generated function. More...
|
|
void | VuoText_retain (VuoText value) |
| Automatically generated function. More...
|
|
void | VuoText_release (VuoText value) |
| Automatically generated function. More...
|
|
VuoText VuoText_makeWithMaxLength |
( |
const void * |
data, |
|
|
const size_t |
maxLength |
|
) |
| |
Creates a VuoText value from an untrusted source (one that might not contain a NULL terminator within its memory page).
Use this, for example, to safely handle a string that's part of a network packet.
If data
ends with a NULL terminator, this function simply copies it into a new VuoText instance.
If data
does not end with a NULL terminator, this function scans up to maxLength
bytes in data
. If it finds a NULL terminator, it returns text up to and including the NULL terminator. If it doesn't find a NULL terminator, it returns maxLength
characters followed by a NULL terminator.
If data
is in a multi-byte UTF8 character sequence when maxLength
is reached, the sequence will be terminated partway, probably resulting in an invalid UTF8 sequence.
Definition at line 153 of file VuoText.c.
VuoText VuoText_substring |
( |
const VuoText |
string, |
|
|
int |
startIndex, |
|
|
int |
length |
|
) |
| |
Returns the substring of string
starting at index startIndex
and spanning length
Unicode characters.
startIndex
is indexed from 1, not 0.
If startIndex is past the end of string, returns the empty string.
If startIndex is before the beginning of string, deducts the number of characters before the beginning from length, and returns characters starting at the beginning of string.
If string has fewer than length characters from startIndex to the end of string, returns all characters from startIndex to the end of string.
Definition at line 691 of file VuoText.c.