// This one is heavily based on the string class in The C++
// Programming Language by Bjarne Stroustrup
+// This class is supposed to be functionaly equivalent to a
+// standard conformant string. This mean among others that we
+// are useing the same requirements. Before you change anything
+// in this file consult me and/or the standard to discover the
+// right behavior.
+
#ifndef LYXSTRING_H
#define LYXSTRING_H
#include <config.h> // needed at least for compilers that do not
#endif // understand `explicit' (JMarc)
+#include "LOstream.h"
+#include "LIstream.h"
+
#if 0
#include <iterator>
#endif
-#include <cstring>
-#include "LAssert.h"
+#include <cstring> // for size_t
+
/** A string class for LyX
This is a permanent String class. It is modeled closely after the C++ STL
- string class. In comparison with STL string LString lack support for
- reverse iterators and allocators, in all other senses it is written to be
- a drop in replacement for STL string (or as a transition tool). So
- documentation for STL string should be valid for LString too.
+ string class. In comparison with STL string lyxstring lack support for
+ reverse iterators and allocators, also char_traits is not used. In most
+ other senses it is written to be a drop in replacement for STL string
+ (or as a transition tool). So documentation for STL string should be
+ valid for lyxstring too.
Notes for usage:
- When you declare an LString, it is initially empty. There is no need to
- do things like #LString a= "";#, especially not in constructors.
+ When you declare an lyxstring, it is initially empty. There is no need to
+ do things like #lyxstring a= "";#, especially not in constructors.
- If you want to use a default empty LString as a parameter, use
+ If you want to use a default empty lyxstring as a parameter, use
- #void foo(LString par = LString()); // Correct#
+ #void foo(lyxstring par = lyxstring()); // Correct#
rather than
- #void foo(LString par = ""); // WRONG!#
- #void foo(LString par = 0); // WRONG!#
+ #void foo(lyxstring par = ""); // WRONG!#
+ #void foo(lyxstring par = 0); // WRONG!#
(The last one is only wrong because some compilers can't handle it.)
Wrong: & #bar.substring(0, length());#
\end{tabular}
- It is important that you declare LStrings as const if possible, because
+ It is important that you declare lyxstring as const if possible, because
some methods are much more efficient in const versions.
If you want to check whether a string is empty, do
#if (!foo) completely wrong#
-When you want to copy an LString, just do
+When you want to copy an lyxstring, just do
- #LString a, b = "String";#
+ #lyxstring a, b = "String";#
#a = b; // That's it!#
not something like
- #LString a, b = "String";#
- #a = b.copy(); // This leaks.#
+ #lyxstring a, b = "String";#
+ #a = b.copy(); // This leaks. // and does not work either. #
The class automatically handles deep copying when required.
*/
#if 0
///
typedef reverse_iterator<iterator, value_type, reference>
-reverse_iterator;
+ reverse_iterator;
///
typedef reverse_iterator<const_iterator, const value_type,
-const_reference> const_reverse_iterator;
+ const_reference> const_reverse_iterator;
#endif
//@}
lyxstring(iterator first, iterator last);
///
- ~lyxstring() { if (--rep->ref == 0) delete rep; }
+ ~lyxstring();
//@}
//@{
/// number of characters
- size_type size() const; // { return rep->sz; }
+ size_type size() const;
/// largest possible string
size_type max_size() const { return npos -1; }
//@}
-
/**@name Assignment */
//@{
//@}
-
/**@name Insert */
//@{
size_type find_first_of(lyxstring const &, size_type i = 0) const;
///
- size_type find_first_of(value_type const * p, size_type i, size_type n) const;
+ size_type find_first_of(value_type const * p, size_type i,
+ size_type n) const;
///
size_type find_first_of(value_type const * p, size_type i = 0) const;
size_type find_last_of(lyxstring const &, size_type i = npos) const;
///
- size_type find_last_of(value_type const * p, size_type i, size_type n) const;
+ size_type find_last_of(value_type const * p, size_type i,
+ size_type n) const;
///
size_type find_last_of(value_type const * p, size_type i = npos) const;
size_type n) const;
///
- size_type find_first_not_of(value_type const * p, size_type i = 0) const;
+ size_type find_first_not_of(value_type const * p,
+ size_type i = 0) const;
///
size_type find_first_not_of(value_type c, size_type i = 0) const;
///
- size_type find_last_not_of(lyxstring const &, size_type i = npos) const;
+ size_type find_last_not_of(lyxstring const &,
+ size_type i = npos) const;
///
size_type find_last_not_of(value_type const * p, size_type i,
size_type n) const;
///
- size_type find_last_not_of(value_type const * p, size_type i = npos) const;
+ size_type find_last_not_of(value_type const * p,
+ size_type i = npos) const;
///
size_type find_last_not_of(value_type c, size_type i = npos) const;
lyxstring & replace(size_type i,size_type n, value_type const * p);
///
- lyxstring & replace(size_type i, size_type n, size_type n2, value_type c);
+ lyxstring & replace(size_type i, size_type n,
+ size_type n2, value_type c);
///
lyxstring & replace(iterator i, iterator i2, const lyxstring & str);
lyxstring & replace(iterator i, iterator i2, value_type const * p);
///
- lyxstring & replace(iterator i, iterator i2, size_type n , value_type c);
+ lyxstring & replace(iterator i, iterator i2,
+ size_type n , value_type c);
///
lyxstring & replace(iterator i, iterator i2, iterator j, iterator j2);
/** This one returns a verbatim copy. Not the trailing '\0'
The caller must provide a buffer with engough room.
*/
- size_type copy(value_type * buf, size_type len, size_type pos = 0) const;
+ size_type copy(value_type * buf, size_type len,
+ size_type pos = 0) const;
//@}
//@}
private:
- ///
- lyxstring & operator+(int);
- ///
- lyxstring & operator=(int);
- ///
- lyxstring & operator+=(int);
-
- /// A string representation
- struct Srep {
- ///
- static lyxstring::size_type const xtra =
- static_cast<lyxstring::size_type>(8);
- /// size
- lyxstring::size_type sz;
- /// Reference count
- unsigned short ref;
- /// The total amount of data reserved for this representaion
- lyxstring::size_type res;
- /// Data. At least 1 char for trailing null.
- lyxstring::value_type * s;
-
- ///
- Srep(lyxstring::size_type nsz, const lyxstring::value_type * p);
- ///
- Srep(lyxstring::size_type nsz, lyxstring::value_type ch);
- ///
- ~Srep() { delete[] s; }
- ///
- Srep * get_own_copy()
- {
- if (ref == 1) return this;
- ref--;
- return new Srep(sz, s);
- }
-
- ///
- void assign(lyxstring::size_type nsz, const lyxstring::value_type * p);
- ///
- void assign(lyxstring::size_type nsz, lyxstring::value_type ch);
- ///
- void append(lyxstring::size_type asz, const lyxstring::value_type * p);
- ///
- void push_back(lyxstring::value_type c);
- ///
- void insert(lyxstring::size_type pos,
- const lyxstring::value_type * p,
- lyxstring::size_type n);
- ///
- void resize(lyxstring::size_type n, lyxstring::value_type c);
- ///
- void reserve(lyxstring::size_type res_arg);
- ///
- void replace(lyxstring::size_type i, lyxstring::size_type n,
- lyxstring::value_type const * p, lyxstring::size_type n2);
- private:
- Srep(const Srep &);
- Srep & operator=(const Srep &);
- };
-
- /** The empty_rep is a local static in each function that
+ // These three operators can be used to discover erronous use of
+ // ints and strings. However a conforming C++ compiler will flag
+ // a lot of char operations as ambigous when they are compiled
+ // in. Use them for debugging only (or perhaps not even then.)
+ // Lgb.
+ //
+ //lyxstring & operator+(int);
+ //
+ //lyxstring & operator=(int);
+ //
+ //lyxstring & operator+=(int);
+
+ /// Forward declaration of the string representation
+ struct Srep;
+ // DEC cxx requires this.
+ friend struct Srep;
+
+ /// A string is a pointer to it's representation
+ Srep * rep;
+
+ /** Note: The empty_rep is a local static in each function that
benefits from one. There is no "global" empty srep but lyxstring
doesn't need one (no code actually relies upon a single
empty srep).
This overcomes *all* "static initialization" problems,
at maximum speed, with a small overhead of a few local static
empty_reps.
- */
-
- /// A string is a pointer to it's representation
- Srep * rep;
+ */
#ifdef DEVEL_VERSION
/// lyxstringInvariant is used to test the lyxstring Invariant
friend class lyxstringInvariant;
-#endif //DEVEL_VERSION
+#endif
};
// The usual comparison operators ==, !=, >, <, >=, <= are
lyxstring operator+(lyxstring const & a, lyxstring::value_type const * b);
lyxstring operator+(lyxstring const & a, lyxstring::value_type b);
-class istream; class ostream;
istream & operator>>(istream &, lyxstring &);
ostream & operator<<(ostream &, lyxstring const &);
istream & getline(istream &, lyxstring &, lyxstring::value_type delim = '\n');