NarrowString Class Reference

MBCS or ASCII single-byte oriented string. This class implements an API similar to the ICU UnicodeString and the same as WideString. More...

#include <StringWrapper.h>

Public Member Functions
	NarrowString ()
	NarrowString (const char *text)
	NarrowString (const char *text, int32_t len)
	NarrowString (const NarrowString &text)
	NarrowString (const NarrowString &text, int32_t start)
	NarrowString (const NarrowString &text, int32_t start, int32_t len)
	~NarrowString ()
Length
bool	isEmpty () const
int32_t	length () const
Assign
NarrowString &	operator= (const NarrowString &text)
NarrowString &	operator= (const char *text)
NarrowString &	operator= (char ch)
NarrowString &	setTo (const NarrowString &text)
NarrowString &	setTo (const NarrowString &text, int32_t start)
NarrowString &	setTo (const NarrowString &text, int32_t start, int32_t len)
NarrowString &	setTo (const char *text)
NarrowString &	setTo (const char *text, int32_t len)
NarrowString &	setTo (char ch)
Append
NarrowString &	operator+= (const NarrowString &text)
NarrowString &	operator+= (const char *text)
NarrowString &	operator+= (char ch)
NarrowString &	append (const NarrowString &text)
NarrowString &	append (const NarrowString &text, int32_t start, int32_t len)
NarrowString &	append (const char *text, int32_t len)
NarrowString &	append (const char *text, int32_t start, int32_t len)
NarrowString &	append (char ch)
Compare
bool	operator== (const NarrowString &text) const
bool	operator!= (const NarrowString &text) const
bool	operator> (const NarrowString &text) const
bool	operator>= (const NarrowString &text) const
bool	operator< (const NarrowString &text) const
bool	operator<= (const NarrowString &text) const
int8_t	compare (const NarrowString &text) const
int8_t	compare (const NarrowString &text, int32_t len) const
int8_t	compare (const char *text) const
int8_t	compare (const char *text, int32_t len) const
int8_t	compare (int32_t start, int32_t len, const char *srcChars, int32_t srcStart, int32_t srcLength) const
int8_t	caseCompare (const NarrowString &text) const
int8_t	caseCompare (const char *text) const
int8_t	caseCompare (const NarrowString &text, int32_t len) const
int8_t	caseCompare (const char *text, int32_t len) const
int8_t	caseCompare (const NarrowString &text, int32_t start, int32_t len) const
int8_t	caseCompare (const char *text, int32_t start, int32_t len) const
Character
char	first () const
char	last () const
char	operator[] (int32_t offset) const
char	getCharAt (int32_t offset) const
NarrowString &	setCharAt (int32_t offset, char ch)
Buffer
const char *	getBuffer () const
char *	getBuffer (int32_t minCapacity)
void	releaseBuffer (int32_t newLength=-1)
int32_t	getCapacity () const
void	setCapacity (int32_t newSiz)
Delete
NarrowString &	remove ()
NarrowString &	remove (int32_t start, int32_t len=INT32_MAX)
bool	truncate (int32_t targetLength)
Insert
NarrowString &	insert (int32_t offset, const NarrowString &text)
NarrowString &	insert (int32_t offset, const char *text)
NarrowString &	insert (int32_t offset, const char *text, int32_t len)
NarrowString &	insert (int32_t offset, char ch)
Modify
NarrowString &	toUpper ()
NarrowString &	toLower ()
NarrowString &	trim ()
Search
int32_t	indexOf (char c, int32_t start=0) const
int32_t	indexOf (const NarrowString &text, int32_t start=0) const
int32_t	indexOf (const char *text, int32_t start=0) const
int32_t	lastIndexOf (char c, int32_t start=-1) const
int32_t	lastIndexOf (const NarrowString &text, int32_t start=-1) const
int32_t	lastIndexOf (const char *text, int32_t start=-1) const
int32_t	lastIndexOf (const char *text, int32_t start, int32_t len) const
Replace
NarrowString &	replace (int32_t start, int32_t len, char srcChar)
NarrowString &	replace (int32_t start, int32_t len, const NarrowString &text)
NarrowString &	replace (int32_t start, int32_t len, const char *srcText, int32_t srcLength=-1)
NarrowString &	findAndReplace (char chOld, char chNew)
NarrowString &	findAndReplace (const NarrowString &oldText, const NarrowString &newText)
Format
String formatting functionality like sprintf.
void	format (const char *a_pszFormat,...)
void	formatV (const char *a_pszFormat, va_list ap)
Data Structures
struct	LessNoCase
	Case-insensitive comparisons for STL containers. More...

---

Detailed Description

MBCS or ASCII single-byte oriented string. This class implements an API similar to the ICU UnicodeString and the same as WideString.

Definition at line 165 of file StringWrapper.h.

---

Constructor & Destructor Documentation

