FX::FXString Class Reference

#include <FXString.h>

List of all members.

---

Detailed Description

Provides essential string manipulation capabilities.

This is as FOX but with failure to allocate memory causing the usual TnFOX memory full exception plus many methods have been marked throw() to enable better optimisation. Furthermore some Qt-compatible APIs have been added and extra storage used to speed up operations such as inserts.

Public Member Functions
	FXString () throw ()
	FXString (const FXString &s)
	FXString (const FXchar *s)
	FXString (const FXwchar *s)
	FXString (const FXnchar *s)
	FXString (const FXchar *s, FXint n)
	FXString (const FXwchar *s, FXint n)
	FXString (const FXnchar *s, FXint n)
	FXString (FXchar c, FXint n)
FXint	length () const throw ()
void	length (FXint len)
FXint	count () const throw ()
FXint	count (FXint pos, FXint len) const throw ()
FXint	offset (FXint indx) const throw ()
FXint	index (FXint offs) const throw ()
FXint	validate (FXint p) const throw ()
FXint	extent (FXint p) const throw ()
FXint	inc (FXint p) const throw ()
FXint	dec (FXint p) const throw ()
const FXchar *	text () const throw ()
bool	empty () const throw ()
bool	operator! () const throw ()
FXchar &	operator[] (FXint i) throw ()
const FXchar &	operator[] (FXint i) const throw ()
FXchar &	at (FXint i)
const FXchar &	at (FXint i) const
FXwchar	wc (FXint i) const throw ()
FXString &	operator= (const FXchar *s)
FXString &	operator= (const FXwchar *s)
FXString &	operator= (const FXnchar *s)
FXString &	operator= (const FXString &s)
FXString &	fill (FXchar c, FXint n)
FXString &	fill (FXchar c) throw ()
FXString &	lower ()
FXString &	upper ()
FXString	section (FXchar delim, FXint start, FXint num=1) const
FXString	section (const FXchar *delim, FXint n, FXint start, FXint num) const
FXString	section (const FXchar *delim, FXint start, FXint num=1) const
FXString	section (const FXString &delim, FXint start, FXint num=1) const
FXString &	adopt (FXString &s) throw ()
FXString &	assign (FXchar c)
FXString &	assign (FXchar c, FXint n)
FXString &	assign (const FXchar *s, FXint n)
FXString &	assign (const FXwchar *s, FXint n)
FXString &	assign (const FXnchar *s, FXint n)
FXString &	assign (const FXchar *s)
FXString &	assign (const FXwchar *s)
FXString &	assign (const FXnchar *s)
FXString &	assign (const FXString &s)
FXString &	insert (FXint pos, FXchar c)
FXString &	insert (FXint pos, FXchar c, FXint n)
FXString &	insert (FXint pos, const FXchar *s, FXint n)
FXString &	insert (FXint pos, const FXwchar *s, FXint n)
FXString &	insert (FXint pos, const FXnchar *s, FXint n)
FXString &	insert (FXint pos, const FXchar *s)
FXString &	insert (FXint pos, const FXwchar *s)
FXString &	insert (FXint pos, const FXnchar *s)
FXString &	insert (FXint pos, const FXString &s)
FXString &	prepend (FXchar c)
FXString &	prepend (FXchar c, FXint n)
FXString &	prepend (const FXchar *s, FXint n)
FXString &	prepend (const FXwchar *s, FXint n)
FXString &	prepend (const FXnchar *s, FXint n)
FXString &	prepend (const FXchar *s)
FXString &	prepend (const FXwchar *s)
FXString &	prepend (const FXnchar *s)
FXString &	prepend (const FXString &s)
FXString &	append (FXchar c)
FXString &	append (FXchar c, FXint n)
FXString &	append (const FXchar *s, FXint n)
FXString &	append (const FXwchar *s, FXint n)
FXString &	append (const FXnchar *s, FXint n)
FXString &	append (const FXchar *s)
FXString &	append (const FXwchar *s)
FXString &	append (const FXnchar *s)
FXString &	append (const FXString &s)
FXString &	replace (FXint pos, FXchar c)
FXString &	replace (FXint pos, FXint m, FXchar c, FXint n)
FXString &	replace (FXint pos, FXint m, const FXchar *s, FXint n)
FXString &	replace (FXint pos, FXint m, const FXwchar *s, FXint n)
FXString &	replace (FXint pos, FXint m, const FXnchar *s, FXint n)
FXString &	replace (FXint pos, FXint m, const FXchar *s)
FXString &	replace (FXint pos, FXint m, const FXwchar *s)
FXString &	replace (FXint pos, FXint m, const FXnchar *s)
FXString &	replace (FXint pos, FXint m, const FXString &s)
FXString &	move (FXint dst, FXint src, FXint n)
FXString &	erase (FXint pos)
FXString &	erase (FXint pos, FXint n)
FXint	contains (FXchar ch) const throw ()
FXint	contains (const FXchar *sub, FXint n) const throw ()
FXint	contains (const FXchar *sub) const throw ()
FXint	contains (const FXString &sub) const throw ()
FXString &	substitute (FXchar org, FXchar sub, bool all=true) throw ()
FXString &	substitute (const FXchar *org, FXint olen, const FXchar *rep, FXint rlen, bool all=true)
FXString &	substitute (const FXchar *org, const FXchar *rep, bool all=true)
FXString &	substitute (const FXString &org, const FXString &rep, bool all=true)
FXString &	simplify ()
FXString &	trim ()
FXString &	trimBegin ()
FXString &	trimEnd ()
FXString &	trunc (FXint pos)
FXString &	clear ()
FXString	left (FXint n) const
FXString	right (FXint n) const
FXString	mid (FXint pos, FXint n=1073741824) const
FXString	before (FXchar ch, FXint n=1) const
FXString	rbefore (FXchar ch, FXint n=1) const
FXString	after (FXchar ch, FXint n=1) const
FXString	rafter (FXchar ch, FXint n=1) const
FXint	find (FXchar c, FXint pos=0) const throw ()
FXint	rfind (FXchar c, FXint pos=2147483647) const throw ()
FXint	find (FXchar c, FXint pos, FXint n) const throw ()
FXint	rfind (FXchar c, FXint pos, FXint n) const throw ()
FXint	find (const FXchar *substr, FXint n, FXint pos) const throw ()
FXint	rfind (const FXchar *substr, FXint n, FXint pos) const throw ()
FXint	find (const FXchar *substr, FXint pos=0) const throw ()
FXint	rfind (const FXchar *substr, FXint pos=2147483647) const throw ()
FXint	find (const FXString &substr, FXint pos=0) const throw ()
FXint	rfind (const FXString &substr, FXint pos=2147483647) const throw ()
FXint	find_first_of (const FXchar *set, FXint n, FXint pos) const throw ()
FXint	find_first_of (const FXchar *set, FXint pos=0) const throw ()
FXint	find_first_of (const FXString &set, FXint pos=0) const throw ()
FXint	find_first_of (FXchar c, FXint pos=0) const throw ()
FXint	find_last_of (const FXchar *set, FXint n, FXint pos) const throw ()
FXint	find_last_of (const FXchar *set, FXint pos=2147483647) const throw ()
FXint	find_last_of (const FXString &set, FXint pos=2147483647) const throw ()
FXint	find_last_of (FXchar c, FXint pos=0) const throw ()
FXint	find_first_not_of (const FXchar *set, FXint n, FXint pos) const throw ()
FXint	find_first_not_of (const FXchar *set, FXint pos=0) const throw ()
FXint	find_first_not_of (const FXString &set, FXint pos=0) const throw ()
FXint	find_first_not_of (FXchar c, FXint pos=0) const throw ()
FXint	find_last_not_of (const FXchar *set, FXint n, FXint pos) const throw ()
FXint	find_last_not_of (const FXchar *set, FXint pos=2147483647) const throw ()
FXint	find_last_not_of (const FXString &set, FXint pos=2147483647) const throw ()
FXint	find_last_not_of (FXchar c, FXint pos=0) const throw ()
FXString &	format (const FXchar *fmt,...) FX_PRINTF(2
FXString &FXString &	vformat (const FXchar *fmt, va_list args)
FXint	scan (const FXchar *fmt,...) const FX_SCANF(2
FXint FXint	vscan (const FXchar *fmt, va_list args) const
FXuint	hash () const throw ()
void	truncate (FXint len)
FXString &	arg (const FXString &str, FXint fieldwidth=0)
FXString &	arg (const char *str, FXint fieldwidth=0)
FXString &	arg (const FXwchar *str, FXint fieldwidth=0)
FXString &	arg (const FXnchar *str, FXint fieldwidth=0)
FXString &	arg (char c, FXint fieldwidth=0)
FXString &	arg (FXlong num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (FXulong num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (FXint num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (FXuint num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (FXshort num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (FXushort num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (long num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (unsigned long num, FXint fieldwidth=0, FXint base=10)
FXString &	arg (double num, FXint fieldwidth=0, FXchar fmt='g', int prec=-1)
FXString &	arg (void *ptr, FXint fieldwidth=-FXint(sizeof(FXuval)*2))
FXlong	toLong (bool *ok=0, FXint base=10) const throw ()
FXulong	toULong (bool *ok=0, FXint base=10) const throw ()
FXint	toInt (bool *ok=0, FXint base=10) const throw ()
FXuint	toUInt (bool *ok=0, FXint base=10) const throw ()
double	toDouble (bool *ok=0) const throw ()
FXString &	operator+= (const FXString &s)
FXString &	operator+= (const FXchar *s)
FXString &	operator+= (const FXwchar *s)
FXString &	operator+= (const FXnchar *s)
FXString &	operator+= (FXchar c)
	~FXString ()
Static Public Member Functions
static FXString	number (FXlong num, FXint base=10)
static FXString	number (FXulong num, FXint base=10)
static FXString	number (FXint num, FXint base=10)
static FXString	number (FXuint num, FXint base=10)
static FXString	number (FXshort num, FXint base=10)
static FXString	number (FXushort num, FXint base=10)
static FXString	number (double num, FXchar fmt='g', int prec=-1)
static FXString	number (void *ptr)
static const FXString &	nullStr () throw ()
Static Public Attributes
static const FXchar	null []
static const FXchar	hex [17]
static const FXchar	HEX [17]
static const signed char	utfBytes [256]
Friends
FXAPI FXint	compare (const FXchar *s1, const FXchar *s2) throw ()
FXAPI FXint	compare (const FXchar *s1, const FXString &s2) throw ()
FXAPI FXint	compare (const FXString &s1, const FXchar *s2) throw ()
FXAPI FXint	compare (const FXString &s1, const FXString &s2) throw ()
FXAPI FXint	compare (const FXchar *s1, const FXchar *s2, FXint n) throw ()
FXAPI FXint	compare (const FXchar *s1, const FXString &s2, FXint n) throw ()
FXAPI FXint	compare (const FXString &s1, const FXchar *s2, FXint n) throw ()
FXAPI FXint	compare (const FXString &s1, const FXString &s2, FXint n) throw ()
FXAPI FXint	comparecase (const FXchar *s1, const FXchar *s2) throw ()
FXAPI FXint	comparecase (const FXchar *s1, const FXString &s2) throw ()
FXAPI FXint	comparecase (const FXString &s1, const FXchar *s2) throw ()
FXAPI FXint	comparecase (const FXString &s1, const FXString &s2) throw ()
FXAPI FXint	comparecase (const FXchar *s1, const FXchar *s2, FXint n) throw ()
FXAPI FXint	comparecase (const FXchar *s1, const FXString &s2, FXint n) throw ()
FXAPI FXint	comparecase (const FXString &s1, const FXchar *s2, FXint n) throw ()
FXAPI FXint	comparecase (const FXString &s1, const FXString &s2, FXint n) throw ()
FXAPI FXint	compareversion (const FXchar *s1, const FXchar *s2) throw ()
FXAPI FXint	compareversion (const FXchar *s1, const FXString &s2) throw ()
FXAPI FXint	compareversion (const FXString &s1, const FXchar *s2) throw ()
FXAPI FXint	compareversion (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator== (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator== (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator== (const FXchar *s1, const FXString &s2) throw ()
FXAPI bool	operator!= (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator!= (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator!= (const FXchar *s1, const FXString &s2) throw ()
FXAPI bool	operator< (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator< (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator< (const FXchar *s1, const FXString &s2) throw ()
FXAPI bool	operator<= (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator<= (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator<= (const FXchar *s1, const FXString &s2) throw ()
FXAPI bool	operator> (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator> (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator> (const FXchar *s1, const FXString &s2) throw ()
FXAPI bool	operator>= (const FXString &s1, const FXString &s2) throw ()
FXAPI bool	operator>= (const FXString &s1, const FXchar *s2) throw ()
FXAPI bool	operator>= (const FXchar *s1, const FXString &s2) throw ()
FXAPI FXString	operator+ (const FXString &s1, const FXString &s2)
FXAPI FXString	operator+ (const FXString &s1, const FXchar *s2)
FXAPI FXString	operator+ (const FXString &s1, const FXwchar *s2)
FXAPI FXString	operator+ (const FXString &s1, const FXnchar *s2)
FXAPI FXString	operator+ (const FXchar *s1, const FXString &s2)
FXAPI FXString	operator+ (const FXwchar *s1, const FXString &s2)
FXAPI FXString	operator+ (const FXnchar *s1, const FXString &s2)
FXAPI FXString	operator+ (const FXString &s, FXchar c)
FXAPI FXString	operator+ (FXchar c, const FXString &s)
FXStream &	operator<< (FXStream &store, const FXString &s)
FXStream &	operator>> (FXStream &store, FXString &s)
FXAPI FXString	FXStringFormat (const FXchar *fmt,...) FX_PRINTF(1
FXAPI FXString friend FXAPI FXString	FXStringVFormat (const FXchar *fmt, va_list args)
FXAPI FXString	FXStringVal (FXint num, FXint base)
FXAPI FXString	FXStringVal (FXuint num, FXint base)
FXAPI FXString	FXStringVal (FXlong num, FXint base)
FXAPI FXString	FXStringVal (FXulong num, FXint base)
FXAPI FXString	FXStringVal (FXfloat num, FXint prec, FXint exp)
FXAPI FXString	FXStringVal (FXdouble num, FXint prec, FXint exp)
FXAPI FXint	FXIntVal (const FXString &s, FXint base)
FXAPI FXuint	FXUIntVal (const FXString &s, FXint base)
FXAPI FXlong	FXLongVal (const FXString &s, FXint base)
FXAPI FXulong	FXULongVal (const FXString &s, FXint base)
FXAPI FXfloat	FXFloatVal (const FXString &s)
FXAPI FXdouble	FXDoubleVal (const FXString &s)
FXAPI FXString	fromAscii (const FXString &s)
FXAPI FXString	toAscii (const FXString &s)
FXAPI FXString	escape (const FXString &s)
FXAPI FXString	unescape (const FXString &s)
FXAPI FXString	normalize (const FXString &s)
FXAPI FXString	decompose (const FXString &s, FXuint kind)
FXAPI FXString	compose (const FXString &s, FXuint kind)
void	swap (FXString &a, FXString &b)
FXAPI FXString &	unixToDos (FXString &str)
FXAPI FXString &	dosToUnix (FXString &str)

---

Constructor & Destructor Documentation

FX::FXString::FXString

(

)

throw ()

Create empty string.

FX::FXString::FXString

(

const FXString &

s

)

Copy construct.

FX::FXString::FXString

(

const FXchar *

s

)

Construct and init from string.

FX::FXString::FXString

(

const FXwchar *

s

)

Construct and init from wide character string.

FX::FXString::FXString

(

const FXnchar *

s

)

Construct and init from narrow character string.

FX::FXString::FXString	(	const FXchar *	s,
		FXint	n
	)

Construct and init with substring.

FX::FXString::FXString	(	const FXwchar *	s,
		FXint	n
	)

Construct and init with wide character substring.

FX::FXString::FXString	(	const FXnchar *	s,
		FXint	n
	)

Construct and init with narrow character substring.

FX::FXString::FXString	(	FXchar	c,
		FXint	n
	)

Construct and fill with constant.

FX::FXString::~FXString

(

)

Delete.

---

Member Function Documentation

FXint FX::FXString::length

(

)

const throw () [inline]

Length of text in bytes.

void FX::FXString::length

(

FXint

len

)

Change the length of the string to len.

FXint FX::FXString::count

(

)

const throw ()

Count number of utf8 characters.

FXint FX::FXString::count	(	FXint	pos,
		FXint	len
	)			const throw ()

Count number of utf8 characters in subrange.

FXint FX::FXString::offset

(

FXint

indx

)

const throw ()

Return byte offset of utf8 character at index.

FXint FX::FXString::index

(

FXint

offs

)

const throw ()

Return index of utf8 character at byte offset.

FXint FX::FXString::validate

(

FXint

p

)

const throw ()

Validate position to point to begin of utf8 character.

FXint FX::FXString::extent

(

FXint

p

)

const throw () [inline]

Return extent of utf8 character at position.

FXint FX::FXString::inc

(

FXint

p

)

const throw ()

Return start of next utf8 character.

FXint FX::FXString::dec

(

FXint

p

)

const throw ()

Return start of previous utf8 character.

const FXchar* FX::FXString::text

(

)

const throw () [inline]

Get text contents.

bool FX::FXString::empty

(

)

const throw () [inline]

See if string is empty.

Referenced by FX::Generic::typeInfoBase::operator!().

bool FX::FXString::operator!

(

)

const throw () [inline]

See if string is empty.

FXchar& FX::FXString::operator[]

(

FXint

i

)

throw () [inline]

Return a non-const reference to the ith character.

const FXchar& FX::FXString::operator[]

(

FXint

i

)

const throw () [inline]

Return a const reference to the ith character.

FXchar& FX::FXString::at

(

FXint

i

)

[inline]

Return a non-const reference to the ith character.

const FXchar& FX::FXString::at

(

FXint

i

)

const [inline]

Return a const reference to the ith character.

FXwchar FX::FXString::wc

(

FXint

i

)

const throw ()

Return wide character starting at offset i.

FXString& FX::FXString::operator=

(

const FXchar *

s

)

Assign a string to this.

FXString& FX::FXString::operator=

(

const FXwchar *

s

)

Assign a wide character string to this.

FXString& FX::FXString::operator=

(

const FXnchar *

s

)

Assign a narrow character string to this.

FXString& FX::FXString::operator=

(

const FXString &

s

)

Assign another string to this.

FXString& FX::FXString::fill	(	FXchar	c,
		FXint	n
	)

Fill with a constant.

FXString& FX::FXString::fill

(

FXchar

c

)

throw ()

Fill up to current length.

FXString& FX::FXString::lower

(

)

Convert to lower case.

Referenced by FX::QDict< type >::find(), FX::QDict< type >::insert(), FX::QDict< type >::remove(), FX::QDict< type >::replace(), and FX::QDict< type >::take().

FXString& FX::FXString::upper

(

)

Convert to upper case.

FXString FX::FXString::section	(	FXchar	delim,
		FXint	start,
		FXint	num = 1
	)			const

Return num partition(s) beginning at start from a string separated by delimiters delim.

FXString FX::FXString::section	(	const FXchar *	delim,
		FXint	n,
		FXint	start,
		FXint	num
	)			const

Return num partition(s) beginning at start from a string separated by set of delimiters from delim of size n.

FXString FX::FXString::section	(	const FXchar *	delim,
		FXint	start,
		FXint	num = 1
	)			const

Return num partition(s) beginning at start from a string separated by set of delimiters from delim.

FXString FX::FXString::section	(	const FXString &	delim,
		FXint	start,
		FXint	num = 1
	)			const

Return num partition(s) beginning at start from a string separated by set of delimiters from delim.

FXString& FX::FXString::adopt

(

FXString &

s

)

throw ()

Adopt string s, leaving s empty.

FXString& FX::FXString::assign

(

FXchar

c

)

Assign character c to this string.

FXString& FX::FXString::assign	(	FXchar	c,
		FXint	n
	)

Assign n characters c to this string.

FXString& FX::FXString::assign	(	const FXchar *	s,
		FXint	n
	)

Assign first n characters of string s to this string.

FXString& FX::FXString::assign	(	const FXwchar *	s,
		FXint	n
	)

Assign first n characters of wide character string s to this string.

FXString& FX::FXString::assign	(	const FXnchar *	s,
		FXint	n
	)

Assign first n characters of narrow character string s to this string.

FXString& FX::FXString::assign

(

const FXchar *

s

)

Assign string s to this string.

FXString& FX::FXString::assign

(

const FXwchar *

s

)

Assign wide character string s to this string.

FXString& FX::FXString::assign

(

const FXnchar *

s

)

Assign narrow character string s to this string.

FXString& FX::FXString::assign

(

const FXString &

s

)

Assign string s to this string.

FXString& FX::FXString::insert	(	FXint	pos,
		FXchar	c
	)

Insert character at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		FXchar	c,
		FXint	n
	)

Insert n characters c at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXchar *	s,
		FXint	n
	)

Insert first n characters of string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXwchar *	s,
		FXint	n
	)

Insert first n characters of wide character string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXnchar *	s,
		FXint	n
	)

Insert first n characters of narrow character string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXchar *	s
	)

Insert string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXwchar *	s
	)

Insert wide character string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXnchar *	s
	)

Insert narrow character string at specified position.

FXString& FX::FXString::insert	(	FXint	pos,
		const FXString &	s
	)

Insert string at specified position.

FXString& FX::FXString::prepend

(

FXchar

c

)

Prepend string with input character.

FXString& FX::FXString::prepend	(	FXchar	c,
		FXint	n
	)

Prepend string with n characters c.

FXString& FX::FXString::prepend	(	const FXchar *	s,
		FXint	n
	)

Prepend first n characters of string s.

FXString& FX::FXString::prepend	(	const FXwchar *	s,
		FXint	n
	)

Prepend first n characters of wide character string s.

FXString& FX::FXString::prepend	(	const FXnchar *	s,
		FXint	n
	)

Prepend first n characters of narrow character string s.

FXString& FX::FXString::prepend

(

const FXchar *

s

)

Prepend string with string s.

FXString& FX::FXString::prepend

(

const FXwchar *

s

)

Prepend string with wide character string.

FXString& FX::FXString::prepend

(

const FXnchar *

s

)

Prepend string with narrow character string.

FXString& FX::FXString::prepend

(

const FXString &

s

)

Prepend string with string s.

FXString& FX::FXString::append

(

FXchar

c

)

Append character c to this string.

FXString& FX::FXString::append	(	FXchar	c,
		FXint	n
	)

Append n characters c to this string.

FXString& FX::FXString::append	(	const FXchar *	s,
		FXint	n
	)

Append first n characters of string s to this string.

FXString& FX::FXString::append	(	const FXwchar *	s,
		FXint	n
	)

Append first n characters of wide character string s to this string.

FXString& FX::FXString::append	(	const FXnchar *	s,
		FXint	n
	)

Append first n characters of narrow character string s to this string.

FXString& FX::FXString::append

(

const FXchar *

s

)

Append string s to this string.

FXString& FX::FXString::append

(

const FXwchar *

s

)

Append wide character string s to this string.

FXString& FX::FXString::append

(

const FXnchar *

s

)

Append narrow character string s to this string.

FXString& FX::FXString::append

(

const FXString &

s

)

Append string s to this string.

FXString& FX::FXString::replace	(	FXint	pos,
		FXchar	c
	)

Replace a single character.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		FXchar	c,
		FXint	n
	)

Replace the m characters at pos with n characters c.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXchar *	s,
		FXint	n
	)

Replaces the m characters at pos with first n characters of string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXwchar *	s,
		FXint	n
	)

Replaces the m characters at pos with first n characters of wide character string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXnchar *	s,
		FXint	n
	)

Replaces the m characters at pos with first n characters of narrow character string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXchar *	s
	)

Replace the m characters at pos with string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXwchar *	s
	)

Replace the m characters at pos with wide character string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXnchar *	s
	)

Replace the m characters at pos with narrow character string s.

FXString& FX::FXString::replace	(	FXint	pos,
		FXint	m,
		const FXString &	s
	)

Replace the m characters at pos with string s.

FXString& FX::FXString::move	(	FXint	dst,
		FXint	src,
		FXint	n
	)

Move range of m characters from src position to dst position.

FXString& FX::FXString::erase

(

FXint

pos

)

Remove one character.

FXString& FX::FXString::erase	(	FXint	pos,
		FXint	n
	)

Remove substring.

FXint FX::FXString::contains

(

FXchar

ch

)

const throw ()

Return number of occurrences of ch in string.

FXint FX::FXString::contains	(	const FXchar *	sub,
		FXint	n
	)			const throw ()

Return number of occurrences of string sub in string.

FXint FX::FXString::contains

(

const FXchar *

sub

)

const throw ()

Return number of occurrences of string sub in string.

FXint FX::FXString::contains

(

const FXString &

sub

)

const throw ()

Return number of occurrences of string sub in string.

FXString& FX::FXString::substitute	(	FXchar	org,
		FXchar	sub,
		bool	all = true
	)			throw ()

Substitute one character by another.

Referenced by FX::Generic::typeInfoBase::asIdentifier().

FXString& FX::FXString::substitute	(	const FXchar *	org,
		FXint	olen,
		const FXchar *	rep,
		FXint	rlen,
		bool	all = true
	)

Substitute one string by another.

FXString& FX::FXString::substitute	(	const FXchar *	org,
		const FXchar *	rep,
		bool	all = true
	)

Substitute one string by another.

FXString& FX::FXString::substitute	(	const FXString &	org,
		const FXString &	rep,
		bool	all = true
	)

Substitute one string by another.

FXString& FX::FXString::simplify

(

)

Simplify whitespace in string.

FXString& FX::FXString::trim

(

)

Remove leading and trailing whitespace.

FXString& FX::FXString::trimBegin

(

)

Remove leading whitespace.

FXString& FX::FXString::trimEnd

(

)

Remove trailing whitespace.

FXString& FX::FXString::trunc

(

FXint

pos

)

Truncate string at pos.

FXString& FX::FXString::clear

(

)

Clear.

FXString FX::FXString::left

(

FXint

n

)

const

Get left most part.

FXString FX::FXString::right

(

FXint

n

)

const

Get right most part.

FXString FX::FXString::mid	(	FXint	pos,
		FXint	n = 1073741824
	)			const

Get some part in the middle.

Referenced by FX::Generic::typeInfoBase::asLeafIdentifier().

FXString FX::FXString::before	(	FXchar	ch,
		FXint	n = 1
	)			const

Return all characters before the n-th occurrence of ch, searching from the beginning of the string. If the character is not found, return the entire string. If n<=0, return the empty string.

FXString FX::FXString::rbefore	(	FXchar	ch,
		FXint	n = 1
	)			const

Return all characters before the n-th occurrence of ch, searching from the end of the string. If the character is not found, return the empty string. If n<=0, return the entire string.

FXString FX::FXString::after	(	FXchar	ch,
		FXint	n = 1
	)			const

Return all characters after the nth occurrence of ch, searching from the beginning of the string. If the character is not found, return the empty string. If n<=0, return the entire string.

FXString FX::FXString::rafter	(	FXchar	ch,
		FXint	n = 1
	)			const

Return all characters after the nth occurrence of ch, searching from the end of the string. If the character is not found, return the entire string. If n<=0, return the empty string.

FXint FX::FXString::find	(	FXchar	c,
		FXint	pos = 0
	)			const throw ()

Find a character, searching forward; return position or -1.

FXint FX::FXString::rfind	(	FXchar	c,
		FXint	pos = 2147483647
	)			const throw ()

Find a character, searching backward; return position or -1.

Referenced by FX::Generic::typeInfoBase::asLeafIdentifier().

FXint FX::FXString::find	(	FXchar	c,
		FXint	pos,
		FXint	n
	)			const throw ()

Find n-th occurrence of character, searching forward; return position or -1.

FXint FX::FXString::rfind	(	FXchar	c,
		FXint	pos,
		FXint	n
	)			const throw ()

Find n-th occurrence of character, searching backward; return position or -1.

FXint FX::FXString::find	(	const FXchar *	substr,
		FXint	n,
		FXint	pos
	)			const throw ()

Find a substring of length n, searching forward; return position or -1.

FXint FX::FXString::rfind	(	const FXchar *	substr,
		FXint	n,
		FXint	pos
	)			const throw ()

Find a substring of length n, searching backward; return position or -1.

FXint FX::FXString::find	(	const FXchar *	substr,
		FXint	pos = 0
	)			const throw ()

Find a substring, searching forward; return position or -1.

FXint FX::FXString::rfind	(	const FXchar *	substr,
		FXint	pos = 2147483647
	)			const throw ()

Find a substring, searching backward; return position or -1.

FXint FX::FXString::find	(	const FXString &	substr,
		FXint	pos = 0
	)			const throw ()

Find a substring, searching forward; return position or -1.

FXint FX::FXString::rfind	(	const FXString &	substr,
		FXint	pos = 2147483647
	)			const throw ()

Find a substring, searching backward; return position or -1.

FXint FX::FXString::find_first_of	(	const FXchar *	set,
		FXint	n,
		FXint	pos
	)			const throw ()

Find first character in the set of size n, starting from pos; return position or -1.

FXint FX::FXString::find_first_of	(	const FXchar *	set,
		FXint	pos = 0
	)			const throw ()

Find first character in the set, starting from pos; return position or -1.

FXint FX::FXString::find_first_of	(	const FXString &	set,
		FXint	pos = 0
	)			const throw ()

Find first character in the set, starting from pos; return position or -1.

FXint FX::FXString::find_first_of	(	FXchar	c,
		FXint	pos = 0
	)			const throw ()

Find first character, starting from pos; return position or -1.

FXint FX::FXString::find_last_of	(	const FXchar *	set,
		FXint	n,
		FXint	pos
	)			const throw ()

Find last character in the set of size n, starting from pos; return position or -1.

FXint FX::FXString::find_last_of	(	const FXchar *	set,
		FXint	pos = 2147483647
	)			const throw ()

Find last character in the set, starting from pos; return position or -1.

FXint FX::FXString::find_last_of	(	const FXString &	set,
		FXint	pos = 2147483647
	)			const throw ()

Find last character in the set, starting from pos; return position or -1.

FXint FX::FXString::find_last_of	(	FXchar	c,
		FXint	pos = 0
	)			const throw ()

Find last character, starting from pos; return position or -1.

FXint FX::FXString::find_first_not_of	(	const FXchar *	set,
		FXint	n,
		FXint	pos
	)			const throw ()

Find first character NOT in the set of size n, starting from pos; return position or -1.

FXint FX::FXString::find_first_not_of	(	const FXchar *	set,
		FXint	pos = 0
	)			const throw ()

Find first character NOT in the set, starting from pos; return position or -1.

FXint FX::FXString::find_first_not_of	(	const FXString &	set,
		FXint	pos = 0
	)			const throw ()

Find first character NOT in the set, starting from pos; return position or -1.

FXint FX::FXString::find_first_not_of	(	FXchar	c,
		FXint	pos = 0
	)			const throw ()

Find first character NOT equal to c, starting from pos; return position or -1.

FXint FX::FXString::find_last_not_of	(	const FXchar *	set,
		FXint	n,
		FXint	pos
	)			const throw ()

Find last character NOT in the set of size n, starting from pos; return position or -1.

FXint FX::FXString::find_last_not_of	(	const FXchar *	set,
		FXint	pos = 2147483647
	)			const throw ()

Find last character NOT in the set, starting from pos; return position or -1.

FXint FX::FXString::find_last_not_of	(	const FXString &	set,
		FXint	pos = 2147483647
	)			const throw ()

Find last character NOT in the set, starting from pos; return position or -1.

FXint FX::FXString::find_last_not_of	(	FXchar	c,
		FXint	pos = 0
	)			const throw ()

Find last character NOT equal to c, starting from pos; return position or -1.

FXString& FX::FXString::format	(	const FXchar *	fmt,
			...
	)

Format a string a-la printf.

FXint FX::FXString::scan	(	const FXchar *	fmt,
			...
	)			const

Scan a string a-la scanf.

FXuint FX::FXString::hash

(

)

const throw ()

Get hash value.

void FX::FXString::truncate

(

FXint

len

)

[inline]

Truncates the string to the specified length.

FXString& FX::FXString::arg	(	const FXString &	str,
		FXint	fieldwidth = 0
	)

Inserts an argument into the lowest numbered x. Specifying a negative number for fieldwidth fills with zeros instead of spaces for numbers and for text causes alignment to the left instead of right

Referenced by FX::Secure::TigerHashValue::asString().

static FXString FX::FXString::number	(	FXlong	num,
		FXint	base = 10
	)			[static]

Generates statically a textual representation of a number.

FXlong FX::FXString::toLong	(	bool *	ok = 0,
		FXint	base = 10
	)			const throw ()

Converts a string to a number.

static const FXString& FX::FXString::nullStr

(

)

throw () [static]

Returns a null string.

Referenced by FX::QDir::entryList().

FXString& FX::FXString::operator+=

(

const FXString &

s

)

Append operators.

---

Friends And Related Function Documentation

FXAPI FXint compare	(	const FXchar *	s1,
		const FXchar *	s2
	)			throw () [friend]

Compare.

FXAPI FXint compare	(	const FXchar *	s1,
		const FXchar *	s2,
		FXint	n
	)			throw () [friend]

Compare up to n.

FXAPI FXint comparecase	(	const FXchar *	s1,
		const FXchar *	s2
	)			throw () [friend]

Compare case insensitive.

FXAPI FXint comparecase	(	const FXchar *	s1,
		const FXchar *	s2,
		FXint	n
	)			throw () [friend]

Compare case insensitive up to n.

FXAPI FXint compareversion	(	const FXchar *	s1,
		const FXchar *	s2
	)			throw () [friend]

Compare with numeric interpretation.

FXAPI bool operator==	(	const FXString &	s1,
		const FXString &	s2
	)			throw () [friend]

Comparison operators.

FXAPI FXString operator+	(	const FXString &	s1,
		const FXString &	s2
	)			[friend]

Concatenate one FXString with another.

FXAPI FXString operator+	(	const FXString &	s1,
		const FXchar *	s2
	)			[friend]

Concatenate FXString and a string.

FXAPI FXString operator+	(	const FXchar *	s1,
		const FXString &	s2
	)			[friend]

Concatenate string and FXString.

FXAPI FXString operator+	(	const FXString &	s,
		FXchar	c
	)			[friend]

Concatenate string and single character.

FXStream& operator<<	(	FXStream &	store,
		const FXString &	s
	)			[friend]

Saving to a stream.

FXStream& operator>>	(	FXStream &	store,
		FXString &	s
	)			[friend]

Load from a stream.

FXAPI FXString FXStringFormat	(	const FXchar *	fmt,
			...
	)			[friend]

Format a string a-la printf.

FXAPI FXString FXStringVal	(	FXint	num,
		FXint	base
	)			[friend]

Convert integer number to a string, using the given number base, which must be between 2 and 16.

FXAPI FXString FXStringVal	(	FXlong	num,
		FXint	base
	)			[friend]

Convert long integer number to a string, using the given number base, which must be between 2 and 16.

FXAPI FXString FXStringVal	(	FXfloat	num,
		FXint	prec,
		FXint	exp
	)			[friend]

Convert real number to a string, using the given procision and exponential notation mode, which may be FALSE (never), TRUE (always), or MAYBE (when needed).

FXAPI FXint FXIntVal	(	const FXString &	s,
		FXint	base
	)			[friend]

Convert string to a integer number, assuming given number base.

FXAPI FXlong FXLongVal	(	const FXString &	s,
		FXint	base
	)			[friend]

Convert string to long integer number, assuming given number base.

FXAPI FXfloat FXFloatVal

(

const FXString &

s

)

[friend]

Convert string into real number.

FXAPI FXString fromAscii

(

const FXString &

s

)

[friend]

Return utf8 from ascii containing unicode escapes.

FXAPI FXString toAscii

(

const FXString &

s

)

[friend]

Return ascii containing unicode escapes from utf8.

FXAPI FXString escape

(

const FXString &

s

)

[friend]

Escape special characters in a string.

FXAPI FXString unescape

(

const FXString &

s

)

[friend]

Unescape special characters in a string.

FXAPI FXString normalize

(

const FXString &

s

)

[friend]

Return normalized string, i.e. reordering of diacritical marks.

FXAPI FXString decompose	(	const FXString &	s,
		FXuint	kind
	)			[friend]

Return normalized decomposition of string.

FXAPI FXString compose	(	const FXString &	s,
		FXuint	kind
	)			[friend]

Return normalized composition of string; this first performs normalized decomposition.

void swap	(	FXString &	a,
		FXString &	b
	)			[friend]

Swap two strings.

FXAPI FXString& unixToDos

(

FXString &

str

)

[friend]

Convert to and from dos.

---

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

• FXString.h