1*1c78a5d6SAndrew Rist /**************************************************************
2cdf0e10cSrcweir  *
3*1c78a5d6SAndrew Rist  * Licensed to the Apache Software Foundation (ASF) under one
4*1c78a5d6SAndrew Rist  * or more contributor license agreements.  See the NOTICE file
5*1c78a5d6SAndrew Rist  * distributed with this work for additional information
6*1c78a5d6SAndrew Rist  * regarding copyright ownership.  The ASF licenses this file
7*1c78a5d6SAndrew Rist  * to you under the Apache License, Version 2.0 (the
8*1c78a5d6SAndrew Rist  * "License"); you may not use this file except in compliance
9*1c78a5d6SAndrew Rist  * with the License.  You may obtain a copy of the License at
10*1c78a5d6SAndrew Rist  *
11*1c78a5d6SAndrew Rist  *   http://www.apache.org/licenses/LICENSE-2.0
12*1c78a5d6SAndrew Rist  *
13*1c78a5d6SAndrew Rist  * Unless required by applicable law or agreed to in writing,
14*1c78a5d6SAndrew Rist  * software distributed under the License is distributed on an
15*1c78a5d6SAndrew Rist  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*1c78a5d6SAndrew Rist  * KIND, either express or implied.  See the License for the
17*1c78a5d6SAndrew Rist  * specific language governing permissions and limitations
18*1c78a5d6SAndrew Rist  * under the License.
19*1c78a5d6SAndrew Rist  *
20*1c78a5d6SAndrew Rist  *************************************************************/
21*1c78a5d6SAndrew Rist 
22*1c78a5d6SAndrew Rist 
23cdf0e10cSrcweir 
24cdf0e10cSrcweir #ifndef ADC_TKP2_HXX
25cdf0e10cSrcweir #define ADC_TKP2_HXX
26cdf0e10cSrcweir 
27cdf0e10cSrcweir // USED SERVICES
28cdf0e10cSrcweir 	// BASE CLASSES
29cdf0e10cSrcweir 	// COMPONENTS
30cdf0e10cSrcweir class CharacterSource;
31cdf0e10cSrcweir class TkpContext;
32cdf0e10cSrcweir 	// PARAMETRS
33cdf0e10cSrcweir 
34cdf0e10cSrcweir 
35cdf0e10cSrcweir 
36cdf0e10cSrcweir /** This is the interface for parser classes, which get a sequence of Token s from
37cdf0e10cSrcweir 	a text.
38cdf0e10cSrcweir 
39cdf0e10cSrcweir 	Start() starts to parse the text from the given i_rSource.
40cdf0e10cSrcweir 	GetNextToken() returns a Token on the heap as long as there are
41cdf0e10cSrcweir 	still characters in the text left. The last time GetNextToken()
42cdf0e10cSrcweir 	returns NULL.
43cdf0e10cSrcweir 
44cdf0e10cSrcweir 	The algorithms for parsing tokens from the text are an issue of
45cdf0e10cSrcweir 	the derived classes.
46cdf0e10cSrcweir */
47cdf0e10cSrcweir class TokenParse2
48cdf0e10cSrcweir {
49cdf0e10cSrcweir   public:
50cdf0e10cSrcweir 	// LIFECYCLE
51cdf0e10cSrcweir 						TokenParse2();
52cdf0e10cSrcweir 	virtual				~TokenParse2() {}
53cdf0e10cSrcweir 
54cdf0e10cSrcweir 	// OPERATIONS
55cdf0e10cSrcweir 	virtual void   		Start(
56cdf0e10cSrcweir 							CharacterSource &
57cdf0e10cSrcweir 											i_rSource );
58cdf0e10cSrcweir 
59cdf0e10cSrcweir 	/** @short	Gets the next identifiable token out of the
60cdf0e10cSrcweir 		source code.
61cdf0e10cSrcweir 		@return true, if there was passed a valid token.
62cdf0e10cSrcweir 				false, if the parsed stream is finished or
63cdf0e10cSrcweir                 	   an error occured.
64cdf0e10cSrcweir 	*/
65cdf0e10cSrcweir 	bool				GetNextToken();
66cdf0e10cSrcweir 
67cdf0e10cSrcweir   private:
68cdf0e10cSrcweir 	virtual void		SetStartContext() = 0;
69cdf0e10cSrcweir 	virtual void        SetCurrentContext(
70cdf0e10cSrcweir 							TkpContext &		io_rContext ) = 0;
71cdf0e10cSrcweir 	virtual TkpContext &
72cdf0e10cSrcweir 						CurrentContext() = 0;
73cdf0e10cSrcweir 	// DATA
74cdf0e10cSrcweir 	CharacterSource *	pChars;
75cdf0e10cSrcweir };
76cdf0e10cSrcweir 
77cdf0e10cSrcweir 
78cdf0e10cSrcweir #endif
79cdf0e10cSrcweir 
80cdf0e10cSrcweir 
81