NarrowString::NarrowString

(

)

[inline]

Definition at line 174 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::NarrowString

(

const char *

text

)

[inline]

Definition at line 181 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::NarrowString	(	const char *	text,
		int32_t	len
	)			[inline]

Definition at line 189 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::NarrowString

(

const NarrowString &

text

)

[inline]

Definition at line 197 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT_, and STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::NarrowString	(	const NarrowString &	text,
		int32_t	start
	)			[inline]

Definition at line 206 of file StringWrapper.h.

References length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT_, and STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::NarrowString	(	const NarrowString &	text,
		int32_t	start,
		int32_t	len
	)			[inline]

Definition at line 216 of file StringWrapper.h.

References length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT_, and STRINGWRAPPER_OPENBUF_FALSE.

NarrowString::~NarrowString

(

)

[inline]

Definition at line 226 of file StringWrapper.h.

---

Member Function Documentation

bool NarrowString::isEmpty

(

)

const [inline]

Definition at line 234 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int32_t NarrowString::length

(

)

const [inline]

Definition at line 239 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

Referenced by append(), caseCompare(), compare(), ConvertASCIItoUTF16(), ConvertCPtoUTF16(), ConvertNativeToUTF16(), ConvertUTF8toUTF16(), findAndReplace(), insert(), lastIndexOf(), NarrowString(), replace(), and setTo().

NarrowString& NarrowString::operator=

(

const NarrowString &

text

)

[inline]

Definition at line 248 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::operator=

(

const char *

text

)

[inline]

Definition at line 255 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::operator=

(

char

ch

)

[inline]

Definition at line 261 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::setTo

(

const NarrowString &

text

)

[inline]

Definition at line 267 of file StringWrapper.h.

