//This is from the standard <string> library for C++
//It is a list of the prototypes for string handling operators
//and functions.

// size_type is 'int' or 'long'.

//constructors
  string(char *);// convert C strings to C++ strings
  string(string);//copy a C++ string
 
//acessors
  const char* c_str () const; // returns the old C style str
  const char* data () const; // supposedly returns the old C style str
  size_type length () const;
  size_type size () const;
  size_type capacity () const;
  size_type max_size () const;
  bool empty () const;

//copying and assigning operators
  string& operator= (const string& str);
  string& operator= (const char* s);
  string& operator= (char c);
//copying and assigning functions
  string& assign (const string& str, size_type pos = 0, size_type n = npos);
  string& assign (const char* s, size_type n);
  string& assign (const char* s);
  string& assign (size_type n, char c);

//operators that append data. Note s1+s2 is all of s1 followed by all of s2.
  string& operator+= (const string& rhs);
  string& operator+= (const char* s);
  string& operator+= (char c);
//functions that append data
  string& append (const string& str, size_type pos = 0, size_type n = npos);
  string& append (const char* s, size_type n);
  string& append (const char* s);
  string& append (size_type n, char c);


//insertions
  string& insert (size_type pos1, const string& str,;
			size_type pos2 = 0, size_type n = npos);
  string& insert (size_type pos, const char* s, size_type n);
  string& insert (size_type pos, const char* s);
  string& insert (size_type pos, size_type n, char c);

  string& remove (size_type pos = 0, size_type n = npos);

  string& replace (size_type pos1, size_type n1, const string& str,;
			 size_type pos2 = 0, size_type n2 = npos);
  string& replace (size_type pos, size_type n1, const char* s,
			 size_type n2);
  string& replace (size_type pos, size_type n1, const char* s);
  string& replace (size_type pos, size_type n1, size_type n2, char c);
  string& replace (size_type pos, size_type n, char c);

  char operator[] (size_type pos) const;
  reference operator[] (size_type pos);

  reference at (size_type pos);
  const_reference at (size_type pos) const;

  void resize (size_type n, char c);
  void resize (size_type n);

  size_type copy (char* s, size_type n, size_type pos = 0);

  size_type find (const string& str, size_type pos = 0) const;
  size_type find (const char* s, size_type pos, size_type n) const;
  size_type find (const char* s, size_type pos = 0) const;
  size_type find (char c, size_type pos = 0) const;

  size_type rfind (const string& str, size_type pos = npos) const;
  size_type rfind (const char* s, size_type pos, size_type n) const;
  size_type rfind (const char* s, size_type pos = npos) const;
  size_type rfind (char c, size_type pos = npos) const;

  size_type find_first_of (const string& str, size_type pos = 0) const;
  size_type find_first_of (const char* s, size_type pos, size_type n) const;
  size_type find_first_of (const char* s, size_type pos = 0) const;
  size_type find_first_of (char c, size_type pos = 0) const;

  size_type find_last_of (const string& str, size_type pos = npos) const;
  size_type find_last_of (const char* s, size_type pos, size_type n) const;
  size_type find_last_of (const char* s, size_type pos = npos) const;
  size_type find_last_of (char c, size_type pos = npos) const;

  size_type find_first_not_of (const string& str, size_type pos = 0) const;
  size_type find_first_not_of (const char* s, size_type pos, size_type n) const;
  size_type find_first_not_of (const char* s, size_type pos = 0) const;
  size_type find_first_not_of (char c, size_type pos = 0) const;

  size_type find_last_not_of (const string& str, size_type pos = npos) const;
  size_type find_last_not_of (const char* s, size_type pos, size_type n) const;
  size_type find_last_not_of (const char* s, size_type pos = npos) const;
  size_type find_last_not_of (char c, size_type pos = npos) const;

  string substr (size_type pos = 0, size_type n = npos) const;

  int compare (const string& str, size_type pos = 0, size_type n = npos) const;
  int compare (const char* s, size_type pos, size_type n) const;
  int compare (const char* s, size_type pos = 0) const;

   operator+ (const string & lhs, const string & rhs);
   operator+ (const char* lhs, const string & rhs);
   operator+ (char lhs, const string & rhs);
   operator+ (const string & lhs, const char* rhs);
   operator+ (const string & lhs, char rhs);

   operator== (const string & lhs, const string & rhs);
   operator== (const char* lhs, const string & rhs);
   operator== (const string & lhs, const char* rhs);

   operator!= (const char* lhs, const string & rhs);
   operator!= (const string & lhs, const char* rhs);
   operator!= (const string & lhs, const string & rhs);

   operator< (const string & lhs, const string & rhs);
   operator< (const char* lhs, const string & rhs);
   operator< (const string & lhs, const char* rhs);

   operator> (const char* lhs, const string & rhs);
   operator> (const string & lhs, const char* rhs);
   operator> (const string & lhs, const string & rhs);
   
   operator<= (const char* lhs, const string & rhs);
   operator<= (const string & lhs, const char* rhs);
   operator<= (const string & lhs, const string & rhs);

   operator>= (const char* lhs, const string & rhs);
   operator>= (const string & lhs, const char* rhs);
   operator>= (const string & lhs, const string & rhs);

   operator>> (istream&, string &); //tends to treat white sace as terminator
   operator<< (ostream&, const string &);
   getline (istream&, string &, char delim = '\n');