|
| String (void) noexcept |
| Creates an empty string.
|
|
| String (const String &rInput) noexcept |
| Initialize a Burger::String with a Burger::String.
|
|
| String (String &&rInput) noexcept |
| Copy constructor.
|
|
String & | operator= (String &&rInput) noexcept |
| Copy assignment operator.
|
|
| String (const String &rInput, uintptr_t uStart, uintptr_t uLength) noexcept |
| Initialize a Burger::String by using a subsection of a different Burger::String.
|
|
| String (const char *pInput) noexcept |
| Initialize with a "C" string.
|
|
| String (const char *pInput, uintptr_t uPadding) noexcept |
| Initialize with a "C" string with padding.
|
|
| String (const uint16_t *pInput) noexcept |
| Initialize with a UTF16 string.
|
|
| String (const uint32_t *pInput) noexcept |
| Initialize with a UTF32 string.
|
|
| String (const char *pInput, uintptr_t uStart, uintptr_t uEnd) noexcept |
| Initialize a Burger::String by using a subsection of a different "C" string.
|
|
| String (char iInput) noexcept |
| Initialize a Burger::String with a single character.
|
|
| String (char iInput, uintptr_t uFillSize) noexcept |
| Initialize a Burger::String filled with a single character.
|
|
| String (const char *pInput1, const char *pInput2) noexcept |
| Initialize a Burger::String with two concatenated "C" strings.
|
|
| String (const char *pInput1, const char *pInput2, const char *pInput3) noexcept |
| Initialize a Burger::String with three concatenated "C" strings.
|
|
| String (const char *pInput1, const char *pInput2, const char *pInput3, const char *pInput4) noexcept |
| Initialize a Burger::String with four concatenated "C" strings.
|
|
| String (const char *pFmt, BURGER_SP_ARG1) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG2) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG3) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG4) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG5) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG6) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG7) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG8) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG9) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG10) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG11) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG12) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG13) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG14) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG15) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG16) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG17) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG18) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG19) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG20) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG21) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG22) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG23) noexcept |
|
| String (const char *pFmt, BURGER_SP_ARG24) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG1) noexcept |
| String.Printf(const char* pFmt, ....
|
|
void | Printf (const char *pFmt, BURGER_SP_ARG2) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG3) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG4) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG5) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG6) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG7) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG8) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG9) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG10) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG11) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG12) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG13) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG14) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG15) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG16) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG17) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG18) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG19) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG20) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG21) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG22) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG23) noexcept |
|
void | Printf (const char *pFmt, BURGER_SP_ARG24) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG1) noexcept |
| String.Printf(const String& pFmt, ....
|
|
void | Printf (const String &sFmt, BURGER_SP_ARG2) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG3) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG4) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG5) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG6) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG7) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG8) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG9) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG10) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG11) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG12) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG13) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG14) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG15) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG16) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG17) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG18) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG19) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG20) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG21) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG22) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG23) noexcept |
|
void | Printf (const String &sFmt, BURGER_SP_ARG24) noexcept |
|
| ~String (void) |
| Release memory, if any.
|
|
| operator char * () noexcept |
| Return the pointer to the string.
|
|
| operator const char * () const noexcept |
| Return the const pointer to the string.
|
|
const char * | c_str (void) const noexcept |
| Return the const pointer to the string.
|
|
char * | c_str (void) noexcept |
| Return the pointer to the string.
|
|
const char * | data (void) const noexcept |
| Return the const pointer to the string.
|
|
char * | data (void) noexcept |
| Return the pointer to the string.
|
|
| operator char () const noexcept |
| Return the first character of the "C" string.
|
|
uintptr_t | length (void) const noexcept |
| Return the length of the "C" string.
|
|
uintptr_t | size (void) const noexcept |
| Return the length of the "C" string.
|
|
uintptr_t | capacity (void) const noexcept |
| Return the size of the buffer.
|
|
uint_t | empty (void) const noexcept |
| Return TRUE if the string is empty.
|
|
eError | assign (uintptr_t uLength, char iInput) noexcept |
| Fill the string with a character.
|
|
eError | assign (const String &rInput) noexcept |
| Copy a String into this string.
|
|
void | assign (String &&rInput) noexcept |
| Move a String into this string.
|
|
eError | assign (const char *pInput) noexcept |
| Copy a "C" string to a Burger::String.
|
|
eError | assign (const char *pInput, uintptr_t uLength) noexcept |
| Copy an array of characters into a string.
|
|
eError | assign (const uint16_t *pInput) noexcept |
| Copy a 16 bit "C" string to a Burger::String.
|
|
eError | assign (const uint16_t *pInput, uintptr_t uLength) noexcept |
| Copy a 16 bit "C" string to a Burger::String.
|
|
eError | assign_win437 (const char *pInput) noexcept |
| Copy a "C" string encoded with Win437 into the String.
|
|
eError | assign_win437 (const char *pInput, uintptr_t uLength) noexcept |
| Copy a buffer encoded with Win437 into the String.
|
|
eError | assign_win1252 (const char *pInput) noexcept |
| Copy a "C" string encoded with Win1252 into the String.
|
|
eError | assign_win1252 (const char *pInput, uintptr_t uLength) noexcept |
| Copy a buffer encoded with Win1252 into the String.
|
|
eError | assign_mac_roman_us (const char *pInput) noexcept |
| Copy a "C" string encoded with MacRomanUS into the String.
|
|
eError | assign_mac_roman_us (const char *pInput, uintptr_t uLength) noexcept |
| Copy a buffer encoded with MacRomanUS into the String.
|
|
eError | resize (uintptr_t uSize) noexcept |
| Force a buffer size.
|
|
eError | reserve (uintptr_t uNewBufferSize) noexcept |
| Ensure a minimum buffer size.
|
|
uintptr_t | find (const String &rInput, uintptr_t uPosition=0) const noexcept |
| Locate a String in a String.
|
|
uintptr_t | find (const char *pInput, uintptr_t uPosition=0) const noexcept |
| Locate a "C" string in a String.
|
|
uintptr_t | find (const char *pInput, uintptr_t uPosition, uintptr_t uInputSize) const noexcept |
| Locate a buffer in a String.
|
|
uintptr_t | find (char iInput, uintptr_t uPosition=0) const noexcept |
| Locate a character in a String.
|
|
String & | operator= (char iInput) noexcept |
| Assign a single character length string to this Burger::String.
|
|
String & | operator= (const char *pInput) noexcept |
| Assign a "C" string to a Burger::String.
|
|
String & | operator= (const uint16_t *pInput) noexcept |
| Assign a 16 bit "C" string to a Burger::String.
|
|
String & | operator= (const String &rInput) noexcept |
| Assign a Burger::String.
|
|
String & | operator+= (char iInput) noexcept |
| Append a single character to the current string.
|
|
String & | operator+= (const char *pInput) noexcept |
| Append a UTF8 "C" string to the current string.
|
|
String & | operator+= (const uint16_t *pInput) noexcept |
| Append a UTF16 "C" string to the current string.
|
|
String & | operator+= (const String &rInput) noexcept |
| Append a Burger::String to the current string.
|
|
String | operator() (uintptr_t uStart, uintptr_t uLength) const noexcept |
| Create a new Burger::String from a substring.
|
|
char & | operator() (uintptr_t uInput) noexcept |
| Return the reference to a location in the string.
|
|
char const & | operator() (uintptr_t uInput) const noexcept |
| Return the reference to a location in the string.
|
|
char & | operator[] (uintptr_t uInput) noexcept |
| Return the reference to a location in the string.
|
|
char const & | operator[] (uintptr_t uInput) const noexcept |
| Return the reference to a location in the string.
|
|
char | Get (uintptr_t uWhere) const noexcept |
| Return a single character from the string.
|
|
void | Put (uintptr_t uWhere, char cInput) noexcept |
| Modify a single character in the string.
|
|
String & | ToLowercase (void) noexcept |
| Convert the string to lower case.
|
|
String & | ToUppercase (void) noexcept |
| Convert the string to upper case.
|
|
String | Lowercase (void) const noexcept |
| Return a lowercase copy of the string.
|
|
String | Uppercase (void) const noexcept |
| Return an uppercase copy of the string.
|
|
uint_t | operator! () const noexcept |
| Return TRUE if the string is empty.
|
|
uint_t | IsValid (void) const noexcept |
| Return TRUE if the string has characters.
|
|
void | clear (void) noexcept |
| Clear out the data.
|
|
uintptr_t | copy (char *pOutput, uintptr_t uOutputSize=UINTPTR_MAX) const noexcept |
| Extract the string into a buffer of a specific size.
|
|
uintptr_t | PCopy (uint8_t *pOutput, uintptr_t uOutputSize=256) const noexcept |
| Extract the string into a Pascal buffer of a specific size.
|
|
uintptr_t | Remove (uintptr_t uStart, uintptr_t uLength=UINTPTR_MAX) noexcept |
| Remove a part of the string.
|
|
eError | insert (uintptr_t uStart, const char *pInput, uintptr_t uInputSize) noexcept |
| Insert a string into a current String.
|
|
eError | push_back (char iInput) noexcept |
| Append a single character to the current string.
|
|
char | pop_back (void) noexcept |
| Remove the last character from a string.
|
|
eError | append (const char *pInput) noexcept |
| Append a UTF8 string buffer to the current string.
|
|
eError | append (const uint16_t *pInput) noexcept |
| Append a UTF16 string buffer to the current string.
|
|
eError | append (const String &rInput) noexcept |
| Append a UTF8 string buffer to the current string.
|
|
eError | append (const char *pInput, uintptr_t uInputSize) noexcept |
| Append a UTF8 string buffer to the current string.
|
|
String & | Left (uintptr_t uNewLength, char iInput=' ') noexcept |
| Resize a string and either truncate or append with a fill character.
|
|
String & | Right (uintptr_t uNewLength, char iInput=' ') noexcept |
| Resize a string and either truncate or prepend with a fill character.
|
|
uint_t | starts_with (char iInput) noexcept |
| Test if the string starts with a char.
|
|
uint_t | starts_with (const char *pInput) noexcept |
| Test if the string starts with a "C" string.
|
|
uint_t | starts_with (const char *pInput, uintptr_t uLength) noexcept |
| Test if the string starts with a buffer of data.
|
|
uint_t | ends_with (char iInput) noexcept |
| Test if the string ends with a char.
|
|
uint_t | ends_with (const char *pInput) noexcept |
| Test if the string ends with a "C" string.
|
|
uint_t | ends_with (const char *pInput, uintptr_t uLength) noexcept |
| Test if the string ends with a buffer of data.
|
|
int | Compare (const String &rInput) const noexcept |
| Compare the string.
|
|
int | Compare (const char *pInput) const noexcept |
| Compare the string.
|
|
int | Compare (char iInput) const noexcept |
| Compare the string to a single character.
|
|
uintptr_t | RemoveChars (const char *pInput) noexcept |
| Remove each and every char in the list.
|
|
uintptr_t | RemoveChar (char iInput) noexcept |
| Remove a specific character from the string.
|
|
uintptr_t | NormalizeLineFeeds (void) noexcept |
| Normalize Mac and PC line feeds to Linux/Unix format.
|
|
uint_t | GetBoolean (uint_t bDefault) const noexcept |
| Convert an ASCII string into a boolean.
|
|
void | SetTrueFalse (uint_t bInput) noexcept |
| Set the string to "true" or "false".
|
|
void | SetYesNo (uint_t bInput) noexcept |
| Set the string to "true" or "false".
|
|
uint_t | GetWord (uint_t uDefault, uint_t uMin=0, uint_t uMax=0xFFFFFFFFU) const noexcept |
| Return an unsigned integer value.
|
|
void | SetWord (uint_t uInput) noexcept |
| Set an unsigned integer value.
|
|
void | SetWordHex (uint_t uInput) noexcept |
| Set an unsigned integer value as hex.
|
|
int_t | GetInt (int_t iDefault, int_t iMin=(- 0x7FFFFFFF) - 1, int_t iMax=0x7FFFFFFF) const noexcept |
| Return a signed integer value.
|
|
void | SetInt (int_t iInput) noexcept |
| Set a signed integer value.
|
|
float | GetFloat (float fDefault) const noexcept |
| Return a floating point value.
|
|
float | GetFloat (float fDefault, float fMin, float fMax) const noexcept |
| Return a floating point value.
|
|
void | SetFloat (float fValue) noexcept |
| Set a 32 bit floating point value.
|
|
double | GetDouble (double dDefault) const noexcept |
| Return a 64 bit floating point value.
|
|
double | GetDouble (double dDefault, double dMin, double dMax) const noexcept |
| Return a 64 bit floating point value.
|
|
void | SetDouble (double dValue) noexcept |
| Set a 64 bit floating point value.
|
|
|
uint_t | operator== (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are equal (Case sensitive)
|
|
uint_t | operator== (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the strings are equal (Case sensitive)
|
|
uint_t | operator== (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are equal (Case sensitive)
|
|
uint_t | operator== (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the strings are equal (Case sensitive)
|
|
uint_t | operator== (char cInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are equal (Case sensitive)
|
|
uint_t | operator!= (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are not equal (Case sensitive)
|
|
uint_t | operator!= (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the strings are not equal (Case sensitive)
|
|
uint_t | operator!= (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are not equal (Case sensitive)
|
|
uint_t | operator!= (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the strings are not equal (Case sensitive)
|
|
uint_t | operator!= (char cInput1, String const &rInput2) noexcept |
| Return TRUE if the strings are not equal (Case sensitive)
|
|
uint_t | operator< (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the first is less than the second (Case sensitive)
|
|
uint_t | operator< (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the first is less than the second (Case sensitive)
|
|
uint_t | operator< (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the first is less than the second (Case sensitive)
|
|
uint_t | operator< (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the first is less than the second (Case sensitive)
|
|
uint_t | operator< (char cInput1, String const &rInput2) noexcept |
| Return TRUE if the first is less than the second (Case sensitive)
|
|
uint_t | operator<= (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the first is less than or equal to the second (Case sensitive)
|
|
uint_t | operator<= (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the first is less than or equal to the second (Case sensitive)
|
|
uint_t | operator<= (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the first is less than or equal to the second (Case sensitive)
|
|
uint_t | operator<= (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the first is less than or equal to the second (Case sensitive)
|
|
uint_t | operator<= (char cInput1, String const &rInput2) noexcept |
|
uint_t | operator> (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than the second (Case sensitive)
|
|
uint_t | operator> (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the first is greater than the second (Case sensitive)
|
|
uint_t | operator> (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than the second (Case sensitive)
|
|
uint_t | operator> (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the first is greater than the second (Case sensitive)
|
|
uint_t | operator> (char cInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than the second (Case sensitive)
|
|
uint_t | operator>= (String const &rInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than or equal to the second (Case sensitive)
|
|
uint_t | operator>= (String const &rInput1, const char *pInput2) noexcept |
| Return TRUE if the first is greater than or equal to the second (Case sensitive)
|
|
uint_t | operator>= (const char *pInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than or equal to the second (Case sensitive)
|
|
uint_t | operator>= (String const &rInput1, char cInput2) noexcept |
| Return TRUE if the first is greater than or equal to the second (Case sensitive)
|
|
uint_t | operator>= (char cInput1, String const &rInput2) noexcept |
| Return TRUE if the first is greater than or equal to the second (Case sensitive)
|
|
UTF 8 bit string class.
This commonly used string class was designed for performance in mind. Each instance takes 64 bytes to contain data for the string and a pointer to allocated memory if the internal string buffer is too large. Since most strings rarely exceed 56 bytes in length, this class will be able to allocate and free strings with no calls to a memory manager. Only when the string exceeds the internal buffer will Burger::Alloc() and Burger::Free() be used.
Functions exist to convert UTF16 and UTF32 data into UTF8 format, which this string class uses internally for data storage.
- See also
- Burger::String16