Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members

FX::FXString Class Reference

FXString provides essential string manipulation capabilities. More...

#include <FXString.h>

List of all members.

Public Member Functions

 FXString ()
 FXString (const FXString &s)
 FXString (const FXchar *s)
 FXString (const FXchar *s, FXint n)
 FXString (FXchar c, FXint n)
 FXString (const FXchar *s1, const FXchar *s2)
void length (FXint len)
FXint length () const
const FXchar * text () const
FXbool empty () const
FXchar & operator[] (FXint i)
const FXchar & operator[] (FXint i) const
FXStringoperator= (const FXString &s)
FXStringoperator= (const FXchar *s)
FXStringfill (FXchar c, FXint n)
FXStringfill (FXchar c)
FXStringlower ()
FXStringupper ()
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
FXStringassign (FXchar c)
FXStringassign (FXchar c, FXint n)
FXStringassign (const FXchar *s, FXint n)
FXStringassign (const FXString &s)
FXStringassign (const FXchar *s)
FXStringinsert (FXint pos, FXchar c)
FXStringinsert (FXint pos, FXchar c, FXint n)
FXStringinsert (FXint pos, const FXchar *s, FXint n)
FXStringinsert (FXint pos, const FXString &s)
FXStringinsert (FXint pos, const FXchar *s)
FXStringprepend (FXchar c)
FXStringprepend (FXchar c, FXint n)
FXStringprepend (const FXchar *s, FXint n)
FXStringprepend (const FXString &s)
FXStringprepend (const FXchar *s)
FXStringappend (FXchar c)
FXStringappend (FXchar c, FXint n)
FXStringappend (const FXchar *s, FXint n)
FXStringappend (const FXString &s)
FXStringappend (const FXchar *s)
FXStringreplace (FXint pos, FXchar c)
FXStringreplace (FXint pos, FXint m, FXchar c, FXint n)
FXStringreplace (FXint pos, FXint m, const FXchar *s, FXint n)
FXStringreplace (FXint pos, FXint m, const FXString &s)
FXStringreplace (FXint pos, FXint m, const FXchar *s)
FXStringremove (FXint pos, FXint n=1)
FXint contains (FXchar ch)
FXint contains (const FXchar *sub, FXint n)
FXint contains (const FXchar *sub)
FXint contains (const FXString &sub)
FXStringsubstitute (FXchar org, FXchar sub, FXbool all=TRUE)
FXStringsubstitute (const FXchar *org, FXint olen, const FXchar *rep, FXint rlen, FXbool all=TRUE)
FXStringsubstitute (const FXchar *org, const FXchar *rep, FXbool all=TRUE)
FXStringsubstitute (const FXString &org, const FXString &rep, FXbool all=TRUE)
FXStringsimplify ()
FXStringtrim ()
FXStringtrimBegin ()
FXStringtrimEnd ()
FXStringtrunc (FXint pos)
FXStringclear ()
FXString left (FXint n) const
FXString right (FXint n) const
FXString mid (FXint pos, FXint n) 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
FXint rfind (FXchar c, FXint pos=2147483647) const
FXint find (FXchar c, FXint pos, FXint n) const
FXint rfind (FXchar c, FXint pos, FXint n) const
FXint find (const FXchar *substr, FXint n, FXint pos) const
FXint rfind (const FXchar *substr, FXint n, FXint pos) const
FXint find (const FXchar *substr, FXint pos=0) const
FXint rfind (const FXchar *substr, FXint pos=2147483647) const
FXint find (const FXString &substr, FXint pos=0) const
FXint rfind (const FXString &substr, FXint pos=2147483647) const
FXint find_first_of (const FXchar *set, FXint n, FXint pos) const
FXint find_first_of (const FXchar *set, FXint pos=0) const
FXint find_first_of (const FXString &set, FXint pos=0) const
FXint find_first_of (FXchar c, FXint pos=0) const
FXint find_last_of (const FXchar *set, FXint n, FXint pos) const
FXint find_last_of (const FXchar *set, FXint pos=2147483647) const
FXint find_last_of (const FXString &set, FXint pos=2147483647) const
FXint find_last_of (FXchar c, FXint pos=0) const
FXint find_first_not_of (const FXchar *set, FXint n, FXint pos) const
FXint find_first_not_of (const FXchar *set, FXint pos=0) const
FXint find_first_not_of (const FXString &set, FXint pos=0) const
FXint find_first_not_of (FXchar c, FXint pos=0) const
FXint find_last_not_of (const FXchar *set, FXint n, FXint pos) const
FXint find_last_not_of (const FXchar *set, FXint pos=2147483647) const
FXint find_last_not_of (const FXString &set, FXint pos=2147483647) const
FXint find_last_not_of (FXchar c, FXint pos=0) const
FXint count (FXchar c) const
FXStringformat (const char *fmt,...) FX_PRINTF(2
FXStringvformat (const char *fmt, va_list args)
FXint scan (const char *fmt,...) const FX_SCANF(2
FXint vscan (const char *fmt, va_list args) const
FXuint hash () const
FXStringoperator+= (const FXString &s)
FXStringoperator+= (const FXchar *s)
FXStringoperator+= (FXchar c)
 ~FXString ()

Static Public Attributes

const FXchar null []
const FXchar hex [17]
const FXchar HEX [17]

Friends

FXint compare (const FXchar *s1, const FXchar *s2)
FXint compare (const FXchar *s1, const FXString &s2)
FXint compare (const FXString &s1, const FXchar *s2)
FXint compare (const FXString &s1, const FXString &s2)
FXint compare (const FXchar *s1, const FXchar *s2, FXint n)
FXint compare (const FXchar *s1, const FXString &s2, FXint n)
FXint compare (const FXString &s1, const FXchar *s2, FXint n)
FXint compare (const FXString &s1, const FXString &s2, FXint n)
FXint comparecase (const FXchar *s1, const FXchar *s2)
FXint comparecase (const FXchar *s1, const FXString &s2)
FXint comparecase (const FXString &s1, const FXchar *s2)
FXint comparecase (const FXString &s1, const FXString &s2)
FXint comparecase (const FXchar *s1, const FXchar *s2, FXint n)
FXint comparecase (const FXchar *s1, const FXString &s2, FXint n)
FXint comparecase (const FXString &s1, const FXchar *s2, FXint n)
FXint comparecase (const FXString &s1, const FXString &s2, FXint n)
FXbool operator== (const FXString &s1, const FXString &s2)
FXbool operator== (const FXString &s1, const FXchar *s2)
FXbool operator== (const FXchar *s1, const FXString &s2)
FXbool operator!= (const FXString &s1, const FXString &s2)
FXbool operator!= (const FXString &s1, const FXchar *s2)
FXbool operator!= (const FXchar *s1, const FXString &s2)
FXbool operator< (const FXString &s1, const FXString &s2)
FXbool operator< (const FXString &s1, const FXchar *s2)
FXbool operator< (const FXchar *s1, const FXString &s2)
FXbool operator<= (const FXString &s1, const FXString &s2)
FXbool operator<= (const FXString &s1, const FXchar *s2)
FXbool operator<= (const FXchar *s1, const FXString &s2)
FXbool operator> (const FXString &s1, const FXString &s2)
FXbool operator> (const FXString &s1, const FXchar *s2)
FXbool operator> (const FXchar *s1, const FXString &s2)
FXbool operator>= (const FXString &s1, const FXString &s2)
FXbool operator>= (const FXString &s1, const FXchar *s2)
FXbool operator>= (const FXchar *s1, const FXString &s2)
FXString operator+ (const FXString &s1, const FXString &s2)
FXString operator+ (const FXString &s1, const FXchar *s2)
FXString operator+ (const FXchar *s1, const FXString &s2)
FXString operator+ (const FXString &s, FXchar c)
FXString operator+ (FXchar c, const FXString &s)
FXStreamoperator<< (FXStream &store, const FXString &s)
FXStreamoperator>> (FXStream &store, FXString &s)
FXString FXStringFormat (const FXchar *fmt,...) FX_PRINTF(1
FXString FXStringVFormat (const FXchar *fmt, va_list args)
FXString FXStringVal (FXint num, FXint base=10)
FXString FXStringVal (FXuint num, FXint base=10)
FXString FXStringVal (FXlong num, FXint base=10)
FXString FXStringVal (FXulong num, FXint base=10)
FXString FXStringVal (FXfloat num, FXint prec=6, FXbool exp=MAYBE)
FXString FXStringVal (FXdouble num, FXint prec=6, FXbool exp=MAYBE)
FXint FXIntVal (const FXString &s, FXint base=10)
FXuint FXUIntVal (const FXString &s, FXint base=10)
FXlong FXLongVal (const FXString &s, FXint base=10)
FXulong FXULongVal (const FXString &s, FXint base=10)
FXfloat FXFloatVal (const FXString &s)
FXdouble FXDoubleVal (const FXString &s)
FXString escape (const FXString &s)
FXString unescape (const FXString &s)
void swap (FXString &a, FXString &b)


Detailed Description

FXString provides essential string manipulation capabilities.


Constructor & Destructor Documentation

FXString  ) 
 

Create empty string.

FX::FXString::FXString const FXString s  ) 
 

Copy construct.

FX::FXString::FXString const FXchar *  s  ) 
 

