include/sk/util/String.h

/*  Copyright (c) 2005, Gennady Bystritsky <bystr@mac.com>
 *  
 *  Distributed under the MIT Licence.
 *  This is free software. See 'LICENSE' for details.
 *  You must read and accept the license prior to use.
*/

#ifndef _SK_UTIL_STRING_
#define _SK_UTIL_STRING_

#include <sk/util/Object.h>
#include <string>

namespace sk {
  namespace util {
    class String
      : public virtual sk::util::Object,
        public std::string
    {
      public:
        String();
        String(char character);
        String(const char* buffer);
        String(const char* buffer, int size);
        String(const std::string& string);
        String(const sk::util::String& string);
        String(const std::string& string, int size);
        virtual ~String();

        String& operator=(const sk::util::String& other);

        bool isEmpty() const;

        int size() const;
        int length() const;

        const String trim() const;
        const String squeeze(char character) const;
        const String strip() const;

        bool startsWith(const sk::util::String& prefix) const;
        bool startsWith(const char* prefix) const;

        int indexOf(char character) const;

        int lastIndexOf(char character) const;

        const String substring(int beginIndex) const;
        
        const String substring(int beginIndex, int endIndex) const;

        bool endsWith(const sk::util::String& suffix) const;
        bool endsWith(const char* suffix) const;

        bool equals(const sk::util::String& other) const;
        bool equals(const char* other) const;

        bool equalsIgnoreCase(const sk::util::String& other) const;
        bool equalsIgnoreCase(const char* other) const;

        const char* getChars() const;

        // sk::util::Object re-implementation.
        String& self();
        const String& self() const;
        const sk::util::Class getClass() const;
        const String toString() const;
        const String inspect() const;
        String* clone() const;

        static const String EMPTY;
    };
  }
}

const sk::util::String operator + (const sk::util::String& s1, const sk::util::String& s2);

const sk::util::String operator + (const sk::util::String& string, const char* buffer);
const sk::util::String operator + (const char* buffer, const sk::util::String& string);

const sk::util::String operator + (const sk::util::String& string, char character);
const sk::util::String operator + (char character, const sk::util::String& string);

const sk::util::String operator + ( const sk::util::String& s1, const std::string& s2);
const sk::util::String operator + (const std::string& s1, const sk::util::String& s2);

#endif /* _SK_UTIL_STRING_ */

---