src/pariterator.h

   1 // -*- C++ -*-
   2 /* \file pariterator.h
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author unknown
   7  * \author Lars Gullik Bjønnes
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef PARITERATOR_H
  13 #define PARITERATOR_H
  14
  15 #include "dociterator.h"
  16
  17 #include "support/types.h"
  18
  19 #include <boost/optional.hpp>
  20
  21 #include <vector>
  22
  23
  24
  25 class InsetBase;
  26 class LyXText;
  27 class ParagraphList;
  28
  29
  30 class ParIterator : public std::iterator<std::forward_iterator_tag, Paragraph>,
  31                     public DocIterator
  32 {
  33 public:
  34         typedef std::iterator<std::forward_iterator_tag, Paragraph> StdIt;
  35
  36         typedef StdIt::value_type value_type;
  37         typedef StdIt::difference_type difference_type;
  38         typedef StdIt::pointer pointer;
  39         typedef StdIt::reference reference;
  40
  41         ///
  42         ParIterator() : DocIterator() {}
  43
  44
  45         ///
  46         ParIterator(InsetBase &, lyx::pit_type pit);
  47         ///
  48         ParIterator(ParIterator const &);
  49         ///
  50         ParIterator(DocIterator const &);
  51
  52         /// This really should be implemented...
  53         //ParIterator & operator=(ParIterator const &);
  54         ///
  55         ParIterator & operator++();
  56         ///
  57         ParIterator operator++(int);
  58         /// See comment in pariterator.C
  59         //ParIterator & operator--();
  60         ///
  61         Paragraph & operator*() const;
  62         ///
  63         Paragraph * operator->() const;
  64         /// This gives us the top-most parent paragraph
  65         lyx::pit_type outerPar() const;
  66         ///
  67         lyx::pit_type pit() const;
  68         ///
  69         ParagraphList & plist() const;
  70 };
  71
  72
  73 DocIterator makeDocIterator(ParIterator const &, lyx::pos_type);
  74
  75 ParIterator par_iterator_begin(InsetBase & inset);
  76
  77 ParIterator par_iterator_end(InsetBase & inset);
  78
  79
  80 ///
  81 bool operator==(ParIterator const & iter1, ParIterator const & iter2);
  82
  83 ///
  84 bool operator!=(ParIterator const & iter1, ParIterator const & iter2);
  85
  86
  87 class ParConstIterator : public std::iterator<std::forward_iterator_tag,
  88                          Paragraph>,
  89                          public DocIterator
  90 {
  91 public:
  92         ///
  93         ParConstIterator(ParConstIterator const &);
  94         ///
  95         ParConstIterator(DocIterator const &);
  96         ///
  97
  98         ParConstIterator & operator++();
  99         ///
 100         ParConstIterator & operator--();
 101         ///
 102         Paragraph const & operator*() const;
 103         ///
 104         Paragraph const * operator->() const;
 105         ///
 106         ParagraphList const & plist() const;
 107 };
 108
 109 bool operator==(ParConstIterator const & iter1,
 110                 ParConstIterator const & iter2);
 111
 112 bool operator!=(ParConstIterator const & iter1,
 113                 ParConstIterator const & iter2);
 114
 115
 116 ParConstIterator par_const_iterator_begin(InsetBase const & inset);
 117
 118 ParConstIterator par_const_iterator_end(InsetBase const & inset);
 119
 120
 121 #endif