4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Lars Gullik Bjønnes
9 * Full author contact details are available in file CREDITS.
15 #include "support/strfwd.h"
29 } // namespace support
32 * The class holds all all open buffers, and handles construction
33 * and deletions of new ones.
37 typedef std::vector<Buffer *>::iterator iterator;
38 typedef std::vector<Buffer *>::const_iterator const_iterator;
45 const_iterator begin() const;
48 const_iterator end() const;
50 /// create a new buffer and add it to the buffer list
51 /// \return 0 if the Buffer creation is not possible for whatever reason.
52 Buffer * newBuffer(std::string const & s);
54 /// create an internal buffer and add it to the internal buffer list
55 /// \return 0 if the Buffer creation is not possible for whatever reason.
56 Buffer * newInternalBuffer(std::string const & s);
58 /// Is child a child of some Buffer other than parent?
59 /// NOTE: child must be a child of parent, and both must be non-null.
60 /// Otherwise we assert.
61 bool isOthersChild(Buffer * parent, Buffer * child) const;
64 void release(Buffer * b);
66 /// Close all open buffers.
69 /// returns a vector with all the buffers filenames
70 support::FileNameList fileNames() const;
72 /// return true if no buffers loaded
75 /// return head of buffer list if any
78 /// return back of buffer list if any
81 /// returns true if the buffer exists already
82 bool exists(support::FileName const &) const;
84 /// returns true if the buffer is loaded
85 bool isLoaded(Buffer const * b) const;
87 /// returns true if the buffer is known as internal buffer
88 bool isInternal(Buffer const * b) const;
90 /// \return index of named buffer in buffer list
91 int bufferNum(support::FileName const & name) const;
93 /** returns a pointer to the buffer with the given name
96 * If true, the buffer is searched also among internal buffers
98 Buffer * getBuffer(support::FileName const & name, bool internal = false) const;
100 /// \return a pointer to the buffer with the given number
101 Buffer * getBuffer(unsigned int);
103 /// \return a pointer to the buffer whose temppath matches the given \p path
104 /// If optional \p realpath is \c true the lookup is done with real path names
105 Buffer * getBufferFromTmp(std::string const & path, bool realpath = false);
107 /** returns a pointer to the buffer that follows argument in
108 * buffer list. The buffer following the last in list is the
111 Buffer * next(Buffer const *) const;
113 /** returns a pointer to the buffer that precedes argument in
114 * buffer list. The buffer preceding the first in list is the
117 Buffer * previous(Buffer const *) const;
119 /// \name Functions that just operate on all buffers
121 /// reset current author for all buffers
122 void recordCurrentAuthor(Author const & author);
123 /// update previews for all buffers, e.g. for Prefs update
124 void updatePreviews();
125 /// Call changed() on all buffers, internal or not
126 void changed(bool update_metrics) const;
127 /// emergency save for all buffers
128 void emergencyWriteAll();
130 void updateIncludedTeXfiles(std::string const &, OutputParams const &);
132 void invalidateConverterCache() const;
136 /// create a new buffer
137 /// \return 0 if the Buffer creation is not possible for whatever reason.
138 Buffer * createNewBuffer(std::string const & s);
141 BufferList(BufferList const &);
142 void operator=(BufferList const &);
144 typedef std::vector<Buffer *> BufferStorage;
146 /// storage of all buffers
147 BufferStorage bstore;
148 /// storage of all internal buffers used for cut&paste, etc.
149 BufferStorage binternal;
152 /// Implementation is in LyX.cpp
153 extern BufferList & theBufferList();
158 #endif // BUFFERLIST_H