it_bus/binary_buffer.h

#ifndef _IT_BUS_BINARY_BUFFER_H_
#define _IT_BUS_BINARY_BUFFER_H_

// @Copyright 2004 IONA Technologies, Plc. All Rights Reserved.
//

#include <it_bus/api_defines.h>
#include <it_bus/string.h>
#include <it_bus/exception.h>

namespace IT_Bus
{
    class IT_AFC_API BinaryBuffer
    {
    public:
        BinaryBuffer();

        BinaryBuffer(const BinaryBuffer& rhs);

        virtual ~BinaryBuffer();

        BinaryBuffer(String rhs);

        BinaryBuffer(const char * data, long size = -1);

        void operator=(const BinaryBuffer& rhs);

        void operator=(String rhs);
        
        BinaryBuffer&
            assign(const String & rhs, size_t n);

        void operator=(const char* rhs);
        
        BinaryBuffer& 
        assign(const char* rhs, size_t n);

        char operator[](long lIndex);

        operator const char*() const;
        operator unsigned char*();

        operator void*();

        operator const void * () const;

        bool
        operator==(
            const BinaryBuffer & rhs
        ) const;

        void attach(BinaryBuffer& attach_buffer);

        void borrow(const BinaryBuffer& borrow_buffer);

        void borrow(const char* borrow_data, long size = -1);

        bool is_borrowing();

        void attach_external(char* p, long size, bool borrow = true);

        void attach_external_const(const char* p, long size);

        void detach_external();

        void allocate(long size);

        void resize(long size) IT_THROW_DECL((IT_Bus::Exception));

        void copy(const char* p, long size = -1);

        void clear();

        const char* get_const_pointer() const;

        char* get_pointer() IT_THROW_DECL((IT_Bus::Exception));

        long get_size() const;

        IT_String get_it_string() const;

        char* at(long lIndex);

        String substr(long lIndex, long size = -1) const;

        long find_binary_buffer(long& dwFindIdx, long dwFindMaxIdx, BinaryBuffer& vvPacketTerminator) const;

        char* instr(char c, long lIndex = 0);

        long find(const char* s, long lIndex = 0) const;

        char* concat(const char* szThisString, long size = -1);

        bool empty() const { return (get_size() == 0); }
        
        String get_string() const;

    private:
        char*               m_data;

        long                m_size;

        bool                m_just_borrowing;


        bool                m_borrowed_const;
    };
}

#ifndef IT_IOSTREAMS_FREE
inline IT_ostream & operator<< (IT_ostream& os, const IT_Bus::BinaryBuffer& buffer)
{
    return os << buffer.get_const_pointer();
}
#endif 
#endif  

---