BALL 1.5.0
|
#include <BALL/DATATYPE/string.h>
Public Member Functions | |
virtual void * | create (bool=true, bool empty=false) const |
Constructors and Destructors | |
String () | |
Default Constructor. | |
String (const string &string) | |
STL string copy constructor. | |
String (const String &s) | |
Copy constructor. | |
String (String &&s) | |
Move constructor. | |
String (string &&s) | |
Move constructor for STL string. | |
String & | operator= (String &&s) |
Move assigment operator. | |
String & | operator= (string &&s) |
Move assignment operator for STL string. | |
String (const QString &string) | |
QString copy constructor. | |
String (const QByteArray &string) | |
QByteArray copy constructor. | |
String (const String &s, Index from, Size len=EndPos) | |
String (const char *char_ptr, Index from=0, Size len=EndPos) | |
String (Size buffer_size, const char *format,...) | |
String (std::stringstream &s) | |
String (const char c, Size len=1) | |
String (const unsigned char uc) | |
Creates a string just containing an unsigned character. | |
String (short s) | |
Construct a String from a short. | |
String (unsigned short us) | |
Construct a String from an unsigned short. | |
String (int i) | |
Construct a String from an int. | |
String (unsigned int ui) | |
Construct a String from an unsigned int. | |
String (long l) | |
Construct a String from a long. | |
String (unsigned long) | |
Construct a String from an unsigned long. | |
String (float f) | |
Construct a String from a float value. | |
String (double d) | |
Construct a String from a double value. | |
operator string & () | |
Cast the String to a std::string reference. | |
operator string const & () const | |
Cast the String to a std::string reference, const version. | |
virtual | ~String () |
Destructor. | |
void | destroy () |
Clear the string (reset to the empty string) | |
Assignment methods | |
void | set (const String &s) |
void | set (const String &string, Index from, Size len=EndPos) |
void | set (const char *char_ptr, Index from=0, Size len=EndPos) |
void | set (Size buffer_size, const char *format,...) |
void | set (std::stringstream &s) |
void | set (char c, Size len=1) |
Assign a String from the result of repeating c len times. | |
void | set (unsigned char uc) |
Assign a String from an unsigned char. | |
void | set (short s) |
Assign a String from a short. | |
void | set (unsigned short us) |
Assign a String from an unsigned short. | |
void | set (int i) |
Assign a String from an int. | |
void | set (unsigned int ui) |
Assign a String from an unsigned int. | |
void | set (long l) |
Assign a String from a long. | |
void | set (unsigned long ul) |
Assign a String from an unsigned long. | |
void | set (float f) |
Assign a String from a float value. | |
void | set (double d) |
Assign a String from a double value. | |
void | get (char *char_ptr, Index from=0, Size len=EndPos) const |
const String & | operator= (const String &s) |
Assign a String from another String. | |
const String & | operator= (const char *pc) |
const String & | operator= (std::stringstream &s) |
const String & | operator= (char c) |
Assign a String from a single char. | |
const String & | operator= (unsigned char uc) |
Assign a String from an unsigned char. | |
const String & | operator= (short s) |
Assign a String from a short. | |
const String & | operator= (unsigned short us) |
Assign a String from an unsigned short. | |
const String & | operator= (int i) |
Assign a String from an int. | |
const String & | operator= (unsigned int ui) |
Assign a String from an unsigned int. | |
const String & | operator= (long l) |
Assign a String from a long. | |
const String & | operator= (unsigned long ul) |
Assign a String from an unsigned long. | |
const String & | operator= (float f) |
Assign a String from a float. | |
const String & | operator= (double d) |
Assign a String from a double. | |
Converters | |
bool | toBool () const |
char | toChar () const |
Return the first character of the string. | |
unsigned char | toUnsignedChar () const |
Return the first character of the string converted to an unsigned char. | |
short | toShort () const |
unsigned short | toUnsignedShort () const |
int | toInt () const |
unsigned int | toUnsignedInt () const |
long | toLong () const |
unsigned long | toUnsignedLong () const |
float | toFloat () const |
double | toDouble () const |
Case Conversion | |
void | toLower (Index from=0, Size len=EndPos) |
void | toUpper (Index from=0, Size len=EndPos) |
Substring Definition | |
Substring | getSubstring (Index from=0, Size len=EndPos) const |
Substring | operator() (Index from, Size len=EndPos) const |
Substring | before (const String &s, Index from=0) const |
Substring | through (const String &s, Index from=0) const |
Substring | from (const String &s, Index from=0) const |
Substring | after (const String &s, Index from=0) const |
AWK style field operations | |
Size | countFields (const char *delimiters=CHARACTER_CLASS__WHITESPACE) const |
Size | countFieldsQuoted (const char *delimiters=CHARACTER_CLASS__WHITESPACE, const char *quotes=CHARACTER_CLASS__QUOTES) const |
String | getField (Index index, const char *delimiters=CHARACTER_CLASS__WHITESPACE, Index *from=0) const |
String | getFieldQuoted (Index index, const char *delimiters=CHARACTER_CLASS__WHITESPACE, const char *quotes=CHARACTER_CLASS__QUOTES, Index *from=0) const |
Size | split (String string_array[], Size array_size, const char *delimiters=CHARACTER_CLASS__WHITESPACE, Index from=0) const |
Size | split (std::vector< String > &strings, const char *delimiters=CHARACTER_CLASS__WHITESPACE, Index from=0) const |
Size | splitQuoted (std::vector< String > &strings, const char *delimiters=CHARACTER_CLASS__WHITESPACE, const char *quotes=CHARACTER_CLASS__QUOTES, Index from=0) const |
BASIC style string operations | |
String & | trimLeft (const char *trimmed=CHARACTER_CLASS__WHITESPACE) |
String & | trimRight (const char *trimmed=CHARACTER_CLASS__WHITESPACE) |
String & | trim (const char *trimmed=CHARACTER_CLASS__WHITESPACE) |
String | trim (const char *trimmed=CHARACTER_CLASS__WHITESPACE) const |
String & | truncate (Size size) |
Truncate the string to length size | |
Substring | left (Size len) const |
Return a substring containing the len leftmost characters of the string. | |
Substring | right (Size len) const |
Return a substring containing the len rightmost characters of the string. | |
Substring | instr (const String &pattern, Index from=0) const |
Base64 String methods | |
String | encodeBase64 () |
Convert a string to a base 64 string. | |
String | decodeBase64 () |
Debugging and Diagnostics | |
bool | isValid () const |
void | dump (std::ostream &s=std::cout, Size depth=0) const |
Iterators | |
iterator | begin () BALL_NOEXCEPT |
const_iterator | begin () const BALL_NOEXCEPT |
iterator | end () BALL_NOEXCEPT |
const_iterator | end () const BALL_NOEXCEPT |
reverse_iterator | rbegin () BALL_NOEXCEPT |
const_reverse_iterator | rbegin () const BALL_NOEXCEPT |
reverse_iterator | rend () BALL_NOEXCEPT |
const_reverse_iterator | rend () const BALL_NOEXCEPT |
const_iterator | cbegin () const BALL_NOEXCEPT |
const_iterator | cend () const BALL_NOEXCEPT |
const_reverse_iterator | crbegin () const BALL_NOEXCEPT |
const_reverse_iterator | crend () const BALL_NOEXCEPT |
Capacity | |
size_t | size () const BALL_NOEXCEPT |
size_t | length () const BALL_NOEXCEPT |
size_t | max_size () const BALL_NOEXCEPT |
void | resize (size_t n) |
void | resize (size_t n, char c) |
size_t | capacity () const BALL_NOEXCEPT |
void | reserve (size_t n=0) |
void | clear () BALL_NOEXCEPT |
bool | empty () const BALL_NOEXCEPT |
void | shrink_to_fit () |
Element Access | |
char & | operator[] (size_t pos) |
const char & | operator[] (size_t pos) const |
char & | at (size_t pos) |
const char & | at (size_t pos) const |
char & | front () |
const char & | front () const |
char & | back () |
const char & | back () const |
Modifiers | |
String & | operator+= (const String &str) |
String & | operator+= (const string &str) |
String & | operator+= (const char *s) |
String & | operator+= (char c) |
String & | operator+= (std::initializer_list< char > il) |
String & | append (const String &str) |
String & | append (const string &str) |
String & | append (const string &str, size_t subpos, size_t sublen) |
String & | append (const char *s) |
String & | append (const char *s, size_t n) |
String & | append (size_t n, char c) |
template<class InputIterator > | |
String & | append (InputIterator first, InputIterator last) |
String & | append (std::initializer_list< char > li) |
void | push_back (char c) |
String & | assign (const String &str) |
String & | assign (const string &str) |
String & | assign (const string &str, size_t subpos, size_t sublen) |
String & | assign (const char *s) |
String & | assign (const char *s, size_t n) |
String & | assign (size_t n, char c) |
template<class InputIterator > | |
String & | assign (InputIterator first, InputIterator last) |
String & | assign (std::initializer_list< char > li) |
String & | assign (string &&str) BALL_NOEXCEPT |
String & | insert (size_t pos, const string &str) |
String & | insert (size_t pos, const string &str, size_t subpos, size_t sublen) |
String & | insert (size_t pos, const char *s) |
String & | insert (size_t pos, const char *s, size_t n) |
String & | insert (size_t pos, size_t n, char c) |
void | insert (iterator p, size_t n, char c) |
iterator | insert (iterator p, char c) |
template<class InputIterator > | |
iterator | insert (iterator p, InputIterator first, InputIterator last) |
String & | erase (size_t pos=0, size_t len=npos) |
iterator | erase (iterator p) |
iterator | erase (iterator first, iterator last) |
String & | replace (size_t pos, size_t len, const string &str) |
String & | replace (size_t pos, size_t len, const string &str, size_t subpos, size_t sublen) |
String & | replace (size_t pos, size_t len, const char *s) |
String & | replace (size_t pos, size_t len, const char *s, size_t n) |
String & | replace (size_t pos, size_t len, size_t n, char c) |
String & | replace (iterator i1, iterator i2, const string &str) |
String & | replace (iterator i1, iterator i2, const char *s) |
String & | replace (iterator i1, iterator i2, const char *s, size_t n) |
String & | replace (iterator i1, iterator i2, size_t n, char c) |
template<class InputIterator > | |
String & | replace (iterator i1, iterator i2, InputIterator first, InputIterator last) |
void | swap (string &str) |
void | pop_back () |
Static Public Member Functions | |
Compare mode-related methods. | |
All string comparisons can be made case-sensitive or case insensitive. The behavior can be toggled globally for all strings. | |
static void | setCompareMode (CompareMode compare_mode) |
Set the compareison mode for all string comparisons. | |
static CompareMode | getCompareMode () |
Return the current comparison mode. | |
Static Public Attributes | |
Predefined character classes | |
There exist several predefined character classes, that may be used in several functions (e.g. trim methods) to represent a set of characters. | |
static const char * | CHARACTER_CLASS__ASCII_ALPHA |
Character class containing all letters (lower and upper case) | |
static const char * | CHARACTER_CLASS__ASCII_ALPHANUMERIC |
Character class containing all letters and digits. | |
static const char * | CHARACTER_CLASS__ASCII_LOWER |
Character class containing all lower case letters. | |
static const char * | CHARACTER_CLASS__ASCII_UPPER |
Character class containing all upper case letters. | |
static const char * | CHARACTER_CLASS__ASCII_NUMERIC |
Character class containing the digits from 0 to 9. | |
static const char * | CHARACTER_CLASS__ASCII_FLOAT |
Character class containing the digits from 0 to 9 and a dot. | |
static const char * | CHARACTER_CLASS__WHITESPACE |
static const char * | CHARACTER_CLASS__QUOTES |
Friends | |
class | Substring |
Enums and Constants | |
enum | CompareMode { CASE_SENSITIVE = 0 , CASE_INSENSITIVE = 1 } |
static const Size | EndPos |
static const size_t | npos = -1 |
Stream Operations | |
typedef string::value_type | valuetype |
typedef string::traits_type | traits_type |
typedef string::allocator_type | allocator_type |
typedef string::reference | reference |
typedef string::const_reference | const_reference |
typedef string::pointer | pointer |
typedef string::const_pointer | const_pointer |
typedef string::iterator | iterator |
typedef string::const_iterator | const_iterator |
typedef string::reverse_iterator | reverse_iterator |
typedef string::const_reverse_iterator | const_reverse_iterator |
typedef string::difference_type | difference_type |
typedef string::size_type | size_type |
static const String | EMPTY |
Constant empty string. | |
std::istream & | getline (std::istream &s=std::cin, char delimiter='\n') |
String Operations | |
BALL_EXPORT friend String | operator+ (const String &s1, const string &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const string &s1, const String &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const String &s1, const String &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const String &s1, const char *char_ptr) |
Concatenates a string and a C type string. | |
BALL_EXPORT friend String | operator+ (const char *char_ptr, const String &s) |
Concatenates a C type string and a string. | |
BALL_EXPORT friend String | operator+ (const String &s, char c) |
Concatenates a string and a character. | |
BALL_EXPORT friend String | operator+ (char c, const String &s) |
Concatenates a character and a string. | |
BALL_EXPORT friend String | operator+ (String &&s1, const string &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (String &&s1, const String &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (String &&s1, String &&s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const String &s1, string &&s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (string &&s1, const String &s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const string &s1, String &&s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (const String &s1, String &&s2) |
Concatenates two strings. | |
BALL_EXPORT friend String | operator+ (String &&s1, const char *char_ptr) |
Concatenates a string and a C type string. | |
BALL_EXPORT friend String | operator+ (const char *char_ptr, String &&s) |
Concatenates a C type string and a string. | |
BALL_EXPORT friend String | operator+ (String &&s, char c) |
Concatenates a string and a character. | |
BALL_EXPORT friend String | operator+ (char c, String &&s) |
Concatenates a character and a string. | |
void | swap (String &s) |
Swaps the contents with another String. | |
String & | reverse (Index from=0, Size len=EndPos) |
Size | substitute (const String &to_replace, const String &replacing) |
void | substituteAll (const String &to_replace, const String &replacing) |
const char * | c_str () const BALL_NOEXCEPT |
const char * | data () const BALL_NOEXCEPT |
allocator_type | get_allocator () const BALL_NOEXCEPT |
size_t | copy (char *s, size_t len, size_t pos=0) const |
size_t | find (const string &str, size_t pos=0) const BALL_NOEXCEPT |
size_t | find (const char *s, size_t pos=0) const |
size_t | find (const char *s, size_t pos, size_t n) const |
size_t | find (char c, size_t pos=0) const BALL_NOEXCEPT |
size_t | rfind (const string &str, size_t pos=npos) const BALL_NOEXCEPT |
size_t | rfind (const char *s, size_t pos=npos) const |
size_t | rfind (const char *s, size_t pos, size_t n) const |
size_t | rfind (char c, size_t pos=npos) const BALL_NOEXCEPT |
size_t | find_first_of (const string &str, size_t pos=0) const BALL_NOEXCEPT |
size_t | find_first_of (const char *s, size_t pos=0) const |
size_t | find_first_of (const char *s, size_t pos, size_t n) const |
size_t | find_first_of (char c, size_t pos=0) const BALL_NOEXCEPT |
size_t | find_last_of (const string &str, size_t pos=npos) const BALL_NOEXCEPT |
size_t | find_last_of (const char *s, size_t pos=npos) const |
size_t | find_last_of (const char *s, size_t pos, size_t n) const |
size_t | find_last_of (char c, size_t pos=npos) const BALL_NOEXCEPT |
size_t | find_first_not_of (const string &str, size_t pos=0) const BALL_NOEXCEPT |
size_t | find_first_not_of (const char *s, size_t pos=0) const |
size_t | find_first_not_of (const char *s, size_t pos, size_t n) const |
size_t | find_first_not_of (char c, size_t pos=0) const BALL_NOEXCEPT |
size_t | find_last_not_of (const string &str, size_t pos=npos) const BALL_NOEXCEPT |
size_t | find_last_not_of (const char *s, size_t pos=npos) const |
size_t | find_last_not_of (const char *s, size_t pos, size_t n) const |
size_t | find_last_not_of (char c, size_t pos=npos) const BALL_NOEXCEPT |
string | substr (size_t pos=0, size_t len=npos) const |
int | compare (const string &str) const BALL_NOEXCEPT |
int | compare (size_t pos, size_t len, const string &str) const |
int | compare (size_t pos, size_t len, const string &str, size_t subpos, size_t sublen) const |
int | compare (size_t pos, size_t len, const char *s) const |
int | compare (size_t pos, size_t len, const char *s, size_t n) const |
void | validateIndex_ (Index &index) const |
void | validateRange_ (Index &from, Size &len) const |
static void | validateCharPtrRange_ (Index &from, Size &len, const char *char_ptr) |
static void | valudateCharPtrIndex_ (Index &index) |
Comparators | |
BALL_EXPORT friend bool | operator== (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator!= (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator< (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator<= (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator> (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator>= (const String &s1, const String &s2) |
BALL_EXPORT friend bool | operator== (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator!= (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator< (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator<= (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator> (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator>= (const char *char_ptr, const String &string) |
BALL_EXPORT friend bool | operator== (char c, const String &string) |
BALL_EXPORT friend bool | operator!= (char c, const String &string) |
BALL_EXPORT friend bool | operator< (char c, const String &string) |
BALL_EXPORT friend bool | operator<= (char c, const String &string) |
BALL_EXPORT friend bool | operator> (char c, const String &string) |
bool | operator>= (char c, const String &string) |
int | compare (const String &string, Index from=0) const |
int | compare (const String &string, Index from, Size len) const |
int | compare (const char *char_ptr, Index from=0) const |
int | compare (const char *char_ptr, Index from, Size len) const |
int | compare (char c, Index from=0) const |
bool | operator== (const char *char_ptr) const |
bool | operator!= (const char *char_ptr) const |
bool | operator< (const char *char_ptr) const |
bool | operator<= (const char *char_ptr) const |
bool | operator> (const char *char_ptr) const |
bool | operator>= (const char *char_ptr) const |
bool | operator== (char c) const |
bool | operator!= (char c) const |
bool | operator< (char c) const |
bool | operator<= (char c) const |
bool | operator> (char c) const |
bool | operator>= (char c) const |
Predicates | |
bool | has (char c) const |
True, if the string contains character c | |
bool | hasSubstring (const String &s, Index from=0) const |
True, if the string contains the substring s after index from | |
bool | hasPrefix (const String &s) const |
True, if the string starts with s | |
bool | hasSuffix (const String &s) const |
True, if the string ends with s | |
bool | isEmpty () const |
True, if the string has size 0. | |
bool | isAlpha () const |
bool | isAlnum () const |
bool | isDigit () const |
bool | isFloat () const |
bool | isSpace () const |
bool | isWhitespace () const |
static bool | isAlpha (char c) |
True, if the character is a letter (any case) | |
static bool | isAlnum (char c) |
True, if the character is a letter or a digit. | |
static bool | isDigit (char c) |
True, if the character is a digit. | |
static bool | isSpace (char c) |
True, if the character is a space. | |
static bool | isWhitespace (char c) |
string::allocator_type BALL::String::allocator_type |
string::const_iterator BALL::String::const_iterator |
string::const_pointer BALL::String::const_pointer |
string::const_reference BALL::String::const_reference |
string::const_reverse_iterator BALL::String::const_reverse_iterator |
string::difference_type BALL::String::difference_type |
string::iterator BALL::String::iterator |
string::pointer BALL::String::pointer |
string::reference BALL::String::reference |
string::reverse_iterator BALL::String::reverse_iterator |
string::size_type BALL::String::size_type |
string::traits_type BALL::String::traits_type |
string::value_type BALL::String::valuetype |
Constants to set the compare mode. Use one of these constants to set the mode you need. These modes affect all compare methods. As these methods are also used in the implementation of comparison operators, all comparison operations will get affected from a change.
Enumerator | |
---|---|
CASE_SENSITIVE | Constant to set to case sensitive comparisons (default) |
CASE_INSENSITIVE | Constant to set to case insensitive comparisons. |
BALL::String::String | ( | ) |
Default Constructor.
BALL::String::String | ( | const string & | string | ) |
STL string copy constructor.
BALL::String::String | ( | const String & | s | ) |
Copy constructor.
BALL::String::String | ( | String && | s | ) |
Move constructor.
BALL::String::String | ( | string && | s | ) |
Move constructor for STL string.
|
explicit |
QString copy constructor.
|
explicit |
QByteArray copy constructor.
Creates a new string from a given range of another string.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Creates a new string from a C type string. The new string contains the contents of s until it has reached a length of len or contains a zero character (whichever comes first). Default value for len is EndPos, meaning as long as possible.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Exception::NullPointer | if char_ptr == NULL |
BALL::String::String | ( | Size | buffer_size, |
const char * | format, | ||
... ) |
Creates a string using sprintf. This constructor creates a new string and sets its content to the result of a call to sprintf using format as a format string and all additional parameters as arguments.
IndexUnderflow,if | the buffer size specified is not larger than 0 |
NullPointer,if | format == 0 |
BALL::String::String | ( | std::stringstream & | s | ) |
Create a new string from the contents of a stringstream. The contents of the stringstream
are not modified, i.e. successive construction of multiple strings from the same stringstream
object leads to identical copies.
BALL::String::String | ( | const char | c, |
Size | len = 1 ) |
Creates a new string from len copies of c.
BALL::String::String | ( | const unsigned char | uc | ) |
Creates a string just containing an unsigned character.
BALL::String::String | ( | short | s | ) |
Construct a String from a short.
BALL::String::String | ( | unsigned short | us | ) |
Construct a String from an unsigned short.
BALL::String::String | ( | int | i | ) |
Construct a String from an int.
BALL::String::String | ( | unsigned int | ui | ) |
Construct a String from an unsigned int.
BALL::String::String | ( | long | l | ) |
Construct a String from a long.
BALL::String::String | ( | unsigned long | ) |
Construct a String from an unsigned long.
|
virtual |
Destructor.
Return a substring containing the string after the first occurence of s.
String & BALL::String::append | ( | const char * | s | ) |
String & BALL::String::append | ( | const char * | s, |
size_t | n ) |
String & BALL::String::append | ( | const string & | str | ) |
String & BALL::String::append | ( | const string & | str, |
size_t | subpos, | ||
size_t | sublen ) |
String & BALL::String::append | ( | InputIterator | first, |
InputIterator | last ) |
String & BALL::String::append | ( | size_t | n, |
char | c ) |
String & BALL::String::append | ( | std::initializer_list< char > | li | ) |
String & BALL::String::assign | ( | const char * | s | ) |
String & BALL::String::assign | ( | const char * | s, |
size_t | n ) |
String & BALL::String::assign | ( | const string & | str | ) |
String & BALL::String::assign | ( | const string & | str, |
size_t | subpos, | ||
size_t | sublen ) |
String & BALL::String::assign | ( | InputIterator | first, |
InputIterator | last ) |
String & BALL::String::assign | ( | size_t | n, |
char | c ) |
String & BALL::String::assign | ( | std::initializer_list< char > | li | ) |
String & BALL::String::assign | ( | string && | str | ) |
char & BALL::String::at | ( | size_t | pos | ) |
const char & BALL::String::at | ( | size_t | pos | ) | const |
char & BALL::String::back | ( | ) |
const char & BALL::String::back | ( | ) | const |
Return a substring containing the string before the first occurence of s
iterator BALL::String::begin | ( | ) |
const_iterator BALL::String::begin | ( | ) | const |
const char * BALL::String::c_str | ( | ) | const |
size_t BALL::String::capacity | ( | ) | const |
const_iterator BALL::String::cbegin | ( | ) | const |
const_iterator BALL::String::cend | ( | ) | const |
void BALL::String::clear | ( | ) |
int BALL::String::compare | ( | char | c, |
Index | from = 0 ) const |
compare to character
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
compare to c-style string.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Exception::NullPointer | if char_ptr == NULL |
int BALL::String::compare | ( | const char * | char_ptr, |
Index | from = 0 ) const |
compare to c-style string.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Exception::NullPointer | if char_ptr == NULL |
int BALL::String::compare | ( | const string & | str | ) | const |
compare to a string.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
compare to a string.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
int BALL::String::compare | ( | size_t | pos, |
size_t | len, | ||
const char * | s ) const |
int BALL::String::compare | ( | size_t | pos, |
size_t | len, | ||
const char * | s, | ||
size_t | n ) const |
int BALL::String::compare | ( | size_t | pos, |
size_t | len, | ||
const string & | str ) const |
int BALL::String::compare | ( | size_t | pos, |
size_t | len, | ||
const string & | str, | ||
size_t | subpos, | ||
size_t | sublen ) const |
size_t BALL::String::copy | ( | char * | s, |
size_t | len, | ||
size_t | pos = 0 ) const |
Size BALL::String::countFields | ( | const char * | delimiters = CHARACTER_CLASS__WHITESPACE | ) | const |
Count the fields that are separated by a defined set of delimiters
Exception::NullPointer | if delimiters == NULL |
Size BALL::String::countFieldsQuoted | ( | const char * | delimiters = CHARACTER_CLASS__WHITESPACE, |
const char * | quotes = CHARACTER_CLASS__QUOTES ) const |
Count the fields and respect quote characters.
Exception::NullPointer | if delimiters == NULL or quotes == NULL |
const_reverse_iterator BALL::String::crbegin | ( | ) | const |
const_reverse_iterator BALL::String::crend | ( | ) | const |
const char * BALL::String::data | ( | ) | const |
String BALL::String::decodeBase64 | ( | ) |
Decode a base 64 string. Return an empty string, if base64 string is not right encoded.
void BALL::String::destroy | ( | ) |
Clear the string (reset to the empty string)
void BALL::String::dump | ( | std::ostream & | s = std::cout, |
Size | depth = 0 ) const |
bool BALL::String::empty | ( | ) | const |
String BALL::String::encodeBase64 | ( | ) |
Convert a string to a base 64 string.
iterator BALL::String::end | ( | ) |
const_iterator BALL::String::end | ( | ) | const |
size_t BALL::String::find | ( | char | c, |
size_t | pos = 0 ) const |
size_t BALL::String::find | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::find | ( | const char * | s, |
size_t | pos = 0 ) const |
size_t BALL::String::find | ( | const string & | str, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_not_of | ( | char | c, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_not_of | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::find_first_not_of | ( | const char * | s, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_not_of | ( | const string & | str, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_of | ( | char | c, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_of | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::find_first_of | ( | const char * | s, |
size_t | pos = 0 ) const |
size_t BALL::String::find_first_of | ( | const string & | str, |
size_t | pos = 0 ) const |
size_t BALL::String::find_last_not_of | ( | char | c, |
size_t | pos = npos ) const |
size_t BALL::String::find_last_not_of | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::find_last_not_of | ( | const char * | s, |
size_t | pos = npos ) const |
size_t BALL::String::find_last_not_of | ( | const string & | str, |
size_t | pos = npos ) const |
size_t BALL::String::find_last_of | ( | char | c, |
size_t | pos = npos ) const |
size_t BALL::String::find_last_of | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::find_last_of | ( | const char * | s, |
size_t | pos = npos ) const |
size_t BALL::String::find_last_of | ( | const string & | str, |
size_t | pos = npos ) const |
Return a substring containing the string from the first occurence of s on
char & BALL::String::front | ( | ) |
const char & BALL::String::front | ( | ) | const |
Assign to a C type string The resulting string contains the contents of this until it has reached a length of len or contains a zero character (whichever comes first). Default value for len is EndPos, meaning as long as possible.
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Exception::NullPointer | if char_ptr == NULL |
allocator_type BALL::String::get_allocator | ( | ) | const |
|
static |
Return the current comparison mode.
String BALL::String::getField | ( | Index | index, |
const char * | delimiters = CHARACTER_CLASS__WHITESPACE, | ||
Index * | from = 0 ) const |
Return a given field as a substring
Exception::IndexUnderflow | if from < 0 |
Exception::NullPointer | if delimiters == NULL |
String BALL::String::getFieldQuoted | ( | Index | index, |
const char * | delimiters = CHARACTER_CLASS__WHITESPACE, | ||
const char * | quotes = CHARACTER_CLASS__QUOTES, | ||
Index * | from = 0 ) const |
Return a given field and respect quote characters.
Exception::IndexUnderflow | if from < 0 |
Exception::NullPointer | if delimiters == NULL |
std::istream & BALL::String::getline | ( | std::istream & | s = std::cin, |
char | delimiter = '\n' ) |
Return a substring
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
bool BALL::String::has | ( | char | c | ) | const |
True, if the string contains character c
True, if the string contains the substring s after index from
iterator BALL::String::insert | ( | iterator | p, |
InputIterator | first, | ||
InputIterator | last ) |
void BALL::String::insert | ( | iterator | p, |
size_t | n, | ||
char | c ) |
String & BALL::String::insert | ( | size_t | pos, |
const char * | s ) |
String & BALL::String::insert | ( | size_t | pos, |
const char * | s, | ||
size_t | n ) |
String & BALL::String::insert | ( | size_t | pos, |
const string & | str ) |
String & BALL::String::insert | ( | size_t | pos, |
const string & | str, | ||
size_t | subpos, | ||
size_t | sublen ) |
String & BALL::String::insert | ( | size_t | pos, |
size_t | n, | ||
char | c ) |
Return a substring containing the first occurence of pattern in the string. If the pattern is not contained in the string, an empty Substring is returned. The search for the pattern may also start from an index different from zero, allowing incremental search.
pattern | the search pattern |
from | the index in the string to start the search from |
bool BALL::String::isAlnum | ( | ) | const |
True, if the string only contains letters and digits. It returns also true, if called for an empty string.
|
static |
True, if the character is a letter or a digit.
bool BALL::String::isAlpha | ( | ) | const |
True, if the string only contains letters (any case). It returns also true, if called for an empty string.
|
static |
True, if the character is a letter (any case)
bool BALL::String::isDigit | ( | ) | const |
True, if the string only contains digits. It returns also true, if called for an empty string.
|
static |
True, if the character is a digit.
bool BALL::String::isEmpty | ( | ) | const |
True, if the string has size 0.
bool BALL::String::isFloat | ( | ) | const |
True, if the string is a floating number. (It contains only numbers and maybe a dot). It returns also true, if called for an empty string.
bool BALL::String::isSpace | ( | ) | const |
True, if the string only contains spaces. It returns also true, if called for an empty string.
|
static |
True, if the character is a space.
bool BALL::String::isValid | ( | ) | const |
bool BALL::String::isWhitespace | ( | ) | const |
True, if the string only contains whitespace characters. Whitespaces are defined in CHARACTER_CLASS__WHITESPACE. It returns also true, if called for an empty string.
|
static |
True, if the character is any whitespace character. Whitespaces are defined in CHARACTER_CLASS__WHITESPACE
Return a substring containing the len leftmost characters of the string.
size_t BALL::String::length | ( | ) | const |
size_t BALL::String::max_size | ( | ) | const |
BALL::String::operator string & | ( | ) |
Cast the String to a std::string reference.
BALL::String::operator string const & | ( | ) | const |
Cast the String to a std::string reference, const version.
bool BALL::String::operator!= | ( | char | c | ) | const |
bool BALL::String::operator!= | ( | const char * | char_ptr | ) | const |
Inequality operator.
Exception::NullPointer | if char_ptr == NULL |
Return a substring
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
String & BALL::String::operator+= | ( | char | c | ) |
String & BALL::String::operator+= | ( | const char * | s | ) |
String & BALL::String::operator+= | ( | const string & | str | ) |
String & BALL::String::operator+= | ( | std::initializer_list< char > | il | ) |
bool BALL::String::operator< | ( | char | c | ) | const |
bool BALL::String::operator< | ( | const char * | char_ptr | ) | const |
Less than comparison
Exception::NullPointer | if char_ptr == NULL |
bool BALL::String::operator<= | ( | char | c | ) | const |
bool BALL::String::operator<= | ( | const char * | char_ptr | ) | const |
Less than or equal comparison
Exception::NullPointer | if char_ptr == NULL |
const String & BALL::String::operator= | ( | const char * | pc | ) |
Assign a String from a C type string
Exception::NullPointer | if pc == NULL |
const String & BALL::String::operator= | ( | std::stringstream & | s | ) |
Assign a string from a stringstream. The contents of the stringstream
object are not modified.
String & BALL::String::operator= | ( | string && | s | ) |
Move assignment operator for STL string.
bool BALL::String::operator== | ( | char | c | ) | const |
bool BALL::String::operator== | ( | const char * | char_ptr | ) | const |
Equality operator.
Exception::NullPointer | if char_ptr == NULL |
bool BALL::String::operator> | ( | char | c | ) | const |
bool BALL::String::operator> | ( | const char * | char_ptr | ) | const |
Greater than comparison
Exception::NullPointer | if char_ptr == NULL |
bool BALL::String::operator>= | ( | char | c | ) | const |
bool BALL::String::operator>= | ( | const char * | char_ptr | ) | const |
Greater than or equal comparison
Exception::NullPointer | if char_ptr == NULL |
char & BALL::String::operator[] | ( | size_t | pos | ) |
const char & BALL::String::operator[] | ( | size_t | pos | ) | const |
void BALL::String::pop_back | ( | ) |
void BALL::String::push_back | ( | char | c | ) |
reverse_iterator BALL::String::rbegin | ( | ) |
const_reverse_iterator BALL::String::rbegin | ( | ) | const |
reverse_iterator BALL::String::rend | ( | ) |
const_reverse_iterator BALL::String::rend | ( | ) | const |
String & BALL::String::replace | ( | iterator | i1, |
iterator | i2, | ||
InputIterator | first, | ||
InputIterator | last ) |
String & BALL::String::replace | ( | size_t | pos, |
size_t | len, | ||
const char * | s ) |
String & BALL::String::replace | ( | size_t | pos, |
size_t | len, | ||
const char * | s, | ||
size_t | n ) |
String & BALL::String::replace | ( | size_t | pos, |
size_t | len, | ||
const string & | str ) |
String & BALL::String::replace | ( | size_t | pos, |
size_t | len, | ||
const string & | str, | ||
size_t | subpos, | ||
size_t | sublen ) |
String & BALL::String::replace | ( | size_t | pos, |
size_t | len, | ||
size_t | n, | ||
char | c ) |
void BALL::String::reserve | ( | size_t | n = 0 | ) |
void BALL::String::resize | ( | size_t | n | ) |
void BALL::String::resize | ( | size_t | n, |
char | c ) |
Reverses the string. If called without arguments, this method simply reverses the character sequence of the string. By giving arguments for the indices, only a subsequence of the string may be reversed.
from | first index of the sequence to be reversed |
to | last index of the sequence to be reversed |
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
size_t BALL::String::rfind | ( | char | c, |
size_t | pos = npos ) const |
size_t BALL::String::rfind | ( | const char * | s, |
size_t | pos, | ||
size_t | n ) const |
size_t BALL::String::rfind | ( | const char * | s, |
size_t | pos = npos ) const |
size_t BALL::String::rfind | ( | const string & | str, |
size_t | pos = npos ) const |
Return a substring containing the len rightmost characters of the string.
void BALL::String::set | ( | char | c, |
Size | len = 1 ) |
Assign a String from the result of repeating c len times.
Assign a String from a C type string
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from >= size() |
Exception::NullPointer | if char_ptr == NULL |
void BALL::String::set | ( | const String & | s | ) |
Assign a string
Assign a String from a range of another string
Exception::IndexOverflow | if from < 0 |
Exception::IndexUnderflow | if from >= size() |
void BALL::String::set | ( | int | i | ) |
Assign a String from an int.
void BALL::String::set | ( | long | l | ) |
Assign a String from a long.
void BALL::String::set | ( | short | s | ) |
Assign a String from a short.
void BALL::String::set | ( | Size | buffer_size, |
const char * | format, | ||
... ) |
Assign a string to the result of a sprintf call
Exception::IndexUnderflow,if | the buffer size is zero |
Exception::NullPointer,<tt>format</tt> | is a NULL pointer |
void BALL::String::set | ( | std::stringstream & | s | ) |
Assign a String from a stringstream. The contents of the stringstream
object are not modified.
void BALL::String::set | ( | unsigned char | uc | ) |
Assign a String from an unsigned char.
void BALL::String::set | ( | unsigned int | ui | ) |
Assign a String from an unsigned int.
void BALL::String::set | ( | unsigned long | ul | ) |
Assign a String from an unsigned long.
void BALL::String::set | ( | unsigned short | us | ) |
Assign a String from an unsigned short.
|
static |
Set the compareison mode for all string comparisons.
void BALL::String::shrink_to_fit | ( | ) |
size_t BALL::String::size | ( | ) | const |
Size BALL::String::split | ( | std::vector< String > & | strings, |
const char * | delimiters = CHARACTER_CLASS__WHITESPACE, | ||
Index | from = 0 ) const |
Split the string into fields and assign these field to a vector of strings. The vector of strings is cleared in any case. Its final size is returned.
IndexOverflow | if from < 0 |
NullPointer | if delimiters == 0 |
Size BALL::String::split | ( | String | string_array[], |
Size | array_size, | ||
const char * | delimiters = CHARACTER_CLASS__WHITESPACE, | ||
Index | from = 0 ) const |
Split the string into fields and assign these field to an array of strings
Exception::IndexUnderflow | if from < 0 |
Exception::NullPointer | if delimiters == NULL |
Size BALL::String::splitQuoted | ( | std::vector< String > & | strings, |
const char * | delimiters = CHARACTER_CLASS__WHITESPACE, | ||
const char * | quotes = CHARACTER_CLASS__QUOTES, | ||
Index | from = 0 ) const |
Split the string into fields and respect quote characters. Similar to split , but delimiters that are inside quote characters (default is CHARACTER_CLASS__QUOTES ) are not considered to split the string. The vector of strings is cleared in any case. Its final size is returned.
IndexOverflow | if from < 0 |
NullPointer | if delimiters == 0 |
Substitute the first occurence of to_replace by the content of replacing.
Substitute all occurences of to_replace by the content of replacing.
string BALL::String::substr | ( | size_t | pos = 0, |
size_t | len = npos ) const |
void BALL::String::swap | ( | string & | str | ) |
Return a substring containing the beginning of the string including the first occurence of s
bool BALL::String::toBool | ( | ) | const |
Converts the string to a bool value. This method returns false, if the string contains the string false
(may be surrounded by whitespaces), or true otherwise.
char BALL::String::toChar | ( | ) | const |
Return the first character of the string.
double BALL::String::toDouble | ( | ) | const |
Convert the string to a double
Exception::InvalidFormat |
float BALL::String::toFloat | ( | ) | const |
Convert the string to a float
Exception::InvalidFormat |
int BALL::String::toInt | ( | ) | const |
Convert the string to an int
Exception::InvalidFormat |
long BALL::String::toLong | ( | ) | const |
Convert the string to a long
Exception::InvalidFormat |
Convert all characters in the given range to lower case
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from || len >= size() |
short BALL::String::toShort | ( | ) | const |
Convert the string to a short
Exception::InvalidFormat |
unsigned char BALL::String::toUnsignedChar | ( | ) | const |
Return the first character of the string converted to an unsigned char.
unsigned int BALL::String::toUnsignedInt | ( | ) | const |
Convert the string to an unsigned int
Exception::InvalidFormat |
unsigned long BALL::String::toUnsignedLong | ( | ) | const |
Convert the string to an unsigned long
Exception::InvalidFormat |
unsigned short BALL::String::toUnsignedShort | ( | ) | const |
Convert the string to an unsigned short
Exception::InvalidFormat |
Convert all characters in the given range to upper case
Exception::IndexUnderflow | if from < 0 |
Exception::IndexOverflow | if from || len >= size() |
String & BALL::String::trim | ( | const char * | trimmed = CHARACTER_CLASS__WHITESPACE | ) |
Strips all characters in trimmed from both sides of the string. trim calls trimRight(trimmed).trimLeft(trimmed)
.
String BALL::String::trim | ( | const char * | trimmed = CHARACTER_CLASS__WHITESPACE | ) | const |
Strips all characters in trimmed from both sides of the string. trim calls trimRight(trimmed).trimLeft(trimmed)
.
String & BALL::String::trimLeft | ( | const char * | trimmed = CHARACTER_CLASS__WHITESPACE | ) |
Strips all characters in trimmed from the left of the string. trimLeft stops at the first character encountered that is not in trimmed. Using its default parameter CHARACTER_CLASS__WHITESPACE, it is usually handy to remove blanks from the beginning of a string. Strings consisting of character from trimmed
only yield an empty string.
String & BALL::String::trimRight | ( | const char * | trimmed = CHARACTER_CLASS__WHITESPACE | ) |
Strips all characters in trimmed from the right of the string. trimRight stops at the first character encountered that is not in trimmed. Using its default parameter CHARACTER_CLASS__WHITESPACE, it is usually handy to remove blanks from the end of a string. Strings consisting of character from trimmed
only yield an empty string.
|
staticprotected |
|
protected |
|
staticprotected |
|
friend |
|
friend |
Inequality operator.
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Inequality operator.
|
friend |
Concatenates a character and a string.
|
friend |
Concatenates a character and a string.
|
friend |
Concatenates a C type string and a string.
|
friend |
Concatenates a C type string and a string.
|
friend |
Concatenates a string and a character.
|
friend |
Concatenates a string and a C type string.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates a string and a character.
|
friend |
Concatenates a string and a C type string.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
Concatenates two strings.
|
friend |
|
friend |
Less than comparison
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Less than comparison
|
friend |
|
friend |
Less than or equal comparison
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Less than or equal comparison
|
friend |
|
friend |
Equality operator.
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Equality operator.
|
friend |
|
friend |
Greater than comparison
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Greater than comparison
|
friend |
Greater than or equal comparison
Exception::NullPointer | if char_ptr == NULL |
|
friend |
Greater than or equal comparison
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |