DWString Class

Simple Unicode string class for use in the dtSearch C++ Support classes and sample code.

File

File: dstring.h

Namespace: dtSearch

<< Operator
= Operator
DWString Constructor
contains Method
find Method

Syntax

C++

class DWString;

Group

Classes

Members

Operators

Operator	Description
<<(char)	Append a single character
<<(const char *)	Append a single-byte string without conversion
<<(int)	Format an integer value as a string and append the string
<<(long)	Format an integer value as a string and append the string
<<(unsigned char)	Append a single character
<<(unsigned short)	Append a single character
<<(wchar_t)	Append a single character
<<(const wchar_t *)	Append a string
=(const DWString&)	Copy a string
=(const char *)	Copy a string
=(const wchar_t *)	Copy a string
const wchar_t *	Returns start of the Unicode buffer

Methods

Method	Description
DWString()	Construct an empty Unicode string
DWString(const DWString&)	Construct a Unicode string from another Unicode string
DWString(const char *)	Construct a Unicode string from UTF-8 text
DWString(ptrdiff_t)	Construct an empty Unicode string, specifying the initial length of the bfufer
DWString(wchar_t *, int, bool)	Construct an empty Unicode string, using a pre-existing buffer
DWString(const wchar_t *)	Construct a Unicode string from Unicode text
append	Append Unicode text to the string
appendChar	Append a single character
appendCharNT	! Append without null-termination for faster building of strings
clear	Clear all text in the string
contains(wchar_t)	Determine whether a characters exists in this string
contains(const wchar_t *)	Determine whether a substring is contained in this string
copy	Copy a string
extend	Extend the string buffer to a minimum length
find(wchar_t, ptrdiff_t)	Find a character
find(const wchar_t *, ptrdiff_t)	Find a substring
first	First character in the string, or null if the string is empty
getChar	Get one character
getFromU8	Read Unicode text from a file
getFromUi	Read contents of a file as Unicode
getLength	Returns the number of characters in the string
getUtf8	Convert the string to UTF-8
hms	Format a time as HHHH/MM/SS
icontains	Determine whether a substring is contained in this string (case-insensitive)
ifind	Find a substring (case-insensitive)
insert	Insert characters in front of the string
isBlank	Returns true if the string is empty or contains only whitespace
isBlankUnicode	Returns true if the string is empty or contains only whitespace, checking for Unicode whitespace
last	Returns the last character in the string, or null if the string is empty
nullTerminate	! Null-terminate the string (use after calling appendCharNT)
packWhite	Remove leading whitespace and pack all other whitespace to a single space character
padTo	Fill string with a character
remove	Remove a range of characters from the string
rfind	Find a character, starting at the end of the string
rlwhite	Remove leading whitespace
rtwhite	Remove trailing whitespace
setChar	Get one character
setLength	Set the length of the string, null-terminating the contents of the buffer
store	Transfer nChars of Unicode text from another buffer
storeAsciiAsUnicode	Store characters known to be in the range 1..128 without conversion
storeUtf8AsUnicode	Store UTF-8 text as Unicode, replacing any contents in the string
toLower	Convert to lower case
toUpper	Convert to upper case
trim	Remove leading and trailing whitespace
truncate	Truncate the string
tryExtend	Try to extend the string buffer to a minimum length, and return false if unsuccessful
writeToU8	Write Unicode text to a file
writeToUi	Write Unicode text to a file
ymd	Format a date as YYYY/MM/DD

Methods

Method	Description
DWString()	Construct an empty Unicode string
DWString(const DWString&)	Construct a Unicode string from another Unicode string
DWString(const char *)	Construct a Unicode string from UTF-8 text
DWString(ptrdiff_t)	Construct an empty Unicode string, specifying the initial length of the bfufer
DWString(wchar_t *, int, bool)	Construct an empty Unicode string, using a pre-existing buffer
DWString(const wchar_t *)	Construct a Unicode string from Unicode text
append	Append Unicode text to the string
appendChar	Append a single character
appendCharNT	! Append without null-termination for faster building of strings
clear	Clear all text in the string
contains(wchar_t)	Determine whether a characters exists in this string
contains(const wchar_t *)	Determine whether a substring is contained in this string
copy	Copy a string
extend	Extend the string buffer to a minimum length
find(wchar_t, ptrdiff_t)	Find a character
find(const wchar_t *, ptrdiff_t)	Find a substring
first	First character in the string, or null if the string is empty
getChar	Get one character
getFromU8	Read Unicode text from a file
getFromUi	Read contents of a file as Unicode
getLength	Returns the number of characters in the string
getUtf8	Convert the string to UTF-8
hms	Format a time as HHHH/MM/SS
icontains	Determine whether a substring is contained in this string (case-insensitive)
ifind	Find a substring (case-insensitive)
insert	Insert characters in front of the string
isBlank	Returns true if the string is empty or contains only whitespace
isBlankUnicode	Returns true if the string is empty or contains only whitespace, checking for Unicode whitespace
last	Returns the last character in the string, or null if the string is empty
nullTerminate	! Null-terminate the string (use after calling appendCharNT)
packWhite	Remove leading whitespace and pack all other whitespace to a single space character
padTo	Fill string with a character
remove	Remove a range of characters from the string
rfind	Find a character, starting at the end of the string
rlwhite	Remove leading whitespace
rtwhite	Remove trailing whitespace
setChar	Get one character
setLength	Set the length of the string, null-terminating the contents of the buffer
store	Transfer nChars of Unicode text from another buffer
storeAsciiAsUnicode	Store characters known to be in the range 1..128 without conversion
storeUtf8AsUnicode	Store UTF-8 text as Unicode, replacing any contents in the string
toLower	Convert to lower case
toUpper	Convert to upper case
trim	Remove leading and trailing whitespace
truncate	Truncate the string
tryExtend	Try to extend the string buffer to a minimum length, and return false if unsuccessful
writeToU8	Write Unicode text to a file
writeToUi	Write Unicode text to a file
ymd	Format a date as YYYY/MM/DD

Operators

Operator	Description
<<(char)	Append a single character
<<(const char *)	Append a single-byte string without conversion
<<(int)	Format an integer value as a string and append the string
<<(long)	Format an integer value as a string and append the string
<<(unsigned char)	Append a single character
<<(unsigned short)	Append a single character
<<(wchar_t)	Append a single character
<<(const wchar_t *)	Append a string
=(const DWString&)	Copy a string
=(const char *)	Copy a string
=(const wchar_t *)	Copy a string
const wchar_t *	Returns start of the Unicode buffer

Class Hierarchy

dtSearch::DWString