extern void debugToken(std::ostream & os, Token const & t, unsigned int flags);
#endif
+/// A docstream version that supports putback even when not buffered
+class iparserdocstream
+{
+public:
+ typedef idocstream::int_type int_type;
+
+ iparserdocstream(idocstream & is) : is_(is) {}
+
+ /// Like std::istream::operator bool()
+ /// Do not convert is_ implicitly to bool, since that is forbidden in C++11.
+ explicit operator bool() const { return s_.empty() ? !is_.fail() : true; }
+
+ /// change the encoding of the input stream to \p e (iconv name)
+ void setEncoding(std::string const & e);
+
+ // add to the list of characters to read before actually reading
+ // the stream
+ void putback(char_type c);
+
+ // add to the list of characters to read before actually reading
+ // the stream
+ void putback(docstring s);
+
+ /// Like std::istream::get()
+ iparserdocstream & get(char_type &c);
+
+ /// Like std::istream::good()
+ bool good() const { return s_.empty() ? is_.good() : true; }
+
+ /// Like std::istream::peek()
+ int_type peek() const { return s_.empty() ? is_.peek() : s_[0]; }
+private:
+ ///
+ idocstream & is_;
+ /// characters to read before actually reading the stream
+ docstring s_;
+};
+
/*!
* Actual parser class
Parser & operator=(Parser const & p);
public:
///
- Parser(idocstream & is);
+ Parser(idocstream & is, std::string const & fixedenc);
///
Parser(std::string const & s);
///
~Parser();
+ /** forget already parsed next tokens and put the
+ * corresponding characters into the input stream for
+ * re-reading. Useful when changing catcodes. */
+ void deparse();
+
+ /// change the encoding of the input stream according to \p encoding
+ /// (latex name) and package \p package
+ bool setEncoding(std::string const & encoding, int const & package);
+ /// change the encoding of the input stream to \p encoding (iconv name)
+ bool setEncoding(std::string const & encoding);
+ /// get the current iconv encoding of the input stream
+ std::string getEncoding() const { return encoding_iconv_; }
+
///
CatCode catcode(char_type c) const;
///
/// set parser to normal or verbatim mode
void setCatcodes(cat_type t);
- /// change the iconv encoding of the input stream
- /// according to the latex encoding and package
- void setEncoding(std::string const & encoding, int const & package);
- /// change the iconv encoding of the input stream
- void setEncoding(std::string const & encoding);
- /// get the current iconv encoding of the input stream
- std::string getEncoding() const { return encoding_iconv_; }
-
///
int lineno() const { return lineno_; }
///
void pushPosition();
/// restore previous position
void popPosition();
+ /// forget last saved position
+ void dropPosition();
/// dump contents to screen
void dump() const;
* stopped at string \p end_string. Contrary to the other
* methods, this uses proper catcode setting. This function is
* designed to parse verbatim environments and command. The
- * intention is to eventually replace all of its siblings.
+ * intention is to eventually replace all of its siblings. the
+ * member \p first of the result tells whether the arg was
+ * found and the member \p second is the value. If \p
+ * allow_linebreak is false, then the parsing is limited to one line
*/
- std::string const verbatimStuff(std::string const & end_string);
+ Arg verbatimStuff(std::string const & end_string,
+ bool allow_linebreak = true);
/*
* \returns the contents of the environment \p name.
* <tt>\begin{name}</tt> must be parsed already,
std::string verbatim_item();
///
std::string verbatimOption();
- /*!
- * Returns the character of the current token and increments
- * the token position.
- */
- char getChar();
///
void error(std::string const & msg);
- ///
- void push_back(Token const & t);
/// The previous token.
Token const prev_token() const;
/// The current token.
Token const curr_token() const;
- /// The next token.
+ /// The next token. Caution: If this is called, an encoding change is
+ /// only possible again after get_token() has been called.
Token const next_token();
- /// The next but one token.
+ /// The next but one token. Caution: If this is called, an encoding
+ /// change is only possible again after get_token() has been called
+ /// twice.
Token const next_next_token();
/// Make the next token current and return that.
Token const get_token();
bool skip_spaces(bool skip_comments = false);
/// puts back spaces (and comments if \p skip_comments is true)
void unskip_spaces(bool skip_comments = false);
- ///
+ /// Is any further input pending()? This is not like
+ /// std::istream::good(), which returns true if all available input
+ /// was read, and the next attempt to read would return EOF.
bool good();
/// resets the parser to initial state
void reset();
/// Parses one token from \p is
void tokenize_one();
///
+ void push_back(Token const & t);
+ ///
int lineno_;
///
std::vector<Token> tokens_;
///
- unsigned pos_;
+ size_t pos_;
///
std::vector<unsigned> positions_;
///
idocstringstream * iss_;
///
- idocstream & is_;
+ iparserdocstream is_;
/// iconv name of the current encoding
std::string encoding_iconv_;
///
CatCode theCatcode_[256];
- //
+ ///
cat_type theCatcodesType_;
- //
+ ///
cat_type curr_cat_;
+ ///
+ bool fixed_enc_;
};