3 FILE : string.hh -- declare String
5 Rehacked by HWN 3/nov/95
7 introduced Class String_handle
18 #include "string-handle.hh"
22 Intuitive string class. provides
25 ref counting through #String_handle#
27 conversion from bool, int, double, char* , char.
29 to be moved to String_convert:
30 conversion to int, upcase, downcase
36 indexing (index_i, index_any_i, last_index_i)
39 cutting (left_str, right_str, mid_str)
45 signed comparison (<, >, ==, etc)
48 No operator[] is provided, since this would be enormously slow. If needed,
49 convert to char const* .
58 bool null_terminated();
62 /** init to empty string. This is needed because other
63 constructors are provided.*/
68 String( char const* source );
69 String( Byte const* byte_C, int length_i );
72 String( char c, int n = 1 );
74 String( int i , char const *fmt=0);
75 String ( double f , char const* fmt =0);
79 /// return a "new"-ed copy of contents
80 Byte* copy_byte_p() const; // return a "new"-ed copy of contents
82 char const* ch_C() const;
83 Byte const* byte_C() const;
87 /// deprecated; use ch_C()
88 operator char const* () const { return ch_C(); }
90 String &operator =( String const & source );
93 void operator += (char const* s) { strh_ += s; }
94 void operator += (String s);
99 char operator []( int n ) const { return strh_[n]; }
101 /// return n leftmost chars
102 String left_str( int n ) const;
104 /// return n rightmost chars
105 String right_str( int n ) const;
107 /// return uppercase of *this
108 String upper_str() const;
110 /// return lowercase of *this
111 String lower_str() const;
113 /// return the "esrever" of *this
114 String reversed_str() const;
117 /// return a piece starting at index_i (first char = index_i 0), length n
118 String mid_str(int index_i, int n ) const;
120 /// cut out a middle piece, return remainder
121 String nomid_str(int index_i, int n ) const;
123 /// signed comparison, analogous to memcmp;
124 static int compare_i(String const & s1,const String& s2);
126 /// index of rightmost c
127 int index_last_i( char c) const;
129 /// index of rightmost element of string
130 int index_last_i( char const* string ) const;
132 int index_i(char c ) const;
133 int index_i(String ) const;
134 int index_any_i(String ) const;
138 /// provide Stream output
139 void print_on(ostream& os) const;
141 /// the length of the string
142 int length_i() const;
149 /// convert to an integer
152 /// convert to a double
153 double value_f() const;
156 #include "compare.hh"
158 instantiate_compare(String const &, String::compare_i);
160 // because char const* also has an operator ==, this is for safety:
161 inline bool operator==(String s1, char const* s2){
162 return s1 == String(s2);
164 inline bool operator==(char const* s1, String s2)
166 return String(s1)==s2;
168 inline bool operator!=(String s1, char const* s2 ) {
169 return s1!=String(s2);
171 inline bool operator!=(char const* s1,String s2) {
172 return String(s2) !=s1;
177 operator + (String s1, String s2)
184 operator << ( ostream& os, String d )
191 // String quoteString(String message, String quote);