CStringBuilder.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2012  Mark A Lindner

   This file is part of commonc++.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   ---------------------------------------------------------------------------
*/

#ifndef __ccxx_CStringBuilder_hxx
#define __ccxx_CStringBuilder_hxx

#include <commonc++/Common.h++>

namespace ccxx {

class COMMONCPP_API CStringBuilder
{
  public:

  CStringBuilder(char *buf, size_t size);

  ~CStringBuilder();

  CStringBuilder& clear();

  CStringBuilder& append(const char *s, size_t length = 0);

  CStringBuilder& append(char c);

  CStringBuilder& append(int val, size_t width, bool zeroPad = true);

  CStringBuilder& append(uint_t val, size_t width, bool zeroPad = true);

  inline char *getPosition() const
  { return(_pos); }

  inline size_t getRemaining() const
  { return(_left); }

  inline bool hasRemaining() const
  { return(_left > 0); }

  inline size_t getLength() const
  { return(_pos - _buf); }

  inline size_t length() const
  { return(getLength()); }

  inline char *c_str() const
  { return(_buf); }

  bool bump(size_t delta);

  void terminate();

  inline CStringBuilder& operator+=(const char *s)
  { return(append(s)); }

  inline CStringBuilder& operator+=(char c)
  { return(append(c)); }

  private:

  CCXX_COPY_DECLS(CStringBuilder);

  template<typename T> char * _formatValue(T value, size_t width,
                                           char padChar, char *buf,
                                           size_t bufsz);

  char *_buf;
  size_t _length;
  char *_pos;
  size_t _left;
};

}; // namespace ccxx

#endif // __ccxx_CStringBuilder_hxx