3 FILE : string.hh -- declare String
5 Rehacked by HWN 3/nov/95
7 introduced Class String_handle
14 // too darn slow with gcc3
23 #include "arithmetic-operator.hh"
24 #include "string-handle.hh"
28 Intuitive string class. provides
31 ref counting through #String_handle#
33 conversion from bool, int, double, char* , char.
35 to be moved to String_convert:
36 conversion to int, upcase, downcase
42 indexing (index_i, index_any_i, last_index_i)
45 cutting (left_string, right_string, mid_string)
51 signed comparison (<, >, ==, etc)
54 No operator[] is provided, since this would be enormously slow. If needed,
55 convert to char const* .
64 bool null_terminated ();
68 /** init to empty string. This is needed because other
69 constructors are provided.*/
73 String (char const* source);
74 String (Byte const* byte, int length_i);
76 /// return "new"-ed copy of contents
77 Byte* get_copy_byte () const;
78 char* get_copy_str0 () const;
80 char const* to_str0 () const;
81 Byte const* to_bytes () const;
85 String &operator = (String const & source);
88 void operator += (char const* s) { strh_ += s; }
89 void operator += (String s);
91 bool is_empty () const;
94 void prepend (String);
97 Return a char. UNSAFE because it may change strlen () result
99 char &operator [] (int n);
100 char operator [] (int n) const;
102 /// return n leftmost chars
103 String left_string (int n) const;
105 /// return n rightmost chars
106 String right_string (int n) const;
108 /// return uppercase of *this
109 String upper_string () const;
110 /// return lowercase of *this
111 String lower_string () const;
113 /// return the "esrever" of *this
114 String reversed_string () const;
116 /// return a piece starting at index (first char = index_i 0), length n
117 String cut_string (int index_i, int n) const;
119 /// cut out a middle piece, return remainder
120 String nomid_string (int index_i, int n) const;
122 /// signed comparison, analogous to memcmp;
123 static int compare (String const & s1,const String& s2);
125 /// index of rightmost c
126 int index_last (char c) const;
128 /// index of rightmost element of string (???)
129 int index_last (char const* string) const;
131 int index (char c) const;
133 /// index of leftmost occurance of STRING
134 int index (String) const;
137 int index_any (String) const;
142 #ifdef STREAM_SUPPORT
143 /// provide Stream output
144 void print_on (ostream& os) const;
147 /// the length of the string
150 /// convert to an integer
153 /// convert to a double
154 double to_double () const;
156 String substituted (char text, String sub) const;
160 better to clutter global namespace, than suffer *ugh, ugh, ugh*
161 implicit conversions.
163 it might be cool to have no type-checking at all in a language,
164 but once there is, having this silently circumvented is a nightmare.
166 whenever implicit conversions seem necessary (e.g. operator << ()),
167 use Scalar as the generic type iso String.
170 /// for completeness (=handy)
171 inline String to_string (String s) { return s; }
173 String to_string (char c, int n = 1);
174 String to_string (int i, char const* format = 0);
175 String to_string (double f, char const* format = 0);
176 String to_string (long b);
177 String to_string (bool b);
178 String to_string (char const* format, ... );
181 technically incorrect, but lets keep it here: this is a
182 catch all place for this stuff.
185 #include "international.hh"
188 #include "compare.hh"
189 INSTANTIATE_COMPARE (String const &, String::compare);
191 #ifdef STRING_UTILS_INLINED
193 #define INLINE inline
195 #include "string.icc"
196 /* we should be resetting INLINE. oh well. */
200 // because char const* also has an operator ==, this is for safety:
201 inline bool operator== (String s1, char const* s2)
203 return s1 == String (s2);
205 inline bool operator== (char const* s1, String s2)
207 return String (s1)==s2;
209 inline bool operator!= (String s1, char const* s2 ) {
210 return s1!=String (s2);
212 inline bool operator!= (char const* s1,String s2) {
213 return String (s2) !=s1;
216 IMPLEMENT_ARITHMETIC_OPERATOR (String, +);
217 #ifdef STREAM_SUPPORT
218 ostream &operator << (ostream& os, String d);