nstring.h

Go to the documentation of this file.

// LICENSE: (Please see the file COPYING for details)
//
// NUS - Nemesis Utilities System: A C++ application development framework 
// Copyright (C) 2006, 2007 Otavio Rodolfo Piske
//
//  This file is part of NUS
//
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Lesser General Public
//  License as published by the Free Software Foundation version 2.1
//  of the License.
//
//  This library is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//  Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public
//  License along with this library; if not, write to the Free Software
//  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//
#ifndef NSTRING_H
#define NSTRING_H

#include "ndefs.h"
#include "nlist.h"

#include <cstdio>
#include <cstdarg>
#include <cstring>
#include <cstdlib>

// Ok, I don't like this voodoo. But given the scenario I don't think there
// would be a better way to do this magic.
#undef n_vasprintf
#if defined(__WIN32) && defined (_MSC_VER)
#define n_vasprintf(fmt, ap, ret) \
{ \
      int len = _vscprintf(fmt, ap); \
      ret = static_cast<char *>(malloc(len * sizeof(char))); \
      vsprintf_s(ret, len, fmt, ap); \
}
#elif defined(__WIN32) && defined (__GNUC__) 
#define n_vasprintf(fmt, ap, ret) \
{ \
      int max_size = 2048;\
      ret = static_cast<char *>(malloc(max_size));\
      vsnprintf(ret, max_size, fmt, ap); \
}
#else
#define n_vasprintf(fmt, ap, ret) vasprintf(&ret, fmt, ap);
#endif

class DllDeclSpec NString {
      public:
            NString(void);
      
            NString(const char *str);
            
            NString(const NString &str);
            
            ~NString(void);
            
            static NString number(int num);
            
            static NString number(nint64 num);
            
            NString &set(const char *str);
            
            NString &set(const NString &str);
            
            const char *toChar() const;

            
            unsigned int length() const;
            
            bool isNull() const;
            
            NString &append(const char *str, nuint32 bytes);
            
            NString &append(const char *str);
            
            NString &append(const NString &str);
            
            NString &append(char c);
            
            NString &insert(nuint32 pos, nuint32 size, const NString str);
            
            NString &insert(nuint32 pos, const NString str);

            bool compare(nuint32 pos, nuint32 size, const NString &str) const;
            
            
            bool compare(nuint32 pos, const NString &str) const;
            
            bool compare(nuint32 pos, nuint32 size, const NString &str, 
                        nuint32 str_pos) const;
            
            NString substr(nuint32 pos, nuint32 size) const;


            nint32 find(const NString &str, nuint32 pos, nuint32 ocur) const;

            nint32 find(const NString &str, nuint32 pos) const;


            nint32 find(const NString &str) const;


            NString &replace_first(const NString &src, const NString &dest);

            NString &replace(const NString &src, const NString &dest);

            NString &replace(const NString &src, const NString &dest, 
                  nuint32 ocur);


            NList<NString> split(const NString &substr);

            NString operator+(const char *str);
            NString operator+(const NString &str);
            
            NString operator+(char c);
            
            NString &operator+=(const char *str);
            
            NString &operator+=(const NString &str);
            
            NString &operator+=(char c);
            
            char operator[](unsigned int index) const;
            
            bool operator==(const NString &str) const;
            
            bool operator!=(const NString &str) const;
            
            bool operator>(const NString &str) const;
            
            bool operator<(const NString &str) const;
            
            bool operator>=(const NString &str) const;
            
            bool operator<=(const NString &str) const;
            
            
            NString &operator=(const NString &str);

            
            NString &arg(const char *fmt, ...);

            static const nint32 NOT_FOUND; 
      private:
            char *m_string;
            nuint32 m_used;
            nuint32 m_allocated;
            static const nuint32 ALLOC_SIZE;
            
            bool needsMemory(nuint32 bytes);
            nuint32 calculateBlocks(nuint32 bytes);
            void memcopy(char *dest);
            nuint32 freeBytes(void) const;
            void realloc(nuint32 bytes);
      
};

inline NString NSTR(const char *str) { 
      return NString(str);    
}

#endif // NSTRING_H

---