Construct and init.

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

Construct and init with substring.

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

Construct and fill with constant.

FX::FXString::FXString const FXchar *  s1,
const FXchar *  s2
 

Construct string from two parts.

FX::FXString::~FXString  ) 
 

Delete.


Member Function Documentation

void FX::FXString::length FXint  len  ) 
 

Change the length of the string to len.

FXint FX::FXString::length  )  const [inline]
 

Length of text.

const FXchar* FX::FXString::text  )  const [inline]
 

Get text contents.

FXbool FX::FXString::empty  )  const [inline]
 

See if string is empty.

FXchar& FX::FXString::operator[] FXint  i  )  [inline]
 

Return a non-const reference to the ith character.

const FXchar& FX::FXString::operator[] FXint  i  )  const [inline]
 

Return a const reference to the ith character.

FXString& FX::FXString::operator= const FXString s  ) 
 

Assign another string to this.

FXString& FX::FXString::operator= const FXchar *  s  ) 
 

Assign a C-style string to this.

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

Fill with a constant.

FXString& FX::FXString::fill FXchar  c  ) 
 

Fill up to current length.

FXString& FX::FXString::lower  ) 
 

Convert to lower case.

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::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 FXString s  ) 
 

Assign string s to this string.

FXString& FX::FXString::assign const FXchar *  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 FXString s
 

