## class string

> infinite length string class.

### Public Fields

  static const string | EMPTY the empty string

### Public Methods

  | string () create empty string.
  | string (const string &s) copy constructor. usage: string x = string
  | string (const char* s) copy constructor. usage: string x = "abc"
  | string (char c) copy constructor. usage: string x = 'a'
  | string (int n) copy constructor (decimals). usage: string x = 12;
  | string (unsigned n) copy constructor (decimals). usage: string x = 12;
  | string (double d) copy constructor (doubles). usage: string x = 1.2;
  virtual | ~string () delete string.
  string& | operator= (const string &s) copy operator a la strcpy.
  string& | operator= (const char* s) copy operator a la strcpy.
  string& | operator= (char c) copy operator a la strcpy.
  string& | operator= (int n) copy operator a la strcpy. s = n in decimal notation.
  string& | operator= (unsigned n) copy operator a la strcpy. s = n in decimal notation.
  string& | operator= (double d) copy operator a la strcpy. s = d in floating point notation.
  string& | operator+= (const string &s) concat operator a la strcat.
  string& | operator+= (const char* s) concat operator a la strcat.
  string& | operator+= (int n) concat. n in decimal notation is added.
  string& | operator+= (unsigned n) concat. n in decimal notation is added.
  string& | operator+= (double d) concat. d in floating point notation is added.
  string& | operator+= (char c) concat operator a la strcat.
  friend string | operator+ (const char* s1, const string &s2) constructive concat operator.
  friend string | operator+ (const string &s1, const char* s2) constructive concat operator.
  string | operator+ (const string &s) constructive concat operator.
  string | operator+ (const char* s) constructive concat operator.
  void | add (char c) add c at end of string.
  void | insert (char c, int pos) add character at n-th position of string.
  int | contains (const string &s) const return 1 if target is in string. 0 for failure.
  int | contains (const char* s) const return 1 if target is in string. 0 for failure.
  int | contains (char c) const return 1 if target is in string. 0 for failure.
  int | startsWith (const string &s) const return 1 if string starts with target, 0 for failure.
  int | startsWith (const char* s) const return 1 if string starts with target, 0 for failure.
  int | endsWith (const string &s) const return 1 if string ends with target, 0 for failure.
  int | endsWith (const char* s) const return 1 if string ends with target, 0 for failure.
  int | setSuffix (const string &s, char delim = '.') adds suffix s. return 1 when suffix is changed, 0 when only added.
  int | getSuffix (string &s, char delim = '.') const puts suffix in s. when there is no suffix returns 0, 1 otherwise.
  char& | operator[] (int i) selection of char by index a la array.
  const char& | operator[] (int i) const selection of char by index a la array.
  void | remove () remove last character of string.
  void | remove (int pos) remove pos-th character of string.
  int | replace (char old, char nw) replace each occurence of old char by nw char .
  int | replace (const string &pat, const string &repl, int casesens=1) global substitution.
  int | replaceFirst (const string &pat, const string &repl, int casesens=1) first occurrence substitution.
  void | addPlural () add to word an english plural ending, like horse->horses, sky->skies.
  friend string | upcase (const string &s) move all chars to upper case
  friend string | downcase (const string &s) move all chars to lower case
  friend string | stripblanks (const string &s) strip all spurious blank chars.
  void | upcase () in-place version of the above.
  void | downcase ()
  void | stripblanks ()
  unsigned long | toulong () const
  long | tolong () const
  double | todouble () const
  int | toint () const
  unsigned | length () const number of characters in string.
  unsigned | lines () const the number of lines in string when printed: newlines+1.
  unsigned | width () const return nr. of chars of line with most chars in string.
  int | whichline (int i, int &pos) const return which line has i-th char. pos becomes position in line.
  int | nthInline (int line, int n) const return position of n-th char in line-th line.
  unsigned | letters () const return number of letters (a-z,A-Z) in string.
  void | setPrecision (unsigned p) set precision when string is interpreted as double.
  friend ostream& | operator<< (ostream &o, const string &s) write string to output stream.
  friend istream& | operator>> (istream &i, string &s) read string from input stream.
  friend int | operator== (const string &x, const char* s) comparison operator returns 1 if equal
  friend int | operator== (const string &x, const string &y) comparison operator returns 1 if equal.
  friend int | operator%= (const string &x, const char* s) comparison operator that ignores case
  friend int | operator%= (const string &x, const string &y) comparison operator that ignores case
  friend int | operator!= (const string &x, const char* s) comparison operator a la !equal.
  friend int | operator!= (const string &x, const string &y) comparison operator a la !equal.
  friend int | compare (const string &x, const char* s) comparison operator a la strcmp
  friend int | compare (const string &x, const string &y) comparison operator a la strcmp
  const char* | getstr () const return a const pointer to the data to do dirty stuff.

### Protected Methods

  int | doReplace (const string &pat, const string &repl, int global, int casesens=1)

## Documentation

> infinite length string class.

`static const string EMPTY`
  the empty string

`string()`
  create empty string.

`string(const string &s)`
  copy constructor. usage: string x = string

