#include <wstring.h>
Public Member Functions | |
~wstring () | |
wstring () | |
wstring (const char *arg) | |
wstring (const wchar_t *arg) | |
wstring (const char *data, size_t len) | |
wstring (const wchar_t *data, size_t len) | |
wstring (wstring_ty *arg) | |
wstring (string_ty *arg) | |
wstring (const nstring &arg) | |
wstring (const wstring &arg) | |
wstring & | operator= (const wstring &arg) |
void | clear () |
const wchar_t * | c_str () const |
nstring | to_nstring () const |
bool | empty () const |
size_t | size () const |
size_t | length () const |
wstring | catenate (const wstring &arg) const |
join two strings together | |
wstring | operator+ (const wstring &arg) const |
wstring & | operator+= (const wstring &arg) |
wstring | cat_three (const wstring &str2, const wstring &str3) const |
joing strings together | |
wstring | upcase () const |
convert to upper case | |
wstring | downcase () const |
convert to lower case | |
wstring | capitalize () const |
convert to title case | |
bool | equal (const wstring &arg) const |
test string equality | |
bool | operator== (const wstring &arg) const |
bool | operator!= (const wstring &arg) const |
wstring_ty * | get_ref () const |
wstring | identifier () const |
char | operator[] (size_t n) const |
int | column_width () const |
Static Private Member Functions | |
static wstring_ty * | get_empty_ref () |
Private Attributes | |
wstring_ty * | ref |
This is a wide string class, using wchar_t as the internal character type. For ordinary narrow strings, which use char as the internal character type, see the nstring class.
Definition at line 41 of file wstring.h.
wstring::~wstring | ( | ) |
The destructor.
This destructor is not virtual, do not derive from this class.
wstring::wstring | ( | const char * | arg | ) | [inline, explicit] |
wstring::wstring | ( | const wchar_t * | arg | ) | [inline, explicit] |
wstring::wstring | ( | const char * | data, | |
size_t | len | |||
) | [inline] |
wstring::wstring | ( | const wchar_t * | data, | |
size_t | len | |||
) | [inline] |
wstring::wstring | ( | wstring_ty * | arg | ) | [inline] |
wstring::wstring | ( | string_ty * | arg | ) |
The constructor.
This will be DEPRECATED as soon as possible.
wstring::wstring | ( | const nstring & | arg | ) |
The constructor.
wstring::wstring | ( | const wstring & | arg | ) | [inline] |
void wstring::clear | ( | ) |
The clear method may be used to discard the contents of the string, and replace it with the empty string.
const wchar_t* wstring::c_str | ( | ) | const [inline] |
nstring wstring::to_nstring | ( | ) | const |
The to_nstring method is used to convert a wide string to a narrow string.
join two strings together
The wstr_catenate function is used to join two strings togther to form a new string. The are joined in the order given.
arg | A string to be joined. Will not be modified. |
joing strings together
The wstr_cat_three function is used to join three strings together to form a new string. The are joined in the order given.
str2 | A string to be joined. Will not be modified. | |
str3 | A string to be joined. Will not be modified. |
wstring wstring::upcase | ( | ) | const [inline] |
convert to upper case
The wstr_upcase function is used to create a new string where the lower case characters in the input string are converted to upper case.
wstring wstring::downcase | ( | ) | const [inline] |
convert to lower case
The wstr_downcase function is used to create a new string where the upper case characters in the input string are converted to lower case.
wstring wstring::capitalize | ( | ) | const [inline] |
convert to title case
The wstr_capitalize function is used to create a new string where the first letter or each word of the inopuyt string are upper case, and the remaining letters in each word are lower case. (Sometimes called Title Case.)
bool wstring::equal | ( | const wstring & | arg | ) | const [inline] |
test string equality
The wstr_equal function is used to test to see if two strings are exactly the same.
arg | A string to be compared. Will not be modified. |
bool wstring::operator== | ( | const wstring & | arg | ) | const [inline] |
bool wstring::operator!= | ( | const wstring & | arg | ) | const [inline] |
wstring_ty* wstring::get_ref | ( | ) | const [inline] |
The get_ref method is used to extract the reference to the underlying reference counted string object. If the ref pointer is NULL a pointer to a common empty string object is returned.
Once the sources cease using wstring_ty directly, this method will become private.
wstring wstring::identifier | ( | ) | const [inline] |
char wstring::operator[] | ( | size_t | n | ) | const [inline] |
The indexing operator is used to extract the nth character of a string. Indexes out of range will result in the NUL character ('') being returned.
n | The character to extract. Zero based. |
int wstring::column_width | ( | ) | const [inline] |
static wstring_ty* wstring::get_empty_ref | ( | ) | [inline, static, private] |
The get_empty_ref() class method is used to get a pointer to an underlying string object of length zero.
wstring_ty* wstring::ref [private] |