#include <fstring.h>
Public Types | |
enum | CharGroup { kSpace, kNotAlphaNum, kNotAlpha } |
Public Member Functions | |
String () | |
String (const char8 *str, int32 n=-1, bool isTerminated=true) | |
assign n characters of str (-1: all) | |
String (const char16 *str, int32 n=-1, bool isTerminated=true) | |
assign n characters of str (-1: all) | |
String (const String &str, int32 n=-1) | |
assign n characters of str (-1: all) | |
String (const ConstString &str, int32 n=-1) | |
assign n characters of str (-1: all) | |
String (const FVariant &var) | |
assign from FVariant | |
~String () | |
void | updateLength () |
Call this when the string is truncated outside (not recommended though). | |
virtual const char8 * | text8 () const |
virtual const char16 * | text16 () const |
virtual char8 | getChar8 (uint32 index) const |
virtual char16 | getChar16 (uint32 index) const |
bool | setChar8 (uint32 index, char8 c) |
bool | setChar16 (uint32 index, char16 c) |
bool | setChar (uint32 index, char8 c) |
bool | setChar (uint32 index, char16 c) |
String & | operator= (const char8 *str) |
Assign from a string of type char8. | |
String & | operator= (const char16 *str) |
String & | operator= (const ConstString &str) |
String & | operator= (const String &str) |
String & | operator= (char8 c) |
String & | operator= (char16 c) |
String & | assign (const ConstString &str, int32 n=-1) |
Assign n characters of str (-1: all). | |
String & | assign (const char8 *str, int32 n=-1, bool isTerminated=true) |
Assign n characters of str (-1: all). | |
String & | assign (const char16 *str, int32 n=-1, bool isTerminated=true) |
Assign n characters of str (-1: all). | |
String & | assign (char8 c, int32 n=1) |
String & | assign (char16 c, int32 n=1) |
String & | append (const ConstString &str, int32 n=-1) |
Append n characters of str to this (n=-1: all). | |
String & | append (const char8 *str, int32 n=-1) |
Append n characters of str to this (n=-1: all). | |
String & | append (const char16 *str, int32 n=-1) |
Append n characters of str to this (n=-1: all). | |
String & | append (const char8 c, int32 n=1) |
Append char c n times. | |
String & | append (const char16 c, int32 n=1) |
Append char c n times. | |
String & | insertAt (uint32 idx, const ConstString &str, int32 n=-1) |
Insert n characters of str at position idx (n=-1: all). | |
String & | insertAt (uint32 idx, const char8 *str, int32 n=-1) |
Insert n characters of str at position idx (n=-1: all). | |
String & | insertAt (uint32 idx, const char16 *str, int32 n=-1) |
Insert n characters of str at position idx (n=-1: all). | |
String & | insertAt (uint32 idx, char8 c) |
String & | insertAt (uint32 idx, char16 c) |
String & | operator+= (const String &str) |
String & | operator+= (const ConstString &str) |
String & | operator+= (const char8 *str) |
String & | operator+= (const char16 *str) |
String & | operator+= (const char8 c) |
String & | operator+= (const char16 c) |
String & | replace (uint32 idx, int32 n1, const ConstString &str, int32 n2=-1) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end). | |
String & | replace (uint32 idx, int32 n1, const char8 *str, int32 n2=-1) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end). | |
String & | replace (uint32 idx, int32 n1, const char16 *str, int32 n2=-1) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end). | |
int32 | replace (const char8 *toReplace, const char8 *toReplaceWith, bool all=false) |
Replace find string with replace string - returns number of replacements. | |
int32 | replace (const char16 *toReplace, const char16 *toReplaceWith, bool all=false) |
Replace find string with replace string - returns number of replacements. | |
bool | replaceChars8 (const char8 *toReplace, char8 toReplaceBy) |
Returns true when any replacement was done. | |
bool | replaceChars16 (const char16 *toReplace, char16 toReplaceBy) |
bool | replaceChars8 (char8 toReplace, char8 toReplaceBy) |
bool | replaceChars16 (char16 toReplace, char16 toReplaceBy) |
bool | replaceChars (char8 toReplace, char8 toReplaceBy) |
bool | replaceChars (char16 toReplace, char16 toReplaceBy) |
bool | replaceChars (const char8 *toReplace, char8 toReplaceBy) |
bool | replaceChars (const char16 *toReplace, char16 toReplaceBy) |
String & | remove (uint32 index=0, int32 n=-1) |
Remove n characters from string starting at index (n=-1: until end). | |
bool | trim (CharGroup mode=kSpace) |
Trim lead/trail. | |
void | removeChars (CharGroup mode=kSpace) |
Removes all of group. | |
bool | removeChars8 (const char8 *which) |
Remove all occurrences of each char in 'which'. | |
bool | removeChars16 (const char16 *which) |
Remove all occurrences of each char in 'which'. | |
bool | removeChars8 (const char8 which) |
bool | removeChars16 (const char16 which) |
bool | removeChars (const char8 *which) |
bool | removeChars (const char16 *which) |
bool | removeChars (const char8 which) |
bool | removeChars (const char16 which) |
bool | removeSubString (const ConstString &subString, bool allOccurences=true) |
String & | printf (const char8 *format,...) |
Print formatted data into string. | |
String & | printf (const char16 *format,...) |
Print formatted data into string. | |
String & | vprintf (const char8 *format, va_list args) |
String & | vprintf (const char16 *format, va_list args) |
String & | printInt64 (int64 value) |
String & | printFloat (double value) |
bool | incrementTrailingNumber (uint32 width=2, char separator=STR(' '), uint32 minNumber=1, bool applyOnlyFormat=false) |
Increment the trailing number if present else start with minNumber, width specifies the string width format (width 2 for number 3 is 03), applyOnlyFormat set to true will only format the string to the given width without incrementing the founded trailing number. | |
bool | fromVariant (const FVariant &var) |
Assigns string from FVariant. | |
void | toVariant (FVariant &var) const |
bool | fromAttributes (IAttributes *a, IAttrID attrID) |
Assigns string from FAttributes. | |
bool | toAttributes (IAttributes *a, IAttrID attrID) |
void | swapContent (String &s) |
Swaps ownership of the strings pointed to. | |
void | take (String &str) |
Take ownership of the string of 'str'. | |
void | take (void *buffer, bool wide) |
Take ownership of buffer. | |
void * | pass () |
void | passToVariant (FVariant &var) |
Pass ownership of buffer to Variant - sets Variant ownership. | |
void | toLower (uint32 index) |
Lower case the character. | |
void | toLower () |
Lower case the string. | |
void | toUpper (uint32 index) |
Upper case the character. | |
void | toUpper () |
Upper case the string. | |
unsigned char * | toPascalString (unsigned char *buf) |
Pascal string conversion. | |
const String & | fromPascalString (const unsigned char *buf) |
Pascal string conversion. | |
bool | toWideString (uint32 sourceCodePage=kCP_Default) |
Converts to wide string according to sourceCodePage. | |
bool | toMultiByte (uint32 destCodePage=kCP_Default) |
void | fromUTF8 (const char8 *utf8String) |
Assigns from UTF8 string. | |
bool | normalize (UnicodeNormalization=kUnicodeNormC) |
On PC only kUnicodeNormC is working. | |
Protected Member Functions | |
bool | resize (uint32 newSize, bool wide, bool fill=false) |
Extends class ConstString by operations which allow modifications.
enum CharGroup |
String | ( | ) |
String | ( | const char8 * | str, | |
int32 | n = -1 , |
|||
bool | isTerminated = true | |||
) |
assign n characters of str (-1: all)
String | ( | const char16 * | str, | |
int32 | n = -1 , |
|||
bool | isTerminated = true | |||
) |
assign n characters of str (-1: all)
String | ( | const ConstString & | str, | |
int32 | n = -1 | |||
) |
assign n characters of str (-1: all)
String | ( | const FVariant & | var | ) |
assign from FVariant
~String | ( | ) |
void updateLength | ( | ) |
Call this when the string is truncated outside (not recommended though).
const char8 * text8 | ( | ) | const [inline, virtual] |
Reimplemented from ConstString.
const char16 * text16 | ( | ) | const [inline, virtual] |
Reimplemented from ConstString.
char8 getChar8 | ( | uint32 | index | ) | const [inline, virtual] |
Reimplemented from ConstString.
char16 getChar16 | ( | uint32 | index | ) | const [inline, virtual] |
Reimplemented from ConstString.
bool setChar8 | ( | uint32 | index, | |
char8 | c | |||
) |
bool setChar16 | ( | uint32 | index, | |
char16 | c | |||
) |
bool setChar | ( | uint32 | index, | |
char8 | c | |||
) | [inline] |
bool setChar | ( | uint32 | index, | |
char16 | c | |||
) | [inline] |
String& operator= | ( | const char8 * | str | ) | [inline] |
Assign from a string of type char8.
String& operator= | ( | const char16 * | str | ) | [inline] |
String& operator= | ( | const ConstString & | str | ) | [inline] |
String& operator= | ( | char8 | c | ) | [inline] |
String& operator= | ( | char16 | c | ) | [inline] |
String & assign | ( | const ConstString & | str, | |
int32 | n = -1 | |||
) |
Assign n characters of str (-1: all).
String & assign | ( | const char8 * | str, | |
int32 | n = -1 , |
|||
bool | isTerminated = true | |||
) |
Assign n characters of str (-1: all).
String & assign | ( | const char16 * | str, | |
int32 | n = -1 , |
|||
bool | isTerminated = true | |||
) |
Assign n characters of str (-1: all).
String & assign | ( | char8 | c, | |
int32 | n = 1 | |||
) |
String & assign | ( | char16 | c, | |
int32 | n = 1 | |||
) |
String & append | ( | const ConstString & | str, | |
int32 | n = -1 | |||
) |
Append n characters of str to this (n=-1: all).
String & append | ( | const char8 * | str, | |
int32 | n = -1 | |||
) |
Append n characters of str to this (n=-1: all).
String & append | ( | const char16 * | str, | |
int32 | n = -1 | |||
) |
Append n characters of str to this (n=-1: all).
String & append | ( | const char8 | c, | |
int32 | n = 1 | |||
) |
Append char c n times.
String & append | ( | const char16 | c, | |
int32 | n = 1 | |||
) |
Append char c n times.
String & insertAt | ( | uint32 | idx, | |
const ConstString & | str, | |||
int32 | n = -1 | |||
) |
Insert n characters of str at position idx (n=-1: all).
String & insertAt | ( | uint32 | idx, | |
const char8 * | str, | |||
int32 | n = -1 | |||
) |
Insert n characters of str at position idx (n=-1: all).
String & insertAt | ( | uint32 | idx, | |
const char16 * | str, | |||
int32 | n = -1 | |||
) |
Insert n characters of str at position idx (n=-1: all).
String& insertAt | ( | uint32 | idx, | |
char8 | c | |||
) | [inline] |
String& insertAt | ( | uint32 | idx, | |
char16 | c | |||
) | [inline] |
String& operator+= | ( | const ConstString & | str | ) | [inline] |
String& operator+= | ( | const char8 * | str | ) | [inline] |
String& operator+= | ( | const char16 * | str | ) | [inline] |
String& operator+= | ( | const char8 | c | ) | [inline] |
String& operator+= | ( | const char16 | c | ) | [inline] |
String & replace | ( | uint32 | idx, | |
int32 | n1, | |||
const ConstString & | str, | |||
int32 | n2 = -1 | |||
) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end).
String & replace | ( | uint32 | idx, | |
int32 | n1, | |||
const char8 * | str, | |||
int32 | n2 = -1 | |||
) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end).
String & replace | ( | uint32 | idx, | |
int32 | n1, | |||
const char16 * | str, | |||
int32 | n2 = -1 | |||
) |
Replace n1 characters of this (starting at idx) with n2 characters of str (n1,n2=-1: until end).
int32 replace | ( | const char8 * | toReplace, | |
const char8 * | toReplaceWith, | |||
bool | all = false | |||
) |
Replace find string with replace string - returns number of replacements.
int32 replace | ( | const char16 * | toReplace, | |
const char16 * | toReplaceWith, | |||
bool | all = false | |||
) |
Replace find string with replace string - returns number of replacements.
bool replaceChars8 | ( | const char8 * | toReplace, | |
char8 | toReplaceBy | |||
) |
Returns true when any replacement was done.
bool replaceChars16 | ( | const char16 * | toReplace, | |
char16 | toReplaceBy | |||
) |
bool replaceChars8 | ( | char8 | toReplace, | |
char8 | toReplaceBy | |||
) | [inline] |
bool replaceChars16 | ( | char16 | toReplace, | |
char16 | toReplaceBy | |||
) | [inline] |
bool replaceChars | ( | char8 | toReplace, | |
char8 | toReplaceBy | |||
) | [inline] |
bool replaceChars | ( | char16 | toReplace, | |
char16 | toReplaceBy | |||
) | [inline] |
bool replaceChars | ( | const char8 * | toReplace, | |
char8 | toReplaceBy | |||
) | [inline] |
bool replaceChars | ( | const char16 * | toReplace, | |
char16 | toReplaceBy | |||
) | [inline] |
String & remove | ( | uint32 | index = 0 , |
|
int32 | n = -1 | |||
) |
Remove n characters from string starting at index (n=-1: until end).
bool trim | ( | String::CharGroup | group = kSpace |
) |
Trim lead/trail.
void removeChars | ( | CharGroup | mode = kSpace |
) |
Removes all of group.
bool removeChars8 | ( | const char8 * | which | ) |
Remove all occurrences of each char in 'which'.
bool removeChars16 | ( | const char16 * | which | ) |
Remove all occurrences of each char in 'which'.
bool removeChars8 | ( | const char8 | which | ) | [inline] |
bool removeChars16 | ( | const char16 | which | ) | [inline] |
bool removeChars | ( | const char8 * | which | ) | [inline] |
bool removeChars | ( | const char16 * | which | ) | [inline] |
bool removeChars | ( | const char8 | which | ) | [inline] |
bool removeChars | ( | const char16 | which | ) | [inline] |
bool removeSubString | ( | const ConstString & | subString, | |
bool | allOccurences = true | |||
) |
String & printf | ( | const char8 * | format, | |
... | ||||
) |
Print formatted data into string.
String & printf | ( | const char16 * | format, | |
... | ||||
) |
Print formatted data into string.
String & vprintf | ( | const char8 * | format, | |
va_list | args | |||
) |
String & vprintf | ( | const char16 * | format, | |
va_list | args | |||
) |
String & printInt64 | ( | int64 | value | ) |
String & printFloat | ( | double | value | ) |
bool incrementTrailingNumber | ( | uint32 | width = 2 , |
|
char | separator = STR (' ') , |
|||
uint32 | minNumber = 1 , |
|||
bool | applyOnlyFormat = false | |||
) |
Increment the trailing number if present else start with minNumber, width specifies the string width format (width 2 for number 3 is 03), applyOnlyFormat set to true will only format the string to the given width without incrementing the founded trailing number.
bool fromVariant | ( | const FVariant & | var | ) |
Assigns string from FVariant.
void toVariant | ( | FVariant & | var | ) | const |
Reimplemented from ConstString.
bool fromAttributes | ( | IAttributes * | a, | |
IAttrID | attrID | |||
) |
Assigns string from FAttributes.
bool toAttributes | ( | IAttributes * | a, | |
IAttrID | attrID | |||
) |
void swapContent | ( | String & | s | ) |
Swaps ownership of the strings pointed to.
void take | ( | String & | str | ) |
Take ownership of the string of 'str'.
void take | ( | void * | buffer, | |
bool | wide | |||
) |
Take ownership of buffer.
Reimplemented in StringObject.
void * pass | ( | ) |
void passToVariant | ( | FVariant & | var | ) |
Pass ownership of buffer to Variant - sets Variant ownership.
void toLower | ( | uint32 | index | ) |
Lower case the character.
void toLower | ( | ) |
Lower case the string.
void toUpper | ( | uint32 | index | ) |
Upper case the character.
void toUpper | ( | ) |
Upper case the string.
unsigned char * toPascalString | ( | unsigned char * | buf | ) |
Pascal string conversion.
const String & fromPascalString | ( | const unsigned char * | buf | ) |
Pascal string conversion.
bool toWideString | ( | uint32 | sourceCodePage = kCP_Default |
) |
Converts to wide string according to sourceCodePage.
bool toMultiByte | ( | uint32 | destCodePage = kCP_Default |
) |
void fromUTF8 | ( | const char8 * | utf8String | ) |
Assigns from UTF8 string.
bool normalize | ( | UnicodeNormalization | n = kUnicodeNormC |
) |
On PC only kUnicodeNormC is working.
bool resize | ( | uint32 | newSize, | |
bool | wide, | |||
bool | fill = false | |||
) | [protected] |