References getBuffer(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::setTo	(	const NarrowString &	text,
		int32_t	start
	)			[inline]

Definition at line 274 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::setTo	(	const NarrowString &	text,
		int32_t	start,
		int32_t	len
	)			[inline]

Definition at line 282 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::setTo

(

const char *

text

)

[inline]

Definition at line 291 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::setTo	(	const char *	text,
		int32_t	len
	)			[inline]

Definition at line 297 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::setTo

(

char

ch

)

[inline]

Definition at line 305 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::operator+=

(

const NarrowString &

text

)

[inline]

Definition at line 316 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::operator+=

(

const char *

text

)

[inline]

Definition at line 323 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::operator+=

(

char

ch

)

[inline]

Definition at line 329 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::append

(

const NarrowString &

text

)

[inline]

Definition at line 335 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::append	(	const NarrowString &	text,
		int32_t	start,
		int32_t	len
	)			[inline]

Definition at line 342 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::append	(	const char *	text,
		int32_t	len
	)			[inline]

Definition at line 351 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::append	(	const char *	text,
		int32_t	start,
		int32_t	len
	)			[inline]

Definition at line 362 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::append

(

char

ch

)

[inline]

Definition at line 370 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

bool NarrowString::operator==

(

const NarrowString &

text

)

const [inline]

Definition at line 380 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

bool NarrowString::operator!=

(

const NarrowString &

text

)

const [inline]

Definition at line 386 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

bool NarrowString::operator>

(

const NarrowString &

text

)

const [inline]

Definition at line 392 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

bool NarrowString::operator>=

(

const NarrowString &

text

)

const [inline]

Definition at line 398 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

bool NarrowString::operator<

(

const NarrowString &

text

)

const [inline]

Definition at line 404 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

bool NarrowString::operator<=

(

const NarrowString &

text

)

const [inline]

Definition at line 410 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int8_t NarrowString::compare

(

const NarrowString &

text

)

const [inline]

Definition at line 416 of file StringWrapper.h.

References getBuffer(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int8_t NarrowString::compare	(	const NarrowString &	text,
		int32_t	len
	)			const [inline]

Definition at line 422 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int8_t NarrowString::compare

(

const char *

text

)

const [inline]

Definition at line 429 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int8_t NarrowString::compare	(	const char *	text,
		int32_t	len
	)			const [inline]

Definition at line 434 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int8_t NarrowString::compare	(	int32_t	start,
		int32_t	len,
		const char *	srcChars,
		int32_t	srcStart,
		int32_t	srcLength
	)			const [inline]

Definition at line 440 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int8_t NarrowString::caseCompare

(

const NarrowString &

text

)

const [inline]

Definition at line 452 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

Referenced by NarrowString::LessNoCase::operator()().

int8_t NarrowString::caseCompare

(

const char *

text

)

const [inline]

Definition at line 458 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int8_t NarrowString::caseCompare	(	const NarrowString &	text,
		int32_t	len
	)			const [inline]

Definition at line 463 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int8_t NarrowString::caseCompare	(	const char *	text,
		int32_t	len
	)			const

int8_t NarrowString::caseCompare	(	const NarrowString &	text,
		int32_t	start,
		int32_t	len
	)			const [inline]

Definition at line 472 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int8_t NarrowString::caseCompare	(	const char *	text,
		int32_t	start,
		int32_t	len
	)			const [inline]

Definition at line 480 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

char NarrowString::first

(

)

const [inline]

Definition at line 491 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

char NarrowString::last

(

)

const [inline]

Definition at line 497 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

char NarrowString::operator[]

(

int32_t

offset

)

const [inline]

Definition at line 503 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

char NarrowString::getCharAt

(

int32_t

offset

)

const [inline]

Definition at line 509 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::setCharAt	(	int32_t	offset,
		char	ch
	)			[inline]

Definition at line 515 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

const char* NarrowString::getBuffer

(

)

const [inline]

Definition at line 526 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

Referenced by append(), caseCompare(), compare(), ConvertASCIItoUTF16(), ConvertCPtoUTF16(), ConvertNativeToUTF16(), ConvertUTF8toUTF16(), indexOf(), insert(), lastIndexOf(), replace(), and setTo().

char* NarrowString::getBuffer

(

int32_t

minCapacity

)

[inline]

Definition at line 532 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_TRUE.

void NarrowString::releaseBuffer

(

int32_t

newLength = -1

)

[inline]

Definition at line 539 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT_TRUE, and STRINGWRAPPER_OPENBUF_FALSE.

int32_t NarrowString::getCapacity

(

)

const [inline]

Definition at line 548 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

void NarrowString::setCapacity

(

int32_t

newSiz

)

NarrowString& NarrowString::remove

(

)

[inline]

Definition at line 559 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::remove	(	int32_t	start,
		int32_t	len = INT32_MAX
	)			[inline]

Definition at line 565 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

bool NarrowString::truncate

(

int32_t

targetLength

)

[inline]

Definition at line 571 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::insert	(	int32_t	offset,
		const NarrowString &	text
	)			[inline]

Definition at line 583 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::insert	(	int32_t	offset,
		const char *	text
	)			[inline]

Definition at line 589 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::insert	(	int32_t	offset,
		const char *	text,
		int32_t	len
	)			[inline]

Definition at line 594 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::insert	(	int32_t	offset,
		char	ch
	)			[inline]

Definition at line 601 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::toUpper

(

)

NarrowString& NarrowString::toLower

(

)

NarrowString& NarrowString::trim

(

)

int32_t NarrowString::indexOf	(	char	c,
		int32_t	start = 0
	)			const [inline]

Definition at line 620 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

int32_t NarrowString::indexOf	(	const NarrowString &	text,
		int32_t	start = 0
	)			const [inline]

Definition at line 628 of file StringWrapper.h.

References getBuffer(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int32_t NarrowString::indexOf	(	const char *	text,
		int32_t	start = 0
	)			const [inline]

Definition at line 634 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

int32_t NarrowString::lastIndexOf	(	char	c,
		int32_t	start = -1
	)			const [inline]

Definition at line 642 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int32_t NarrowString::lastIndexOf	(	const NarrowString &	text,
		int32_t	start = -1
	)			const [inline]

Definition at line 653 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

int32_t NarrowString::lastIndexOf	(	const char *	text,
		int32_t	start = -1
	)			const [inline]

Definition at line 659 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

int32_t NarrowString::lastIndexOf	(	const char *	text,
		int32_t	start,
		int32_t	len
	)			const [inline]

Definition at line 664 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::replace	(	int32_t	start,
		int32_t	len,
		char	srcChar
	)			[inline]

Definition at line 683 of file StringWrapper.h.

References STRINGWRAPPER_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::replace	(	int32_t	start,
		int32_t	len,
		const NarrowString &	text
	)			[inline]

Definition at line 689 of file StringWrapper.h.

References getBuffer(), length(), STRINGWRAPPER_ASSERT, STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

NarrowString& NarrowString::replace	(	int32_t	start,
		int32_t	len,
		const char *	srcText,
		int32_t	srcLength = -1
	)

NarrowString& NarrowString::findAndReplace	(	char	chOld,
		char	chNew
	)			[inline]

Definition at line 698 of file StringWrapper.h.

References STRINGWRAPPER_OPENBUF_ASSERT.

NarrowString& NarrowString::findAndReplace	(	const NarrowString &	oldText,
		const NarrowString &	newText
	)			[inline]

Definition at line 708 of file StringWrapper.h.

References length(), STRINGWRAPPER_OPENBUF_ASSERT, and STRINGWRAPPER_OPENBUF_ASSERT_.

void NarrowString::format	(	const char *	a_pszFormat,
			...
	)

void NarrowString::formatV	(	const char *	a_pszFormat,
		va_list	ap
	)

---

The documentation for this class was generated from the following file:

• StringWrapper.h

---