// -*- C++ -*-
+/**
+ * \file lyxlex.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Alejandro Aguilar Sierra
+ * \author Lars Gullik Bjønnes
+ *
+ * Full author contact details are available in file CREDITS.
+ */
+
// Generalized simple lexical analizer.
// It can be used for simple syntax parsers, like lyxrc,
-// texclass and others to come. [asierra30/03/96]
-//
-// Copyright 1996 Lyx Team.
+// texclass and others to come.
+
#ifndef LYXLEX_H
#define LYXLEX_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "support/docstring.h"
+
+#include <boost/utility.hpp>
#include <iosfwd>
-#include "LString.h"
-#include "support/utility.hpp"
+
+namespace lyx {
+
+namespace support { class FileName; }
///
struct keyword_item {
///
char const * tag;
///
- short code;
+ int code;
};
/** Generalized simple lexical analizer.
texclass and others to come.
@see lyxrc.C for an example of usage.
*/
-class LyXLex : public noncopyable {
+class LyXLex : boost::noncopyable {
public:
///
- LyXLex (keyword_item *, int);
+ LyXLex(keyword_item *, int);
///
~LyXLex();
-
+
/// Lex basic codes
enum {
///
LEX_TOKEN = -4
};
- /// file is open and end of file is not reached
- bool IsOK() const;
+ /// stream is open and end of stream is not reached
+ bool isOK() const;
+ /// stream is ok
+ operator void const *() const;
+ /// stream is not ok
+ bool operator!() const;
/// return true if able to open file, else false
- bool setFile(string const & filename);
+ bool setFile(support::FileName const & filename);
///
- void setStream(std::istream & i);
+ void setStream(std::istream & is);
///
std::istream & getStream();
/// Danger! Don't use it unless you know what you are doing.
void setLineNo(int l);
-
+ /// Change the character that begins a comment. Default is '#'
+ void setCommentChar(char c);
+
/// returns a lex code
int lex();
*/
bool nextToken();
/// Push a token, that next token got from lyxlex.
- void pushToken(string const &);
-
- ///
- int GetLineNo() const;
-
+ void pushToken(std::string const &);
+
+ ///
+ int getLineNo() const;
+
+ ///
+ int getInteger() const;
///
- int GetInteger() const;
+ bool getBool() const;
///
- bool GetBool() const;
+ double getFloat() const;
///
- float GetFloat() const;
+ std::string const getString() const;
+
///
- string const GetString() const;
-
+ docstring const getDocString() const;
+
/** Get a long string, ended by the tag `endtag'.
This string can span several lines. The first line
serves as a template for how many spaces the lines
each following line. This mechanism does not work
perfectly if you use tabs.
*/
- string const getLongString(string const & endtag);
-
- ///
- bool EatLine();
- ///
- int FindToken(char const * str[]);
- ///
- int CheckToken(char const * str[], int print_error);
+ std::string const getLongString(std::string const & endtag);
///
- string const text() const;
+ bool eatLine();
- /** Pushes a token list on a stack and replaces it with a new one.
- */
+ /// Pushes a token list on a stack and replaces it with a new one.
void pushTable(keyword_item *, int);
-
+
/** Pops a token list into void and replaces it with the one now
on top of the stack.
*/
and file name. If message contains the substring `$$Token',
it is replaced with the value of GetString()
*/
- void printError(string const & message) const;
+ void printError(std::string const & message) const;
- /**
- Prints the current token table on the supplied ostream.
- */
+ /// Prints the current token table on the supplied ostream.
void printTable(std::ostream &);
+
+ /// extract string
+ LyXLex & operator>>(std::string &);
+ /// extract docstring
+ LyXLex & operator>>(docstring &);
+ /// extract double
+ LyXLex & operator>>(double &);
+ /// extract integer
+ LyXLex & operator>>(int &);
+ /// extract unsigned integer
+ LyXLex & operator>>(unsigned int &);
+ /// extract bool
+ LyXLex & operator>>(bool &);
+
+ /// Quotes a string so that reading it again with LyXLex::next(true)
+ /// gets the original string
+ static std::string const quoteString(std::string const &);
+
private:
- struct Pimpl;
+ class Pimpl;
///
Pimpl * pimpl_;
};
This is needed to ensure that the pop is done upon exit from methods
with more than one exit point or that can return as a response to
exceptions.
- @autor Lgb
+ @author Lgb
*/
-struct pushpophelper {
+class pushpophelper {
+public:
///
pushpophelper(LyXLex & lexrc, keyword_item * i, int s) : lex(lexrc) {
lex.pushTable(i, s);
#define pushpophelper(x, y, z) unnamed_pushpophelper;
// Tip gotten from Bobby Schmidt's column in C/C++ Users Journal
+
+} // namespace lyx
+
#endif