15 public errordomain TokenStreamError {
18 public class TokenStream : Object
21 Gee.ArrayList<Token> tokens;
22 int cursor; // where are we in the stream.
25 public TokenStream(Gee.ArrayList<Token> tokens) {
34 public void rewind() {
41 public Token? look (int n, bool considerWhitespace)
45 if (considerWhitespace == true) {
47 if (this.cursor+n < 0 || this.cursor+n > (this.tokens.size -1)) {
48 return new Token("", "VOID", "START_OF_STREAM");
50 return this.tokens.get(this.cursor+n);
59 return new Token("", "VOID", "START_OF_STREAM");
61 if (i > this.tokens.size) {
62 return new Token("", "VOID", "END_OF_STREAM");
65 if (i != this.cursor && this.tokens.get(i).is("WHIT")) {
66 i += (n < 0) ? -1 : 1;
71 return this.tokens.get(i);
74 i += (n < 0) ? -1 : 1;
77 return new Token("", "VOID", "STREAM_ERROR"); // because null isn't an object and caller always expects an object
81 public int lookFor (string data)
84 var i = this.cursor < 0 ? 0 : this.cursor ;
87 if (i >= this.tokens.size) {
90 if (this.tokens.get(i).data == data) {
96 // should not get here!
103 * look ahead (or back) x number of tokens (which are not comment or whitespace)
106 public Token lookTok (int n) {
122 return new Token("", "VOID", "END_OF_STREAM");
124 if (i > this.tokens.size) {
125 return new Token("", "VOID", "END_OF_STREAM");
128 if (i != this.cursor && ( this.tokens.get(i).is("WHIT") || this.tokens.get(i).is("COMM"))) {
129 i += (n < 0) ? -1 : 1;
134 return this.tokens.get(i);
137 i += (n < 0) ? -1 : 1;
139 // should never get here..
140 return new Token("", "VOID", "END_OF_STREAM");; // because null isn't an object and caller always expects an object;
145 * @return {Token|null}
146 * next token (with white space)
150 public Token? next() {
153 //if (typeof howMany == "undefined") howMany = 1;
154 // if (howMany < 1) { return null; }
156 if (this.cursor+1 >= this.tokens.size) {
160 return this.tokens.get(this.cursor);
164 public Gee.ArrayList<Token>? nextM(int howMany) throws TokenStreamError {
166 //if (typeof howMany == "undefined") howMany = 1;
168 throw new TokenStreamError.ArgumentError("nextM called with wrong number : %d", howMany);
170 var got = new Gee.ArrayList<Token>();
172 for (var i = 1; i <= howMany; i++) {
173 if (this.cursor+i >= this.tokens.size) {
176 got.add(this.tokens.get(this.cursor+i));
178 this.cursor += howMany;
186 // what about comments after 'function'...
188 public Token? nextTok() {
189 return this.nextNonSpace();
192 public Token? nextNonSpace ()
196 var tok = this.next();
200 if (tok.is("WHIT") || tok.is("COMM")) {
209 * -- returns all the tokens betweeen and including stop token eg.. from {... to }
210 * @param start {String} token name or data (eg. '{'
211 * @param stop {String} (Optional) token name or data (eg. '}'
213 public Gee.ArrayList<Token> balance (string start, string stop = "") {
215 // accepts names or "{" etc..
217 start = Lang.punc(start) == null ? start : Lang.punc(start);
220 var newstop = Lang.matching(start);
224 throw new JSDOC.TokenStreamError("balance called with invalid start/stop : %s",start);
228 var got = new Gee.ArrayList<Token>();
230 //Seed.print("START:" + start);
231 //Seed.print("STOP:" + stop);
233 while ((token = this.look())) {
234 if (token.is(start)) {
235 // Seed.print("balance: START : " + depth + " " + token.data);
244 if (token.is(stop)) {
246 // Seed.print("balance: STOP: " + depth + " " + token.data);
255 return new Gee.ArrayList<Token>();
258 public Token getMatchingToken(string start, string stop) {
260 var cursor = this.cursor;
263 start = Lang.matching(stop);
266 if (!stop) stop = Lang.matching(start);
268 while ((token = this.tokens[cursor])) {
269 if (token.is(start)) {
273 if (token.is(stop) && cursor) {
275 if (depth == 0) return this.tokens[cursor];
282 public Gee.ArrayList<Token> insertAhead(Token token) {
283 this.tokens.splice(this.cursor+1, 0, token); // fixme...
286 public Gee.ArrayList<Token> remaining() {
287 var ret = new Gee.ArrayList<Token>();
289 var tok = this.look(1,true);
290 if (tok.is("VOID")) {
293 ret.push(this.next(1));
298 arrayToString : function(ar) {
299 console.log(typeof(ar));
301 ar.forEach(function(e) {
306 dump: function(start, end)
308 start = Math.max(start || 0, 0);
309 end = Math.min(end || this.tokens.length, this.tokens.length);
311 for (var i =start;i < end; i++) {
313 out += (this.tokens[i].outData == false) ? this.tokens[i].data : this.tokens[i].outData;