Insert string at specified position.

FXString& FX::FXString::insert FXint  pos,
const FXchar *  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 string with first n characters of input string.

FXString& FX::FXString::prepend const FXString s  ) 
 

Prepend string with input string.

FXString& FX::FXString::prepend const FXchar *  s  ) 
 

Prepend string with input string.

FXString& FX::FXString::append FXchar  c  ) 
 

Append input character to this string.

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

Append input n characters c to this string.

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

Append first n characters of input string to this string.

FXString& FX::FXString::append const FXString s  ) 
 

Append input string to this string.

FXString& FX::FXString::append const FXchar *  s  ) 
 

Append input string 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 input string.

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

Replace the m characters at pos with input string.

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

Replace the m characters at pos with input string.

FXString& FX::FXString::remove FXint  pos,
FXint  n = 1
 

Remove substring.

FXint FX::FXString::contains FXchar  ch  ) 
 

Return number of occurrences of ch in string.

FXint FX::FXString::contains const FXchar *  sub,
FXint  n
 

Return number of occurrences of string sub in string.

FXint FX::FXString::contains const FXchar *  sub  ) 
 

Return number of occurrences of string sub in string.

FXint FX::FXString::contains const FXString sub  ) 
 

Return number of occurrences of string sub in string.

FXString& FX::FXString::substitute FXchar  org,
FXchar  sub,
FXbool  all = TRUE
 

Substitute one character by another.

FXString& FX::FXString::substitute const FXchar *  org,
FXint  olen,
const FXchar *  rep,
FXint  rlen,
FXbool  all = TRUE
 

Substitute one string by another.

FXString& FX::FXString::substitute const FXchar *  org,
const FXchar *  rep,
FXbool  all = TRUE
 

Substitute one string by another.

FXString& FX::FXString::substitute const FXString org,
const FXString rep,
FXbool  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
const
 

Get some part in the middle.

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
 

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

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

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

FXint FX::FXString::find FXchar  c,
FXint  pos,
FXint  n
const
 

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

FXint FX::FXString::rfind FXchar  c,
FXint  pos,
FXint  n
const
 

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

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

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

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

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

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

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

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

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

FXint FX::FXString::find const FXString substr,
FXint  pos = 0
const
 

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

FXint FX::FXString::rfind const FXString substr,
FXint  pos = 2147483647
const
 

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

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

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
 

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
 

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
 

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

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

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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

FXint FX::FXString::count FXchar  c  )  const
 

Find number of occurrences of character in string.

FXString& FX::FXString::format const char *  fmt,
  ...
 

Format a string a-la printf.

FXint FX::FXString::scan const char *  fmt,
  ...
const
 

Scan a string a-la scanf.

FXuint FX::FXString::hash  )  const
 

Get hash value.

FXString& FX::FXString::operator+= const FXString s  ) 
 

Append operators.


Friends And Related Function Documentation

FXint compare const FXchar *  s1,
const FXchar *  s2
[friend]
 

Compare.

FXint compare const FXchar *  s1,
const FXchar *  s2,
FXint  n
[friend]
 

Compare up to n.

FXint comparecase const FXchar *  s1,
const FXchar *  s2
[friend]
 

Compare case insensitive.

FXint comparecase const FXchar *  s1,
const FXchar *  s2,
FXint  n
[friend]
 

Compare case insensitive up to n.

FXbool operator== const FXString s1,
const FXString s2
[friend]
 

Comparison operators.

FXString operator+ const FXString s1,
const FXString s2
[friend]
 

Concatenate two strings.

FXString operator+ const FXString s,
FXchar  c
[friend]
 

Concatenate with 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.

FXString FXStringFormat const FXchar *  fmt,
  ...
[friend]
 

Format a string a-la printf.

FXString FXStringVal FXint  num,
FXint  base = 10
[friend]
 

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

FXString FXStringVal FXlong  num,
FXint  base = 10
[friend]
 

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

FXString FXStringVal FXfloat  num,
FXint  prec = 6,
FXbool  exp = MAYBE
[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).

FXint FXIntVal const FXString s,
FXint  base = 10
[friend]
 

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

FXlong FXLongVal const FXString s,
FXint  base = 10
[friend]
 

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

FXfloat FXFloatVal const FXString s  )  [friend]
 

Convert string into real number.

FXString escape const FXString s  )  [friend]
 

Escape special characters in a string.

FXString unescape const FXString s  )  [friend]
 

Unescape special characters in a string.

void swap FXString a,
FXString b
[friend]
 

Swap two strings.

Copyright © 1997-2005 Jeroen van der Zijp