`string(const char* s)`
  copy constructor. usage: string x = "abc"

`string(char c)`
  copy constructor. usage: string x = 'a'

`string(int n)`
  copy constructor (decimals). usage: string x = 12;

`string(unsigned n)`
  copy constructor (decimals). usage: string x = 12;

`string(double d)`
  copy constructor (doubles). usage: string x = 1.2;

`virtual ~string()`
  delete string.

`string& operator=(const string &s)`
  copy operator a la strcpy.

`string& operator=(const char* s)`
  copy operator a la strcpy.

`string& operator=(char c)`
  copy operator a la strcpy.

`string& operator=(int n)`
  copy operator a la strcpy. s = n in decimal notation.

`string& operator=(unsigned n)`
  copy operator a la strcpy. s = n in decimal notation.

`string& operator=(double d)`
  copy operator a la strcpy. s = d in floating point notation.

`string& operator+=(const string &s)`
  concat operator a la strcat.

`string& operator+=(const char* s)`
  concat operator a la strcat.

`string& operator+=(int n)`
  concat. n in decimal notation is added.

`string& operator+=(unsigned n)`
  concat. n in decimal notation is added.

`string& operator+=(double d)`
  concat. d in floating point notation is added.

`string& operator+=(char c)`
  concat operator a la strcat.

`friend string operator+(const char* s1, const string &s2)`
  constructive concat operator.

`friend string operator+(const string &s1, const char* s2)`
  constructive concat operator.

`string operator+(const string &s)`
  constructive concat operator.

`string operator+(const char* s)`
  constructive concat operator.

`void add(char c)`
  add c at end of string.

`void insert(char c, int pos)`
  add character at n-th position of string.

`int contains(const string &s) const`
  return 1 if target is in string. 0 for failure.

`int contains(const char* s) const`
  return 1 if target is in string. 0 for failure.

`int contains(char c) const`
  return 1 if target is in string. 0 for failure.

`int startsWith(const string &s) const`
  return 1 if string starts with target, 0 for failure.

`int startsWith(const char* s) const`
  return 1 if string starts with target, 0 for failure.

`int endsWith(const string &s) const`
  return 1 if string ends with target, 0 for failure.

`int endsWith(const char* s) const`
  return 1 if string ends with target, 0 for failure.

`int setSuffix(const string &s, char delim = '.')`
  adds suffix s. return 1 when suffix is changed, 0 when only added.

`int getSuffix(string &s, char delim = '.') const`
  puts suffix in s. when there is no suffix returns 0, 1 otherwise.

`char& operator[](int i)`
  selection of char by index a la array.

`const char& operator[](int i) const`
  selection of char by index a la array.

`void remove()`
  remove last character of string.

`void remove(int pos)`
  remove pos-th character of string.

`int replace(char old, char nw)`
  replace each occurence of old char by nw char .

`int replace(const string &pat, const string &repl, int casesens=1)`
  global substitution.

`int replaceFirst(const string &pat, const string &repl, int casesens=1)`
  first occurrence substitution.

`void addPlural()`
  add to word an english plural ending, like horse->horses, sky->skies.

`friend string upcase(const string &s)`
  move all chars to upper case

`friend string downcase(const string &s)`
  move all chars to lower case

`friend string stripblanks(const string &s)`
  strip all spurious blank chars.

`void upcase()`
  in-place version of the above.

`void downcase()`

`void stripblanks()`

`unsigned long toulong() const`

`long tolong() const`

`double todouble() const`

`int toint() const`

`unsigned length() const`
  number of characters in string.

`unsigned lines() const`
  the number of lines in string when printed: newlines+1.

`unsigned width() const`
  return nr. of chars of line with most chars in string.

`int whichline(int i, int &pos) const`
  return which line has i-th char. pos becomes position in line.

`int nthInline(int line, int n) const`
  return position of n-th char in line-th line.

`unsigned letters() const`
  return number of letters (a-z,A-Z) in string.

`void setPrecision(unsigned p)`
  set precision when string is interpreted as double.

`friend ostream& operator<<(ostream &o, const string &s)`
  write string to output stream.

`friend istream& operator>>(istream &i, string &s)`
  read string from input stream.

`friend int operator==(const string &x, const char* s)`
  comparison operator returns 1 if equal

`friend int operator==(const string &x, const string &y)`
  comparison operator returns 1 if equal.

`friend int operator%=(const string &x, const char* s)`
  comparison operator that ignores case

`friend int operator%=(const string &x, const string &y)`
  comparison operator that ignores case

`friend int operator!=(const string &x, const char* s)`
  comparison operator a la !equal.

`friend int operator!=(const string &x, const string &y)`
  comparison operator a la !equal.

`friend int compare(const string &x, const char* s)`
  comparison operator a la strcmp

`friend int compare(const string &x, const string &y)`
  comparison operator a la strcmp

`const char* getstr() const`
  return a const pointer to the data to do dirty stuff.

`int doReplace(const string &pat, const string &repl, int global, int casesens=1)`

This class has no child classes.

alphabetic index hierarchy of classes

this page has been generated automatically by doc++

(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de