debian/libbit-dev/usr/include/bit-0.3/bit/recordbuffer.h

00001 /***************************************************************************
00002  *   Copyright (C) 2001 by Rick L. Vinyard, Jr.                            *
00003  *   rvinyard@cs.nmsu.edu                                                  *
00004  *                                                                         *
00005  *   This program is free software; you can redistribute it and/or modify  *
00006  *   it under the terms of the GNU Lesser General Public License as        *
00007  *   published by the Free Software Foundation version 2.1.                *
00008  *                                                                         *
00009  *   This program is distributed in the hope that it will be useful,       *
00010  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
00011  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
00012  *   GNU General Public License for more details.                          *
00013  *                                                                         *
00014  *   You should have received a copy of the GNU Lesser General Public      *
00015  *   License along with this library; if not, write to the                 *
00016  *   Free Software Foundation, Inc.,                                       *
00017  *   51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA              *
00018  ***************************************************************************/
00019 #ifndef BITRECORDBUFFER_H
00020 #define BITRECORDBUFFER_H
00021 
00022 #include <string>
00023 #include <queue>
00024 #include <set>
00025 
00026 #include <bit/buffer.h>
00027 #include <bit/record.h>
00028 #include <bit/fieldbuffer.h>
00029 #include <bit/data.h>
00030 #include <bit/except.h>
00031 
00032 namespace bit
00033   {
00034 
00041   class RecordBuffer : public Buffer
00042     {
00043     protected:
00044       friend class FieldBuffer;
00045 
00046       RecordBuffer(size_t initial_size=0, size_t sizemax=0);
00047 
00048       RecordBuffer(RecordBase::pointer record, size_t initial_size=0, size_t sizemax=0);
00049 
00050       RecordBuffer(void* external_data, size_t data_octets, size_t sizemax=0, DataMode mode=COPY);
00051 
00052       RecordBuffer(RecordBase::pointer record,
00053                    void* external_data,
00054                    size_t data_octets,
00055                    size_t sizemax=0,
00056                    DataMode mode=COPY
00057                   );
00058 
00059     public:
00060       typedef BitPointer<RecordBuffer> pointer;
00061 
00062       static pointer create(size_t initial_size=0, size_t sizemax=0);
00063 
00064       static pointer create(RecordBase::pointer record, size_t initial_size=0, size_t sizemax=0);
00065 
00066       static pointer create(void* external_data, size_t data_octets, size_t sizemax=0, DataMode mode=COPY);
00067 
00068       static pointer create(RecordBase::pointer record,
00069                    void* external_data,
00070                    size_t data_octets,
00071                    size_t sizemax=0,
00072                    DataMode mode=COPY
00073                   );
00074 
00075       virtual ~RecordBuffer();
00076 
00077       const std::string& xml();
00078 
00079       std::string xml(FieldBase::pointer i);
00080 
00081       FieldBuffer field(size_t) throw (exception::no_record);
00082       FieldBuffer field(std::string) throw (exception::no_record);
00083       FieldBuffer field(FieldBase::iterator);
00084       FieldBuffer field(FieldBase::pointer);
00085 
00086       FieldBuffer operator[](size_t) throw (exception::no_record);
00087       FieldBuffer operator[](std::string) throw (exception::no_record);
00088       FieldBuffer operator[](FieldBase::iterator);
00089       FieldBuffer operator[](FieldBase::pointer);
00090 
00091       virtual void set_data(const void* data, size_t size);
00092 
00093       void set_record(RecordBase::pointer record) throw ();
00094       void clear_record() throw ();
00095       RecordBase::pointer record();
00096 
00097       sigc::signal<void, FieldBuffer> signal_field_changed();
00098 
00099       sigc::signal<void> signal_record_changed();
00100 
00101     protected:
00106       RecordBase::pointer m_record;
00107 
00108       std::string m_xml;
00109 
00118       void on_field_changed(FieldBase::pointer field);
00119 
00120       void on_record_changed();
00121 
00122     private:
00123 
00124       sigc::signal<void> m_signal_record_changed;
00125 
00137       sigc::signal<void, FieldBuffer> m_signal_field_changed;
00138 
00139       // Stores the fields that have changed and still need to have an emit signal
00140       //called. The fields are stored in the order they are changed.
00141       std::queue< FieldBase::pointer > m_signal_field_changed_queue;
00142 
00143       //Stores the set of fields that have changed and still need an emit signal.
00144       //The set is used to provide quick lookup O(lg n) rather than the O(n) necessary
00145       //in the queue.
00146       std::set< FieldBase::pointer >  m_signal_field_changed_set;
00147 
00148       bool  m_signal_field_changed_emitting;
00149     };
00150 
00151 }
00152 
00153 #endif

Generated on Tue Mar 13 20:00:01 2007 by  doxygen 1.5.1