---

StringIODevice.h

/*****************************************************************************
 * Author:   Valient Gough <vgough@pobox.com>
 *
 *****************************************************************************
 * Copyright (c) 2001, Valient Gough
 *
 * This library is free software; you can distribute it and/or modify it under
 * the terms of the GNU Lesser General Public License (LGPL), as published by
 * the Free Software Foundation; either version 2.1 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 LGPL in the file COPYING for more
 * details.
 *
 */

#ifndef _StringIODevice_incl_
#define _StringIODevice_incl_

#include <rel/IODevice.h>
#include <string>

namespace rel
{

    class TypeStream;

    /*
        StringIODevice implements the IODevice interface to store data in
        memory in a string.  Writes append to the end of the string, and reads
        happen at the current location ( at() ).
     */
    class StringIODevice : public IODevice
    {
    public:
        StringIODevice();
        StringIODevice(const StringIODevice &src);
        ~StringIODevice();

        StringIODevice &operator = (const StringIODevice &src);

        virtual size_type writeBytes(const char *data, size_type len);

        virtual size_type readBytes(char *data, size_type maxLen);

        // return true if at end of stream
        virtual bool atEnd() const;


        // return current location in stream
        virtual size_type at() const;

        // change location in stream
        virtual bool at(size_type offset);

        // display output in human readable form..
        virtual SmartPtr<char*> print();

        // remove anything in the stream
        void clear();

        bool writeToStream(TypeStream &output) const;
        bool readFromStream(const TypeStream &input);

    private:
        std::string fData;
        size_type fOffset;
        size_type fSize;
    };

} // namespace rel


rel::TypeStream &operator << (rel::TypeStream &output, 
        const rel::StringIODevice &src);
const rel::TypeStream &operator >> (const rel::TypeStream &input, 
        rel::StringIODevice &src);

#endif

---