activemq-cpp-3.9.0
|
A modifiable sequence of characters for use in creating and modifying Strings. More...
#include <src/main/decaf/lang/StringBuilder.h>
Public Member Functions | |
StringBuilder () | |
Creates an empty StringBuilder instance with a capacity of 16. More... | |
StringBuilder (int capacity) | |
Creates an empty StringBuilder instance with the given capacity. More... | |
StringBuilder (const String &source) | |
Constructs a string builder initialized to the contents of the specified string. More... | |
StringBuilder (const CharSequence *source) | |
Constructs a string builder initialized to the contents of the specified string. More... | |
virtual | ~StringBuilder () |
virtual int | length () const |
Returns the current length of the String that has been built. More... | |
template<typename POINTER > | |
StringBuilder & | append (const POINTER *pointer) |
Appends the string representation of the given object pointer. More... | |
template<typename TYPE > | |
StringBuilder & | append (const Pointer< TYPE > pointer) |
Appends the string representation of the given object pointer. More... | |
StringBuilder & | append (bool value) |
Appends the string representation of the given boolean value. More... | |
StringBuilder & | append (char value) |
Appends the given char value into the internal char buffer. More... | |
StringBuilder & | append (short value) |
Appends the given short value into the internal char buffer. More... | |
StringBuilder & | append (int value) |
Appends the given int value into the internal char buffer. More... | |
StringBuilder & | append (long long value) |
Appends the given long long value into the internal char buffer. More... | |
StringBuilder & | append (float value) |
Appends the given float value into the internal char buffer. More... | |
StringBuilder & | append (double value) |
Appends the given double value into the internal char buffer. More... | |
StringBuilder & | append (const char *value) |
Appends the contents of the given C string into this buffer. More... | |
StringBuilder & | append (const char *value, int offset, int length) |
Appends the given subsequence of the given C string into this buffer. More... | |
StringBuilder & | append (const CharSequence *value) |
Appends the contents of the CharSequence into this buffer, if the CharSequence pointer is NULL then this method appends the string "null" to this Buffer. More... | |
StringBuilder & | append (const CharSequence *value, int offset, int length) |
Appends the given CharSequence to this buffer starting at the given offset and ending after the length number of characters has been append. More... | |
StringBuilder & | append (const String &value) |
Appends the contents of the String into this buffer. More... | |
StringBuilder & | append (const StringBuffer &value) |
Appends the contents of the StringBuffer into this buffer. More... | |
StringBuilder & | deleteRange (int start, int end) |
Removes the characters in a substring of this buffer. More... | |
StringBuilder & | deleteCharAt (int index) |
Deletes the char at the specified position in this buffer, length decreases by one. More... | |
template<typename POINTER > | |
StringBuilder & | insert (int index, const POINTER *pointer) |
Inserts the string representation of the given object pointer. More... | |
template<typename TYPE > | |
StringBuilder & | insert (int index, const Pointer< TYPE > pointer) |
Inserts the string representation of the given object pointer. More... | |
StringBuilder & | insert (int index, char value) |
Inserts the given char into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, bool value) |
Inserts the given boolean into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, short value) |
Inserts the given short into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, int value) |
Inserts the given int into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, long long value) |
Inserts the given long long into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, float value) |
Inserts the given float into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, double value) |
Inserts the given double into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, const char *value) |
Inserts the given C string into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, const String &value) |
Inserts the given String into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, const std::string &value) |
Inserts the given std::string into the character buffer at the given index. More... | |
StringBuilder & | insert (int index, const char *value, int offset, int length) |
Inserts the given C string into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer. More... | |
StringBuilder & | insert (int index, const CharSequence *value) |
Inserts the given CharSequence into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer. More... | |
StringBuilder & | insert (int index, const CharSequence *value, int offset, int length) |
Inserts the given CharSequence into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer. More... | |
StringBuilder & | replace (int start, int end, const String &value) |
Replace some number of characters in this Buffer with the value given. More... | |
StringBuilder & | reverse () |
Reverses the order of characters in this builder. More... | |
![]() | |
AbstractStringBuilder () | |
AbstractStringBuilder (int capacity) | |
AbstractStringBuilder (const String &source) | |
AbstractStringBuilder (const std::string &source) | |
AbstractStringBuilder (const CharSequence *source) | |
virtual | ~AbstractStringBuilder () |
virtual int | capacity () const |
Returns the current capacity. More... | |
virtual char | charAt (int index) const |
Returns the character at the given index. More... | |
virtual void | ensureCapacity (int minCapacity) |
Ensures that the capacity is at least equal to the specified min value. More... | |
virtual void | getChars (int start, int end, char *dst, int dstSize, int dstStart) const |
Copies characters from this character buffer into the given character array. More... | |
virtual int | indexOf (const String &value) const |
Search for the index within this string of the first occurrence of the specified substring. More... | |
virtual int | indexOf (const String &value, int start) const |
Search for the index within this string of the first occurrence of the specified substring starting at the given position and moving towards the end of this String. More... | |
virtual int | lastIndexOf (const String &value) const |
Search for the last index within this string where the given substring can be found. More... | |
virtual int | lastIndexOf (const String &value, int start) const |
Search for the last index within this string where the given substring can be found starting from the specified index and moving towards the beginning of the string. More... | |
virtual void | setLength (int length) |
Sets the length of this character buffer. More... | |
virtual void | setCharAt (int index, char value) |
Sets the character at the specified index to the new char value given. More... | |
virtual String | substring (int start) const |
Returns a new String that contains a subset of the characters currently contained in this character buffer. More... | |
virtual String | substring (int start, int end) const |
Returns a new String that contains a subset of the characters currently contained in this character buffer. More... | |
virtual CharSequence * | subSequence (int start, int end) const |
Creates and returns a new CharSequence object that is a subset of the characters contained in this character buffer. More... | |
virtual String | toString () const |
Returns a String that represents the contents of this buffer. More... | |
virtual void | trimToSize () |
Attempts to reduce storage used for the character sequence. More... | |
![]() | |
SynchronizableImpl () | |
virtual | ~SynchronizableImpl () |
virtual void | lock () |
Locks the object. More... | |
virtual bool | tryLock () |
Attempts to Lock the object, if the lock is already held by another thread than this method returns false. More... | |
virtual void | unlock () |
Unlocks the object. More... | |
virtual void | wait () |
Waits on a signal from this object, which is generated by a call to Notify. More... | |
virtual void | wait (long long millisecs) |
Waits on a signal from this object, which is generated by a call to Notify. More... | |
virtual void | wait (long long millisecs, int nanos) |
Waits on a signal from this object, which is generated by a call to Notify. More... | |
virtual void | notify () |
Signals a waiter on this object that it can now wake up and continue. More... | |
virtual void | notifyAll () |
Signals the waiters on this object that it can now wake up and continue. More... | |
![]() | |
virtual | ~Synchronizable () |
![]() | |
virtual | ~Appendable () |
Additional Inherited Members | |
![]() | |
void | doAppendNull () |
Appends the string "null" to the current character buffer. More... | |
void | doAppend (const char value) |
Appends the given char to this buffer. More... | |
void | doAppend (const char *value) |
Appends the given C string to this buffer. More... | |
void | doAppend (const char *value, int offset, int length) |
Appends the given C string to this buffer starting at the given offset and ending after the length number of characters has been appended. More... | |
void | doAppend (const CharSequence *value) |
Appends the given CharSequence to this buffer. More... | |
void | doAppend (const CharSequence *value, int offset, int length) |
Appends the given CharSequence to this buffer starting at the given offset and ending after the length number of characters has been appended. More... | |
void | doAppend (const std::string &value) |
Append the given std::string to this buffer. More... | |
void | doAppend (const String &value) |
Append the given String to this buffer. More... | |
void | doAppend (const AbstractStringBuilder &value) |
Append the given AbstractStringBuilder to this buffer. More... | |
void | doDeleteRange (int start, int end) |
Delete the characters in the range start - end. More... | |
void | doDeleteCharAt (int index) |
Deletes the character at the given index from this buffer. More... | |
void | doInsert (int index, char value) |
Inserts a single char value at the given index. More... | |
void | doInsert (int index, const char *value) |
Inserts a C string value at the given index. More... | |
void | doInsert (int index, const String &value) |
Inserts a String value at the given index. More... | |
void | doInsert (int index, const std::string &value) |
Inserts a std::string value at the given index. More... | |
void | doInsert (int index, const char *value, int offset, int length) |
Inserts the given C string at the given index in this buffer starting at the given offset and ending after the length number of characters has been appended. More... | |
void | doInsert (int index, const CharSequence *value) |
Inserts the given CharSequence at the given index in this buffer. More... | |
void | doInsert (int index, const CharSequence *value, int start, int end) |
Inserts the given CharSequence at the given index in this buffer starting at the given index and ending at the specified end index. More... | |
void | doReplace (int start, int end, const String &value) |
Replace some number of characters in this Buffer with the value given. More... | |
void | doReverse () |
Reverses the characters contained in this character buffer. More... | |
![]() | |
decaf::util::concurrent::Mutex | mutex |
![]() | |
static const int | INITIAL_CAPACITY |
A modifiable sequence of characters for use in creating and modifying Strings.
This class is intended as a direct replacement of StringBuffer for non-concurrent use; unlike StringBuffer this class is not synchronized for thread safety.
The majority of the modification methods on this class return a reference to this StringBuilder, so that, like StringBuffers, they can be used in chaining method calls together. For example:
StringBuilder("One should ").append("always strive ").append("to achieve Harmony")}.
decaf::lang::StringBuilder::StringBuilder | ( | ) |
Creates an empty StringBuilder instance with a capacity of 16.
decaf::lang::StringBuilder::StringBuilder | ( | int | capacity | ) |
Creates an empty StringBuilder instance with the given capacity.
capacity | The initial capacity to give this new instance. |
NegativeArraySizeException | if the given capacity is less than zero. |
Constructs a string builder initialized to the contents of the specified string.
The initial capacity of the string builder is 16 plus the length of the string argument.
source | The String whose contents are to be copied into this StringBuilder. |
decaf::lang::StringBuilder::StringBuilder | ( | const CharSequence * | source | ) |
Constructs a string builder initialized to the contents of the specified string.
The initial capacity of the string builder is 16 plus the length of the string argument.
source | The CharSequence whose contents are to be copied into this StringBuilder. |
NullPointerException | if the CharSequence pointer is NULL. |
|
virtual |
|
inline |
Appends the string representation of the given object pointer.
If the pointer is NULL then the value "null" is appended to this StringBuilder.
pointer | A pointer to some object that must define a toString method. |
References NULL.
|
inline |
Appends the string representation of the given object pointer.
If the pointer is NULL then the value "null" is appended to this StringBuilder.
pointer | A pointer to some object that must define a toString method. |
References NULL.
StringBuilder& decaf::lang::StringBuilder::append | ( | bool | value | ) |
Appends the string representation of the given boolean value.
value | The value to append to the contents of the StringBuilder. |
|
virtual |
Appends the given char value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
Implements decaf::lang::Appendable.
StringBuilder& decaf::lang::StringBuilder::append | ( | short | value | ) |
Appends the given short value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | int | value | ) |
Appends the given int value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | long long | value | ) |
Appends the given long long value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | float | value | ) |
Appends the given float value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | double | value | ) |
Appends the given double value into the internal char buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | const char * | value | ) |
Appends the contents of the given C string into this buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | const char * | value, |
int | offset, | ||
int | length | ||
) |
Appends the given subsequence of the given C string into this buffer.
value | The C string value to be appended into this buffer. |
offset | The starting position into the C string array. |
length | The number of characters to copy from the given array. |
NullPointerException | if the pointer is NULL. |
IndexOutOfBoundsException | if offset or length is negative or the value of offset + length is greater than the strings length. |
|
virtual |
Appends the contents of the CharSequence into this buffer, if the CharSequence pointer is NULL then this method appends the string "null" to this Buffer.
value | The CharSequence value to be appended into this buffer. |
Implements decaf::lang::Appendable.
|
virtual |
Appends the given CharSequence to this buffer starting at the given offset and ending after the length number of characters has been append.
If the given CharSequence pointer is NULL then this method appends the string "null".
value | The CharSequence value to be appended into this buffer. |
offset | The starting position into the CharSequence. |
length | The number of characters to copy from the given CharSequence. |
IndexOutOfBoundsException | if offset or length is negative or the value of offset + length is greater than the strings length. |
Implements decaf::lang::Appendable.
StringBuilder& decaf::lang::StringBuilder::append | ( | const String & | value | ) |
Appends the contents of the String into this buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::append | ( | const StringBuffer & | value | ) |
Appends the contents of the StringBuffer into this buffer.
value | The value to append to the contents of the StringBuilder. |
StringBuilder& decaf::lang::StringBuilder::deleteCharAt | ( | int | index | ) |
Deletes the char at the specified position in this buffer, length decreases by one.
index | The index in this buffer where the character to delete is located. |
StringIndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::deleteRange | ( | int | start, |
int | end | ||
) |
Removes the characters in a substring of this buffer.
The substring begins at the specified start and extends to the character at index end - 1 or to the end of the sequence if end is greater than the current length() value. If start is equal to end, no changes are made.
start | The starting index to delete from this buffer. |
end | The ending index (exclusive) to delete from this buffer. |
StringIndexOutOfBoundsException | if start is negative, greater than length(), or greater than end. |
|
inline |
Inserts the string representation of the given object pointer.
If the pointer is NULL then the value "null" is inserted to this StringBuilder.
index | The position in the buffer to insert the char value. |
pointer | A pointer to some object that must define a toString method. |
References NULL.
|
inline |
Inserts the string representation of the given object pointer.
If the pointer is NULL then the value "null" is inserted to this StringBuilder.
index | The position in the buffer to insert the char value. |
pointer | A pointer to some object that must define a toString method. |
References NULL.
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
char | value | ||
) |
Inserts the given char into the character buffer at the given index.
The contents of the buffer are shifted up by one from the given index prior to insertion.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
bool | value | ||
) |
Inserts the given boolean into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(bool).
index | The position in the buffer to insert the boolean value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
short | value | ||
) |
Inserts the given short into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(short).
index | The position in the buffer to insert the short value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
int | value | ||
) |
Inserts the given int into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(int).
index | The position in the buffer to insert the int value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
long long | value | ||
) |
Inserts the given long long into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(long long).
index | The position in the buffer to insert the long long value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
float | value | ||
) |
Inserts the given float into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(float).
index | The position in the buffer to insert the float value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
double | value | ||
) |
Inserts the given double into the character buffer at the given index.
The value is converted to a String in the same fashion as calling String::valueOf(double).
index | The position in the buffer to insert the double value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const char * | value | ||
) |
Inserts the given C string into the character buffer at the given index.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
NullPointerException | if the target C string pointer is NULL. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const String & | value | ||
) |
Inserts the given String into the character buffer at the given index.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
NullPointerException | if the target C string pointer is NULL. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const std::string & | value | ||
) |
Inserts the given std::string into the character buffer at the given index.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
NullPointerException | if the target std::string pointer is NULL. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const char * | value, | ||
int | offset, | ||
int | length | ||
) |
Inserts the given C string into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
offset | The offset into the C string to start the copy from. |
length | The number of characters to copy from the given C string. |
NullPointerException | if the target C string pointer is NULL. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). If offset or length is negative or offset > the string length + length. |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const CharSequence * | value | ||
) |
Inserts the given CharSequence into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer.
If the CharSequence pointer is NULL then this method inserts the string "null" into this Buffer.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). |
StringBuilder& decaf::lang::StringBuilder::insert | ( | int | index, |
const CharSequence * | value, | ||
int | offset, | ||
int | length | ||
) |
Inserts the given CharSequence into the character buffer at the given index starting from the given offset into the string and copying up to length chars from the string into this buffer.
If the CharSequence pointer is NULL then this method inserts the string "null" into this Buffer.
index | The position in the buffer to insert the char value. |
value | The value to insert at the given index. |
offset | The offset into the CharSequence to start the copy from. |
length | The number of characters to copy from the given CharSequence. |
IndexOutOfBoundsException | if the index is negative or greater than or equal to length(). If offset or length is negative or offset > the string length + length. |
|
virtual |
Returns the current length of the String that has been built.
Reimplemented from decaf::lang::AbstractStringBuilder.
StringBuilder& decaf::lang::StringBuilder::replace | ( | int | start, |
int | end, | ||
const String & | value | ||
) |
Replace some number of characters in this Buffer with the value given.
The characters replaced start at the given index and end at the given end value (exclusive). If the replacement string value is longer the internal buffer is lengthened to accommodate the new value.
start | The starting index to replace in the buffer (inclusive). |
end | The ending index of the replacement operation (exclusive). |
value | The new string value to replace the older value. |
IndexOutOfBoundsException | if start is negative, greater than end or greater than length(). |
StringBuilder& decaf::lang::StringBuilder::reverse | ( | ) |
Reverses the order of characters in this builder.