| 1 | tim | 2469 | #ifndef INC_TokenStreamSelector_hpp__ | 
| 2 |  |  | #define INC_TokenStreamSelector_hpp__ | 
| 3 |  |  |  | 
| 4 |  |  | /* ANTLR Translator Generator | 
| 5 |  |  | * Project led by Terence Parr at http://www.jGuru.com | 
| 6 |  |  | * Software rights: http://www.antlr.org/license.html | 
| 7 |  |  | * | 
| 8 |  |  | * $Id: TokenStreamSelector.hpp,v 1.1 2005-12-02 15:38:02 tim Exp $ | 
| 9 |  |  | */ | 
| 10 |  |  |  | 
| 11 |  |  | #include <antlr/config.hpp> | 
| 12 |  |  | #include <antlr/TokenStream.hpp> | 
| 13 |  |  | #include <map> | 
| 14 |  |  | #include <stack> | 
| 15 |  |  |  | 
| 16 |  |  | #ifdef ANTLR_CXX_SUPPORTS_NAMESPACE | 
| 17 |  |  | namespace antlr { | 
| 18 |  |  | #endif | 
| 19 |  |  |  | 
| 20 |  |  | /** A token stream MUX (multiplexor) knows about n token streams | 
| 21 |  |  | *  and can multiplex them onto the same channel for use by token | 
| 22 |  |  | *  stream consumer like a parser.  This is a way to have multiple | 
| 23 |  |  | *  lexers break up the same input stream for a single parser. | 
| 24 |  |  | * Or, you can have multiple instances of the same lexer handle | 
| 25 |  |  | *  multiple input streams; this works great for includes. | 
| 26 |  |  | */ | 
| 27 |  |  | class ANTLR_API TokenStreamSelector : public TokenStream { | 
| 28 |  |  | protected: | 
| 29 |  |  | /** The set of inputs to the MUX */ | 
| 30 |  |  | #ifdef OS_NO_ALLOCATOR | 
| 31 |  |  | typedef ANTLR_USE_NAMESPACE(std)less<ANTLR_USE_NAMESPACE(std)string> lessp; | 
| 32 |  |  | typedef ANTLR_USE_NAMESPACE(std)map<ANTLR_USE_NAMESPACE(std)string,TokenStream*,lessp> inputStreamNames_coll; | 
| 33 |  |  | #else | 
| 34 |  |  | typedef ANTLR_USE_NAMESPACE(std)map<ANTLR_USE_NAMESPACE(std)string,TokenStream*> inputStreamNames_coll; | 
| 35 |  |  | #endif | 
| 36 |  |  | inputStreamNames_coll inputStreamNames; | 
| 37 |  |  |  | 
| 38 |  |  | /** The currently-selected token stream input */ | 
| 39 |  |  | TokenStream* input; | 
| 40 |  |  |  | 
| 41 |  |  | /** Used to track stack of input streams */ | 
| 42 |  |  | #ifdef OS_NO_ALLOCATOR | 
| 43 |  |  | typedef ANTLR_USE_NAMESPACE(std)stack<TokenStream*, ANTLR_USE_NAMESPACE(std)deque<TokenStream*> > streamStack_coll; | 
| 44 |  |  | #else | 
| 45 |  |  | typedef ANTLR_USE_NAMESPACE(std)stack<TokenStream*> streamStack_coll; | 
| 46 |  |  | #endif | 
| 47 |  |  | streamStack_coll streamStack; | 
| 48 |  |  |  | 
| 49 |  |  | public: | 
| 50 |  |  | TokenStreamSelector(); | 
| 51 |  |  | ~TokenStreamSelector(); | 
| 52 |  |  |  | 
| 53 |  |  | void addInputStream(TokenStream* stream, const ANTLR_USE_NAMESPACE(std)string& key); | 
| 54 |  |  |  | 
| 55 |  |  | /// Return the stream from which tokens are being pulled at the moment. | 
| 56 |  |  | TokenStream* getCurrentStream() const; | 
| 57 |  |  |  | 
| 58 |  |  | TokenStream* getStream(const ANTLR_USE_NAMESPACE(std)string& sname) const; | 
| 59 |  |  |  | 
| 60 |  |  | RefToken nextToken(); | 
| 61 |  |  |  | 
| 62 |  |  | TokenStream* pop(); | 
| 63 |  |  |  | 
| 64 |  |  | void push(TokenStream* stream); | 
| 65 |  |  |  | 
| 66 |  |  | void push(const ANTLR_USE_NAMESPACE(std)string& sname); | 
| 67 |  |  |  | 
| 68 |  |  | /** Abort recognition of current Token and try again. | 
| 69 |  |  | *  A stream can push a new stream (for include files | 
| 70 |  |  | *  for example, and then retry(), which will cause | 
| 71 |  |  | *  the current stream to abort back to this.nextToken(). | 
| 72 |  |  | *  this.nextToken() then asks for a token from the | 
| 73 |  |  | *  current stream, which is the new "substream." | 
| 74 |  |  | */ | 
| 75 |  |  | void retry(); | 
| 76 |  |  |  | 
| 77 |  |  | /** Set the stream without pushing old stream */ | 
| 78 |  |  | void select(TokenStream* stream); | 
| 79 |  |  |  | 
| 80 |  |  | void select(const ANTLR_USE_NAMESPACE(std)string& sname); | 
| 81 |  |  | }; | 
| 82 |  |  |  | 
| 83 |  |  | #ifdef ANTLR_CXX_SUPPORTS_NAMESPACE | 
| 84 |  |  | } | 
| 85 |  |  | #endif | 
| 86 |  |  |  | 
| 87 |  |  | #endif //INC_TokenStreamSelector_hpp__ |