---

CharChopper.h

#ifndef _STR_CharChopper_H_  // -*-c++-*-

/*
 * Copyright 1991-2002 Eric M. Hopper <hopper@omnifarious.org>
 * 
 *     This program 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; either version 2 of the License, or
 *     (at your option) any later version.
 * 
 *     This program 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 program; if not, write to the Free Software
 *     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#ifdef __GNUG__
#  pragma interface
#endif

/* $Header: /home/hopper/src/cvs/C++/StrMod/StrMod/CharChopper.h,v 1.9 2002/11/25 05:40:05 hopper Exp $ */

// For a log, see ../Changelog
//
// Revision 1.1  1996/09/02 23:28:27  hopper
// Added CharChopper class so users would have a simple class that would
// break up and recombine streams using whatever character they chose as
// a separator.
//

#include <cstddef>
#include <cassert>
#include <StrMod/StreamProcessor.h>
#include <StrMod/StrChunkPtrT.h>
#include <StrMod/BufferChunk.h>
#include <StrMod/GroupChunk.h>

#define _STR_CharChopper_H_

namespace strmod {
namespace strmod {

class GroupVector;

/** \class CharChopper CharChopper.h StrMod/CharChopper.h
 * \brief Chops up the data in chunks delimited by a character.
 *
 * If an object of this class is constructed with a 'g', and you have
 * an incoming stream of data that arrives in the following chunks:
 *
 * \code <This ghost> < went to the gilded post t> <o admire the gold.> \endcode
 *
 * You'll end up with an outgoing stream of data that looks like this:
 *
 * \code <This g> <host went to the g> <ilded post to admire the g> \endcode
 *
 * It will hold the last few characters <old.>, waiting for another 'g' before
 * it send them off again.
 */
class CharChopper : public StreamProcessor
{
 public:
   static const STR_ClassIdent identifier;

   /** Make a CharChopper
    * @param chopchar The character to split by.
    *
    * The character can be anything, including '\\0'.
    */
   CharChopper(char chopchar) : chopchar_(chopchar)    { }
   // Derived class destructor doesn't do anything base class one doesn't do.

   inline virtual int AreYouA(const lcore::ClassIdent &cid) const;

 private:
   const char chopchar_;
   StrChunkPtrT<GroupChunk> groupdata_;
   StrChunkPtrT<BufferChunk> curdata_;
   size_t usedsize_;
   enum { INYes, INNo, INMaybe } incoming_is_bc_;

   virtual const lcore::ClassIdent *i_GetIdent() const  { return &identifier; }

   virtual void processIncoming();

   void addChunk(const StrChunkPtr &chnk);
   inline void checkIncoming();
   inline void zeroIncoming();
   inline void replaceIncoming(const StrChunkPtr &data);

 private:
   CharChopper(const CharChopper &b);
};

//-----------------------------inline functions--------------------------------

inline int CharChopper::AreYouA(const lcore::ClassIdent &cid) const
{
   return((identifier == cid) || StreamProcessor::AreYouA(cid));
}

inline void CharChopper::checkIncoming()
{
   assert(incoming_);
   if (incoming_is_bc_ == INMaybe)
   {
      if (incoming_->AreYouA(BufferChunk::identifier))
      {
         incoming_is_bc_ = INYes;
      }
      else
      {
         incoming_is_bc_ = INNo;
      }
   }
}

inline void CharChopper::zeroIncoming()
{
   incoming_.ReleasePtr();
   incoming_is_bc_ = INMaybe;
}

inline void CharChopper::replaceIncoming(const StrChunkPtr &data)
{
   incoming_ = data;
}

};  // namespace strmod
};  // namespace strmod

#endif

---