// -*- C++ -*-
-/* This file is part of
- * ======================================================
- *
- * LyX, The Document Processor
- * Copyright 1995 Matthias Ettrich
- * Copyright 1995-1999 The LyX Team
+/**
+ * \file bufferlist.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * This file is Copyright 1996
- * Lars Gullik Bjønnes
+ * \author Lars Gullik Bjønnes
*
- * ====================================================== */
+ * Full author contact details are available in file CREDITS.
+ */
#ifndef BUFFER_LIST_H
#define BUFFER_LIST_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "support/docstring.h"
-#include "buffer.h"
-#include "debug.h"
+#include <boost/utility.hpp>
-/** A class to hold all the buffers in a structure
- The point of this class is to hide from bufferlist what kind
- of structure the buffers are stored in. Should be no concern for
- bufferlist if the buffers is in a array or in a linked list.
+#include <vector>
- This class should ideally be enclosed inside class BufferList, but that
- gave me an "internal gcc error".
- */
-class BufferStorage {
-public:
- ///
- typedef vector<Buffer *> Container;
- ///
- typedef Container::iterator iterator;
- ///
- bool empty() const { return container.empty(); }
- ///
- void release(Buffer * buf);
- ///
- Buffer * newBuffer(string const & s, LyXRC *, bool = false);
- ///
- Container::iterator begin() { return container.begin(); }
- ///
- Container::iterator end() { return container.end(); }
- ///
- Buffer * front() { return container.front(); }
- ///
- Buffer * operator[](int c) { return container[c]; }
- ///
- int size() const { return container.size(); }
-private:
- ///
- Container container;
-};
+namespace lyx {
-/** The class governing all the open buffers
- This class governs all the currently open buffers. Currently all the buffer
- are located in a static array, soon this will change and we will have a
- linked list instead.
+class Buffer;
+class OutputParams;
+
+/**
+ * The class holds all all open buffers, and handles construction
+ * and deletions of new ones.
*/
-class BufferList {
+class BufferList : boost::noncopyable {
public:
- ///
- BufferList();
-
- /// state info
- enum list_state {
- ///
- OK,
- ///
- CLOSING
- };
-
- /// returns the state of the bufferlist
- list_state getState() { return _state; }
-
- /** loads a LyX file or...
- If the optional argument tolastfiles is false (default is
- true), the file name will not be added to the last opened
- files list
- */
- Buffer * loadLyXFile(string const & filename,
- bool tolastfiles = true);
-
- ///
- bool empty();
-
- /// Saves buffer. Returns false if unsuccesful.
- bool write(Buffer *, bool makeBackup = true);
-
- ///
- bool QwriteAll();
+ typedef std::vector<Buffer *>::iterator iterator;
+ typedef std::vector<Buffer *>::const_iterator const_iterator;
- /// Close all open buffers.
- void closeAll();
+public:
+ BufferList();
- ///
- void resize();
+ iterator begin();
+ const_iterator begin() const;
- /// Read a file into a buffer readonly or not.
- Buffer * readFile(string const &, bool ro);
+ iterator end();
+ const_iterator end() const;
- /// Make a new file (buffer) using a template
- Buffer * newFile(string const &, string);
+ /// write all buffers, asking the user, returns false if cancelled
+ bool quitWriteAll();
- /** This one must be moved to some other place.
- */
- void makePup(int);
+ /// create a new buffer
+ Buffer * newBuffer(std::string const & s, bool ronly = false);
- ///
- void updateInset(Inset *, bool = true);
+ /// delete a buffer
+ void release(Buffer * b);
- ///
- int unlockInset(UpdatableInset *);
+ /// Close all open buffers.
+ void closeAll();
- ///
- void updateIncludedTeXfiles(string const &);
+ /// returns a vector with all the buffers filenames
+ std::vector<std::string> const getFileNames() const;
- ///
+ /// FIXME
+ void updateIncludedTeXfiles(std::string const &, OutputParams const &);
+
+ /// emergency save for all buffers
void emergencyWriteAll();
- /** closes buffer
- Returns false if operation was canceled
- */
- bool close(Buffer *);
+ /// close buffer. Returns false if cancelled by user
+ bool close(Buffer * buf, bool ask);
+
+ /// return true if no buffers loaded
+ bool empty() const;
- ///
+ /// return head of buffer list if any
Buffer * first();
-
+
+ /// return back of buffer list if any
+ Buffer * last();
+
/// returns true if the buffer exists already
- bool exists(string const &);
+ bool exists(std::string const &) const;
+
+ /// returns true if the buffer is loaded
+ bool isLoaded(Buffer const * b) const;
/// returns a pointer to the buffer with the given name.
- Buffer * getBuffer(string const &);
+ Buffer * getBuffer(std::string const &);
/// returns a pointer to the buffer with the given number.
- Buffer * getBuffer(int);
+ Buffer * getBuffer(unsigned int);
+ /// returns a pointer to the buffer whose temppath matches the string
+ Buffer * getBufferFromTmp(std::string const &);
+
+ /** returns a pointer to the buffer that follows argument in
+ * buffer list. The buffer following the last in list is the
+ * first one.
+ */
+ Buffer * next(Buffer const *) const;
+
+ /** returns a pointer to the buffer that precedes argument in
+ * buffer list. The buffer preceding the first in list is the
+ * last one.
+ */
+ Buffer * previous(Buffer const *) const;
+
+ /// reset current author for all buffers
+ void setCurrentAuthor(docstring const & name, docstring const & email);
private:
- ///
+ /// ask to save a buffer on quit, returns false if should cancel
+ bool quitWriteBuffer(Buffer * buf);
+
+ typedef std::vector<Buffer *> BufferStorage;
+
+ /// storage of all buffers
BufferStorage bstore;
-
- ///
- list_state _state;
+
+ /// save emergency file for the given buffer
+ void emergencyWrite(Buffer * buf);
};
-#endif
+/// Implementation is in lyx_main.C
+extern BufferList & theBufferList();
+
+
+} // namespace lyx
+
+#endif // BUFFERLIST_H