X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Flyxlex.h;h=7f6cc26e0225487f7b5da7ffa47bb1d95bce774d;hb=e7f4618bcce770369cf46335c2c7f0164b4b8857;hp=f884ccd8ebcb622797022b1fcc6b84daebf6d4a9;hpb=985aec9f0f809899b5612e8d6f1073c7df1f2327;p=lyx.git diff --git a/src/lyxlex.h b/src/lyxlex.h index f884ccd8eb..7f6cc26e02 100644 --- a/src/lyxlex.h +++ b/src/lyxlex.h @@ -1,20 +1,32 @@ // -*- 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 #include -#include "LString.h" -#include + +namespace lyx { + +namespace support { class FileName; } /// struct keyword_item { @@ -29,13 +41,13 @@ struct keyword_item { texclass and others to come. @see lyxrc.C for an example of usage. */ -class LyXLex : boost::noncopyable { +class LyXLex : boost::noncopyable { public: /// - LyXLex (keyword_item *, int); + LyXLex(keyword_item *, int); /// ~LyXLex(); - + /// Lex basic codes enum { /// @@ -48,12 +60,16 @@ public: LEX_TOKEN = -4 }; - /// file is open and end of file is not reached + /// 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. @@ -75,20 +91,23 @@ public: */ bool nextToken(); /// Push a token, that next token got from lyxlex. - void pushToken(string const &); - - /// + void pushToken(std::string const &); + + /// int getLineNo() const; - + /// int getInteger() const; /// bool getBool() const; /// - float getFloat() const; + double 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 @@ -96,20 +115,14 @@ public: 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[]); + 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. */ @@ -119,14 +132,30 @@ public: 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_; }; @@ -136,9 +165,10 @@ private: 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); @@ -158,4 +188,7 @@ struct pushpophelper { #define pushpophelper(x, y, z) unnamed_pushpophelper; // Tip gotten from Bobby Schmidt's column in C/C++ Users Journal + +} // namespace lyx + #endif