1 //<script type="text/javscript">
3 imports['Object.js'].load(Object);
5 JSDOC = imports['JSDOC.js'].JSDOC;
6 console = imports['console.js'].console;
7 Token = imports['JSDOC/Token.js'].Token;
8 Lang = imports['JSDOC/Lang.js'].Lang;
14 TokenStream = Object.define(
18 this.tokens = (tokens || []);
19 // Seed.print(this.tokens.length);
24 cursor : -1, // where are we in the stream.
33 look : function(/**Number*/n, /**Boolean*/considerWhitespace) {
34 if (typeof n == "undefined") n = 0;
36 if (considerWhitespace == true) {
37 if (this.cursor+n < 0 || this.cursor+n > this.tokens.length) return {};
38 return this.tokens[this.cursor+n];
45 if (i < 0) return new Token("", "VOID", "START_OF_STREAM");
46 else if (i > this.tokens.length) return new Token("", "VOID", "END_OF_STREAM");
48 if (i != this.cursor && (this.tokens[i] === undefined || this.tokens[i].is("WHIT"))) {
49 if (n < 0) i--; else i++;
53 if (count == Math.abs(n)) {
54 return this.tokens[i];
60 return new Token("", "VOID", "STREAM_ERROR"); // because null isn't an object and caller always expects an object
64 lookFor : function (data)
67 var i = this.cursor < 0 ? 0 : this.cursor ;
70 if (i >= this.tokens.length) return -1;
71 if (this.tokens[i].data == data) {
77 // should not get here!
84 * look ahead (or back) x number of tokens (which are not comment or whitespace)
87 lookTok : function(/**Number*/n) {
88 if (typeof n == "undefined") n = 1;
100 else if (i > this.tokens.length) return false;
102 if (i != this.cursor && (this.tokens[i] === undefined || this.tokens[i].is("WHIT") || this.tokens[i].is("COMM"))) {
103 if (n < 0) i--; else i++;
107 if (count == Math.abs(n)) {
108 return this.tokens[i];
114 return false; // because null isn't an object and caller always expects an object;
119 @type JSDOC.Token|JSDOC.Token[]| null!
121 next : function(/**Number*/howMany) {
122 if (typeof howMany == "undefined") howMany = 1;
123 if (howMany < 1) return null;
126 for (var i = 1; i <= howMany; i++) {
127 if (this.cursor+i >= this.tokens.length) {
130 got.push(this.tokens[this.cursor+i]);
132 this.cursor += howMany;
139 // what about comments after 'function'...
141 nextTok : function() {
142 return this.nextNonSpace();
144 nextNonSpace : function ()
152 if (tok.is('WHIT') || tok.is('COMM')) {
159 * @type JSDOC.Token[]
160 * @param start {String} token name or data (eg. '{'
161 * @param stop {String} (Optional) token name or data (eg. '}'
163 balance : function(/**String*/start, /**String*/stop) {
165 start = typeof(Lang.matching(start)) == 'undefined' ? Lang.punc(start) : start;
167 if (!stop) stop = Lang.matching(start);
172 //Seed.print("STOP:" + stop);
173 while ((token = this.look())) {
174 if (token.is(start)) {
183 if (token.is(stop)) {
185 if (depth == 0) return got;
187 if (!this.next()) break;
191 getMatchingToken : function(/**String*/start, /**String*/stop) {
193 var cursor = this.cursor;
196 start = Lang.matching(stop);
199 if (!stop) stop = Lang.matching(start);
201 while ((token = this.tokens[cursor])) {
202 if (token.is(start)) {
206 if (token.is(stop) && cursor) {
208 if (depth == 0) return this.tokens[cursor];
214 insertAhead : function(/**JSDOC.Token*/token) {
215 this.tokens.splice(this.cursor+1, 0, token);
218 remaining : function() {
221 var tok = this.look(1,true);
222 if (!tok || !tok.is || tok.is('VOID')) {
225 ret.push(this.next(1));
230 arrayToString : function(ar) {
231 console.log(typeof(ar));
233 ar.forEach(function(e) {
240 this.tokens.forEach(function(t) {