File: IterativeReader.h

package info (click to toggle)
esys-particle 2.3.4%2Bdfsg1-4
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 13,036 kB
  • ctags: 10,805
  • sloc: cpp: 80,009; python: 5,872; makefile: 1,243; sh: 313; perl: 225
file content (128 lines) | stat: -rw-r--r-- 3,353 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/////////////////////////////////////////////////////////////
//                                                         //
// Copyright (c) 2003-2014 by The University of Queensland //
// Centre for Geoscience Computing                         //
// http://earth.uq.edu.au/centre-geoscience-computing      //
//                                                         //
// Primary Business: Brisbane, Queensland, Australia       //
// Licensed under the Open Software License version 3.0    //
// http://www.apache.org/licenses/LICENSE-2.0          //
//                                                         //
/////////////////////////////////////////////////////////////


#ifndef ESYS_LSMITERATIVEREADER_H
#define ESYS_LSMITERATIVEREADER_H

#include <sstream>
#include <memory>

namespace esys
{
  namespace lsm
  {
    /**
     *
     */
    template <class TmplData>
    class IStreamIterator
    {
    public:
      typedef TmplData value_type;
      
      IStreamIterator(std::istream &iStream, int numElements);

      virtual ~IStreamIterator();

      /**
       * Returns true if there are any elements remaining in
       * the stream.
       */
      bool hasNext() const;

      /**
       * Returns the next element in the stream.
       */
      const TmplData &next();

      /**
       * Returns the number of elements remaining in the stream.
       */
      int getNumRemaining() const;

    protected:
      IStreamIterator(const IStreamIterator &it);
      IStreamIterator &operator=(const IStreamIterator &it);

      virtual void readDataFromStream();
      
      std::istream *m_pIStream;
      TmplData     m_data;
      int          m_numRemaining;
    };

    /**
     * Template class which provides an iterator for reading
     * multiple data-items from a stream.
     *
     * @param TmplData data class.
     *        The <code>operator<<(std::istream &iStream, TmplData &data)</code>
     *        operator is used to assign stream data inside the
     *        methods of the IterativeReader<TmplData>::Iterator class.
     */
    template <class TmplIterator>
    class IterativeReader
    {
    public:
      typedef TmplIterator Iterator;
      
      IterativeReader(std::istream &iStream);

      virtual ~IterativeReader();

      /**
       * Creates the iterator using the istream and
       * using the value returned by getNumElements.
       */
      virtual void initialise();

      /**
       * Returns the number of elements to be read from the stream.
       */
      int getNumElements() const;

      /**
       * Returns whether this reader is initialised, that is,
       * whether an iterator has been created.
       */
      bool isInitialised() const;

      Iterator &getIterator();

      protected:
        typedef std::auto_ptr<Iterator> IteratorAutoPtr;

        void setNumElements(int numElements);

        std::istream &getIStream();

        const std::istream &getIStream() const;

        /**
         * Returns a new Iterator object. Caller of this method is
         * to take ownership for the returned object.
         */
        virtual Iterator *createNewIterator();

      private:
        
        int             m_numElements;
        std::istream    *m_pIStream;
        IteratorAutoPtr m_iteratorPtr;
    };
  }
}

#include "Parallel/IterativeReader.hpp"

#endif