2 // cs-tokenizer.cs: The Tokenizer for the C# compiler
3 // This also implements the preprocessor
5 // Author: Miguel de Icaza (miguel@gnu.org)
6 // Marek Safar (marek.safar@seznam.cz)
8 // Dual licensed under the terms of the MIT X11 or GNU GPL
10 // Copyright 2001, 2002 Ximian, Inc (http://www.ximian.com)
11 // Copyright 2004-2008 Novell, Inc
17 using System.Collections.Generic;
18 using System.Globalization;
19 using System.Diagnostics;
24 /// Tokenizer for C# source code.
27 public class Tokenizer : yyParser.yyInput
31 public readonly T Token;
32 public KeywordEntry<T> Next;
33 public readonly char[] Value;
35 public KeywordEntry (string value, T token)
37 this.Value = value.ToCharArray ();
42 sealed class IdentifiersComparer : IEqualityComparer<char[]>
46 public IdentifiersComparer (int length)
51 public bool Equals (char[] x, char[] y)
53 for (int i = 0; i < length; ++i)
60 public int GetHashCode (char[] obj)
63 for (int i = 0; i < length; ++i)
64 h = (h << 5) - h + obj [i];
71 // This class has to be used in the parser only, it reuses token
72 // details after each parse
74 public class LocatedToken
79 static LocatedToken[] buffer;
82 private LocatedToken ()
86 public static LocatedToken Create (int row, int column)
88 return Create (null, row, column);
91 public static LocatedToken Create (string value, int row, int column)
94 // TODO: I am not very happy about the logic but it's the best
95 // what I could come up with for now.
96 // Ideally we should be using just tiny buffer (256 elements) which
97 // is enough to hold all details for currect stack and recycle elements
98 // poped from the stack but there is a trick needed to recycle
102 if (pos >= buffer.Length) {
103 entry = new LocatedToken ();
105 entry = buffer [pos];
107 entry = new LocatedToken ();
108 buffer [pos] = entry;
115 entry.column = column;
120 // Used for token not required by expression evaluator
122 [Conditional ("FULL_AST")]
123 public static void CreateOptional (int row, int col, ref object token)
125 token = Create (row, col);
128 public static void Initialize ()
131 buffer = new LocatedToken [10000];
135 public Location Location {
136 get { return new Location (row, column); }
139 public string Value {
140 get { return value; }
144 enum PreprocessorDirective
150 If = 3 | RequiresArgument,
152 Elif = 5 | RequiresArgument,
154 Define = 7 | RequiresArgument,
155 Undef = 8 | RequiresArgument,
158 Pragma = 11 | CustomArgumentsParsing,
161 CustomArgumentsParsing = 1 << 10,
162 RequiresArgument = 1 << 11
165 SeekableStreamReader reader;
167 CompilationSourceFile file_name;
168 CompilerContext context;
176 bool handle_get_set = false;
177 bool handle_remove_add = false;
178 bool handle_where = false;
179 bool handle_typeof = false;
180 bool lambda_arguments_parsing;
181 List<Location> escaped_identifiers;
182 int parsing_generic_less_than;
183 readonly bool doc_processing;
186 // Used mainly for parser optimizations. Some expressions for instance
187 // can appear only in block (including initializer, base initializer)
190 public int parsing_block;
191 internal bool query_parsing;
194 // When parsing type only, useful for ambiguous nullable types
196 public int parsing_type;
199 // Set when parsing generic declaration (type or method header)
201 public bool parsing_generic_declaration;
202 public bool parsing_generic_declaration_doc;
205 // The value indicates that we have not reach any declaration or
208 public int parsing_declaration;
210 public bool parsing_attribute_section;
213 // The special characters to inject on streams to run the unit parser
214 // in the special expression mode. Using private characters from
215 // Plane Sixteen (U+100000 to U+10FFFD)
217 // This character is only tested just before the tokenizer is about to report
218 // an error; So on the regular operation mode, this addition will have no
219 // impact on the tokenizer's performance.
222 public const int EvalStatementParserCharacter = 0x100000;
223 public const int EvalCompilationUnitParserCharacter = 0x100001;
224 public const int EvalUsingDeclarationsParserCharacter = 0x100002;
225 public const int DocumentationXref = 0x100003;
228 // XML documentation buffer. The save point is used to divide
229 // comments on types and comments on members.
231 StringBuilder xml_comment_buffer;
234 // See comment on XmlCommentState enumeration.
236 XmlCommentState xml_doc_state = XmlCommentState.Allowed;
239 // Whether tokens have been seen on this line
241 bool tokens_seen = false;
244 // Set to true once the GENERATE_COMPLETION token has bee
245 // returned. This helps produce one GENERATE_COMPLETION,
246 // as many COMPLETE_COMPLETION as necessary to complete the
247 // AST tree and one final EOF.
252 // Whether a token has been seen on the file
253 // This is needed because `define' is not allowed to be used
254 // after a token has been seen.
261 static readonly KeywordEntry<int>[][] keywords;
262 static readonly KeywordEntry<PreprocessorDirective>[][] keywords_preprocessor;
263 static readonly Dictionary<string, object> keyword_strings; // TODO: HashSet
264 static readonly NumberStyles styles;
265 static readonly NumberFormatInfo csharp_format_info;
268 static readonly char[] pragma_warning = "warning".ToCharArray ();
269 static readonly char[] pragma_warning_disable = "disable".ToCharArray ();
270 static readonly char[] pragma_warning_restore = "restore".ToCharArray ();
271 static readonly char[] pragma_checksum = "checksum".ToCharArray ();
273 static readonly char[] simple_whitespaces = new char[] { ' ', '\t' };
275 public bool PropertyParsing {
276 get { return handle_get_set; }
277 set { handle_get_set = value; }
280 public bool EventParsing {
281 get { return handle_remove_add; }
282 set { handle_remove_add = value; }
285 public bool ConstraintsParsing {
286 get { return handle_where; }
287 set { handle_where = value; }
290 public bool TypeOfParsing {
291 get { return handle_typeof; }
292 set { handle_typeof = value; }
296 get { return tab_size; }
297 set { tab_size = value; }
300 public XmlCommentState doc_state {
301 get { return xml_doc_state; }
303 if (value == XmlCommentState.Allowed) {
304 check_incorrect_doc_comment ();
305 reset_doc_comment ();
307 xml_doc_state = value;
312 // This is used to trigger completion generation on the parser
313 public bool CompleteOnEOF;
315 void AddEscapedIdentifier (Location loc)
317 if (escaped_identifiers == null)
318 escaped_identifiers = new List<Location> ();
320 escaped_identifiers.Add (loc);
323 public bool IsEscapedIdentifier (MemberName name)
325 return escaped_identifiers != null && escaped_identifiers.Contains (name.Location);
329 // Values for the associated token returned
331 internal int putback_char; // Used by repl only
337 const int TAKING = 1;
338 const int ELSE_SEEN = 4;
339 const int PARENT_TAKING = 8;
340 const int REGION = 16;
343 // pre-processor if stack state:
347 static System.Text.StringBuilder string_builder;
349 const int max_id_size = 512;
350 static readonly char [] id_builder = new char [max_id_size];
352 public static Dictionary<char[], string>[] identifiers = new Dictionary<char[], string>[max_id_size + 1];
354 const int max_number_size = 512;
355 static char [] number_builder = new char [max_number_size];
356 static int number_pos;
358 static char[] value_builder = new char[256];
367 // This is used when the tokenizer needs to save
368 // the current position as it needs to do some parsing
369 // on its own to deamiguate a token in behalf of the
372 Stack<Position> position_stack = new Stack<Position> (2);
380 public int putback_char;
381 public int previous_col;
382 public Stack<int> ifstack;
383 public int parsing_generic_less_than;
384 public int current_token;
387 public Position (Tokenizer t)
389 position = t.reader.Position;
391 ref_line = t.ref_line;
394 putback_char = t.putback_char;
395 previous_col = t.previous_col;
396 if (t.ifstack != null && t.ifstack.Count != 0) {
397 // There is no simple way to clone Stack<T> all
398 // methods reverse the order
399 var clone = t.ifstack.ToArray ();
400 Array.Reverse (clone);
401 ifstack = new Stack<int> (clone);
403 parsing_generic_less_than = t.parsing_generic_less_than;
404 current_token = t.current_token;
409 public Tokenizer (SeekableStreamReader input, CompilationSourceFile file, CompilerContext ctx)
411 this.ref_name = file;
412 this.file_name = file;
418 xml_comment_buffer = new StringBuilder ();
419 doc_processing = ctx.Settings.DocumentationFile != null;
421 if (Environment.OSVersion.Platform == PlatformID.Win32NT)
427 // FIXME: This could be `Location.Push' but we have to
428 // find out why the MS compiler allows this
430 Mono.CSharp.Location.Push (file, file);
433 public void PushPosition ()
435 position_stack.Push (new Position (this));
438 public void PopPosition ()
440 Position p = position_stack.Pop ();
442 reader.Position = p.position;
443 ref_line = p.ref_line;
447 putback_char = p.putback_char;
448 previous_col = p.previous_col;
450 parsing_generic_less_than = p.parsing_generic_less_than;
451 current_token = p.current_token;
455 // Do not reset the position, ignore it.
456 public void DiscardPosition ()
458 position_stack.Pop ();
461 static void AddKeyword (string kw, int token)
463 keyword_strings.Add (kw, null);
465 AddKeyword (keywords, kw, token);
468 static void AddPreprocessorKeyword (string kw, PreprocessorDirective directive)
470 AddKeyword (keywords_preprocessor, kw, directive);
473 static void AddKeyword<T> (KeywordEntry<T>[][] keywords, string kw, T token)
475 int length = kw.Length;
476 if (keywords[length] == null) {
477 keywords[length] = new KeywordEntry<T>['z' - '_' + 1];
480 int char_index = kw[0] - '_';
481 var kwe = keywords[length][char_index];
483 keywords[length][char_index] = new KeywordEntry<T> (kw, token);
487 while (kwe.Next != null) {
491 kwe.Next = new KeywordEntry<T> (kw, token);
499 keyword_strings = new Dictionary<string, object> ();
501 // 11 is the length of the longest keyword for now
502 keywords = new KeywordEntry<int>[11][];
504 AddKeyword ("__arglist", Token.ARGLIST);
505 AddKeyword ("__makeref", Token.MAKEREF);
506 AddKeyword ("__reftype", Token.REFTYPE);
507 AddKeyword ("__refvalue", Token.REFVALUE);
508 AddKeyword ("abstract", Token.ABSTRACT);
509 AddKeyword ("as", Token.AS);
510 AddKeyword ("add", Token.ADD);
511 AddKeyword ("base", Token.BASE);
512 AddKeyword ("bool", Token.BOOL);
513 AddKeyword ("break", Token.BREAK);
514 AddKeyword ("byte", Token.BYTE);
515 AddKeyword ("case", Token.CASE);
516 AddKeyword ("catch", Token.CATCH);
517 AddKeyword ("char", Token.CHAR);
518 AddKeyword ("checked", Token.CHECKED);
519 AddKeyword ("class", Token.CLASS);
520 AddKeyword ("const", Token.CONST);
521 AddKeyword ("continue", Token.CONTINUE);
522 AddKeyword ("decimal", Token.DECIMAL);
523 AddKeyword ("default", Token.DEFAULT);
524 AddKeyword ("delegate", Token.DELEGATE);
525 AddKeyword ("do", Token.DO);
526 AddKeyword ("double", Token.DOUBLE);
527 AddKeyword ("else", Token.ELSE);
528 AddKeyword ("enum", Token.ENUM);
529 AddKeyword ("event", Token.EVENT);
530 AddKeyword ("explicit", Token.EXPLICIT);
531 AddKeyword ("extern", Token.EXTERN);
532 AddKeyword ("false", Token.FALSE);
533 AddKeyword ("finally", Token.FINALLY);
534 AddKeyword ("fixed", Token.FIXED);
535 AddKeyword ("float", Token.FLOAT);
536 AddKeyword ("for", Token.FOR);
537 AddKeyword ("foreach", Token.FOREACH);
538 AddKeyword ("goto", Token.GOTO);
539 AddKeyword ("get", Token.GET);
540 AddKeyword ("if", Token.IF);
541 AddKeyword ("implicit", Token.IMPLICIT);
542 AddKeyword ("in", Token.IN);
543 AddKeyword ("int", Token.INT);
544 AddKeyword ("interface", Token.INTERFACE);
545 AddKeyword ("internal", Token.INTERNAL);
546 AddKeyword ("is", Token.IS);
547 AddKeyword ("lock", Token.LOCK);
548 AddKeyword ("long", Token.LONG);
549 AddKeyword ("namespace", Token.NAMESPACE);
550 AddKeyword ("new", Token.NEW);
551 AddKeyword ("null", Token.NULL);
552 AddKeyword ("object", Token.OBJECT);
553 AddKeyword ("operator", Token.OPERATOR);
554 AddKeyword ("out", Token.OUT);
555 AddKeyword ("override", Token.OVERRIDE);
556 AddKeyword ("params", Token.PARAMS);
557 AddKeyword ("private", Token.PRIVATE);
558 AddKeyword ("protected", Token.PROTECTED);
559 AddKeyword ("public", Token.PUBLIC);
560 AddKeyword ("readonly", Token.READONLY);
561 AddKeyword ("ref", Token.REF);
562 AddKeyword ("remove", Token.REMOVE);
563 AddKeyword ("return", Token.RETURN);
564 AddKeyword ("sbyte", Token.SBYTE);
565 AddKeyword ("sealed", Token.SEALED);
566 AddKeyword ("set", Token.SET);
567 AddKeyword ("short", Token.SHORT);
568 AddKeyword ("sizeof", Token.SIZEOF);
569 AddKeyword ("stackalloc", Token.STACKALLOC);
570 AddKeyword ("static", Token.STATIC);
571 AddKeyword ("string", Token.STRING);
572 AddKeyword ("struct", Token.STRUCT);
573 AddKeyword ("switch", Token.SWITCH);
574 AddKeyword ("this", Token.THIS);
575 AddKeyword ("throw", Token.THROW);
576 AddKeyword ("true", Token.TRUE);
577 AddKeyword ("try", Token.TRY);
578 AddKeyword ("typeof", Token.TYPEOF);
579 AddKeyword ("uint", Token.UINT);
580 AddKeyword ("ulong", Token.ULONG);
581 AddKeyword ("unchecked", Token.UNCHECKED);
582 AddKeyword ("unsafe", Token.UNSAFE);
583 AddKeyword ("ushort", Token.USHORT);
584 AddKeyword ("using", Token.USING);
585 AddKeyword ("virtual", Token.VIRTUAL);
586 AddKeyword ("void", Token.VOID);
587 AddKeyword ("volatile", Token.VOLATILE);
588 AddKeyword ("while", Token.WHILE);
589 AddKeyword ("partial", Token.PARTIAL);
590 AddKeyword ("where", Token.WHERE);
593 AddKeyword ("from", Token.FROM);
594 AddKeyword ("join", Token.JOIN);
595 AddKeyword ("on", Token.ON);
596 AddKeyword ("equals", Token.EQUALS);
597 AddKeyword ("select", Token.SELECT);
598 AddKeyword ("group", Token.GROUP);
599 AddKeyword ("by", Token.BY);
600 AddKeyword ("let", Token.LET);
601 AddKeyword ("orderby", Token.ORDERBY);
602 AddKeyword ("ascending", Token.ASCENDING);
603 AddKeyword ("descending", Token.DESCENDING);
604 AddKeyword ("into", Token.INTO);
606 // Contextual async keywords
607 AddKeyword ("async", Token.ASYNC);
608 AddKeyword ("await", Token.AWAIT);
610 keywords_preprocessor = new KeywordEntry<PreprocessorDirective>[10][];
612 AddPreprocessorKeyword ("region", PreprocessorDirective.Region);
613 AddPreprocessorKeyword ("endregion", PreprocessorDirective.Endregion);
614 AddPreprocessorKeyword ("if", PreprocessorDirective.If);
615 AddPreprocessorKeyword ("endif", PreprocessorDirective.Endif);
616 AddPreprocessorKeyword ("elif", PreprocessorDirective.Elif);
617 AddPreprocessorKeyword ("else", PreprocessorDirective.Else);
618 AddPreprocessorKeyword ("define", PreprocessorDirective.Define);
619 AddPreprocessorKeyword ("undef", PreprocessorDirective.Undef);
620 AddPreprocessorKeyword ("error", PreprocessorDirective.Error);
621 AddPreprocessorKeyword ("warning", PreprocessorDirective.Warning);
622 AddPreprocessorKeyword ("pragma", PreprocessorDirective.Pragma);
623 AddPreprocessorKeyword ("line", PreprocessorDirective.Line);
625 csharp_format_info = NumberFormatInfo.InvariantInfo;
626 styles = NumberStyles.Float;
628 string_builder = new System.Text.StringBuilder ();
631 int GetKeyword (char[] id, int id_len)
634 // Keywords are stored in an array of arrays grouped by their
635 // length and then by the first character
637 if (id_len >= keywords.Length || keywords [id_len] == null)
640 int first_index = id [0] - '_';
641 if (first_index > 'z' - '_')
644 var kwe = keywords [id_len] [first_index];
651 for (int i = 1; i < id_len; ++i) {
652 if (id [i] != kwe.Value [i]) {
658 } while (res == 0 && kwe != null);
672 if (!handle_remove_add)
676 if (parsing_declaration == 0)
677 res = Token.EXTERN_ALIAS;
680 if (peek_token () == Token.COLON) {
682 res = Token.DEFAULT_COLON;
686 if (!handle_where && !query_parsing)
691 // A query expression is any expression that starts with `from identifier'
692 // followed by any token except ; , =
694 if (!query_parsing) {
695 if (lambda_arguments_parsing) {
701 // HACK: to disable generics micro-parser, because PushPosition does not
702 // store identifiers array
703 parsing_generic_less_than = 1;
705 case Token.IDENTIFIER:
717 next_token = xtoken ();
718 if (next_token == Token.SEMICOLON || next_token == Token.COMMA || next_token == Token.EQUALS)
721 res = Token.FROM_FIRST;
722 query_parsing = true;
723 if (context.Settings.Version <= LanguageVersion.ISO_2)
724 Report.FeatureIsNotAvailable (context, Location, "query expressions");
727 Expression.Error_VoidInvalidInTheContext (Location, Report);
731 // HACK: A token is not a keyword so we need to restore identifiers buffer
732 // which has been overwritten before we grabbed the identifier
733 id_builder [0] = 'f'; id_builder [1] = 'r'; id_builder [2] = 'o'; id_builder [3] = 'm';
747 case Token.ASCENDING:
748 case Token.DESCENDING:
755 case Token.NAMESPACE:
756 // TODO: some explanation needed
757 check_incorrect_doc_comment ();
761 if (parsing_block > 0) {
766 // Save current position and parse next token.
769 next_token = token ();
770 bool ok = (next_token == Token.CLASS) ||
771 (next_token == Token.STRUCT) ||
772 (next_token == Token.INTERFACE) ||
773 (next_token == Token.VOID);
778 if (next_token == Token.VOID) {
779 if (context.Settings.Version <= LanguageVersion.ISO_2)
780 Report.FeatureIsNotAvailable (context, Location, "partial methods");
781 } else if (context.Settings.Version == LanguageVersion.ISO_1)
782 Report.FeatureIsNotAvailable (context, Location, "partial types");
787 if (next_token < Token.LAST_KEYWORD) {
788 Report.Error (267, Location,
789 "The `partial' modifier can be used only immediately before `class', `struct', `interface', or `void' keyword");
796 // TODO: async, it's modifiers context only
798 if (parsing_block > 0 || context.Settings.Version != LanguageVersion.Future) {
803 // TODO: async, it's async block context only
805 if (context.Settings.Version != LanguageVersion.Future) {
816 static PreprocessorDirective GetPreprocessorDirective (char[] id, int id_len)
819 // Keywords are stored in an array of arrays grouped by their
820 // length and then by the first character
822 if (id_len >= keywords_preprocessor.Length || keywords_preprocessor[id_len] == null)
823 return PreprocessorDirective.Invalid;
825 int first_index = id[0] - '_';
826 if (first_index > 'z' - '_')
827 return PreprocessorDirective.Invalid;
829 var kwe = keywords_preprocessor[id_len][first_index];
831 return PreprocessorDirective.Invalid;
833 PreprocessorDirective res = PreprocessorDirective.Invalid;
836 for (int i = 1; i < id_len; ++i) {
837 if (id[i] != kwe.Value[i]) {
843 } while (res == PreprocessorDirective.Invalid && kwe != null);
848 public Location Location {
850 return new Location (ref_line, hidden ? -1 : col);
854 static bool is_identifier_start_character (int c)
856 return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c == '_' || Char.IsLetter ((char)c);
859 static bool is_identifier_part_character (char c)
861 if (c >= 'a' && c <= 'z')
864 if (c >= 'A' && c <= 'Z')
867 if (c == '_' || (c >= '0' && c <= '9'))
873 return Char.IsLetter (c) || Char.GetUnicodeCategory (c) == UnicodeCategory.ConnectorPunctuation;
876 public static bool IsKeyword (string s)
878 return keyword_strings.ContainsKey (s);
882 // Open parens micro parser. Detects both lambda and cast ambiguity.
884 int TokenizeOpenParens ()
889 int bracket_level = 0;
890 bool is_type = false;
891 bool can_be_type = false;
894 ptoken = current_token;
897 switch (current_token) {
898 case Token.CLOSE_PARENS:
902 // Expression inside parens is lambda, (int i) =>
904 if (current_token == Token.ARROW)
905 return Token.OPEN_PARENS_LAMBDA;
908 // Expression inside parens is single type, (int[])
911 return Token.OPEN_PARENS_CAST;
914 // Expression is possible cast, look at next token, (T)null
917 switch (current_token) {
918 case Token.OPEN_PARENS:
921 case Token.IDENTIFIER:
935 case Token.UNCHECKED:
940 // These can be part of a member access
954 return Token.OPEN_PARENS_CAST;
957 return Token.OPEN_PARENS;
960 case Token.DOUBLE_COLON:
961 if (ptoken != Token.IDENTIFIER && ptoken != Token.OP_GENERICS_GT)
966 case Token.IDENTIFIER:
969 if (bracket_level == 0) {
975 case Token.OP_GENERICS_LT:
977 case Token.DOUBLE_COLON:
979 if (bracket_level == 0)
983 can_be_type = is_type = false;
1003 if (bracket_level == 0)
1008 if (bracket_level == 0) {
1009 bracket_level = 100;
1010 can_be_type = is_type = false;
1014 case Token.OP_GENERICS_LT:
1015 case Token.OPEN_BRACKET:
1016 if (bracket_level++ == 0)
1020 case Token.OP_GENERICS_GT:
1021 case Token.CLOSE_BRACKET:
1025 case Token.INTERR_NULLABLE:
1027 if (bracket_level == 0)
1033 can_be_type = is_type = false;
1037 return Token.OPEN_PARENS;
1042 public static bool IsValidIdentifier (string s)
1044 if (s == null || s.Length == 0)
1047 if (!is_identifier_start_character (s [0]))
1050 for (int i = 1; i < s.Length; i ++)
1051 if (! is_identifier_part_character (s [i]))
1057 bool parse_less_than ()
1060 int the_token = token ();
1061 if (the_token == Token.OPEN_BRACKET) {
1063 the_token = token ();
1064 } while (the_token != Token.CLOSE_BRACKET);
1065 the_token = token ();
1066 } else if (the_token == Token.IN || the_token == Token.OUT) {
1067 the_token = token ();
1069 switch (the_token) {
1070 case Token.IDENTIFIER:
1088 case Token.OP_GENERICS_GT:
1095 the_token = token ();
1097 if (the_token == Token.OP_GENERICS_GT)
1099 else if (the_token == Token.COMMA || the_token == Token.DOT || the_token == Token.DOUBLE_COLON)
1101 else if (the_token == Token.INTERR_NULLABLE || the_token == Token.STAR)
1103 else if (the_token == Token.OP_GENERICS_LT) {
1104 if (!parse_less_than ())
1107 } else if (the_token == Token.OPEN_BRACKET) {
1109 the_token = token ();
1110 if (the_token == Token.CLOSE_BRACKET)
1112 else if (the_token == Token.COMMA)
1113 goto rank_specifiers;
1120 bool parse_generic_dimension (out int dimension)
1125 int the_token = token ();
1126 if (the_token == Token.OP_GENERICS_GT)
1128 else if (the_token == Token.COMMA) {
1136 public int peek_token ()
1141 the_token = token ();
1148 // Tonizes `?' using custom disambiguous rules to return one
1149 // of following tokens: INTERR_NULLABLE, OP_COALESCING, INTERR
1151 // Tricky expression look like:
1153 // Foo ? a = x ? b : c;
1155 int TokenizePossibleNullableType ()
1157 if (parsing_block == 0 || parsing_type > 0)
1158 return Token.INTERR_NULLABLE;
1160 int d = peek_char ();
1163 return Token.OP_COALESCING;
1166 switch (current_token) {
1167 case Token.CLOSE_PARENS:
1172 return Token.INTERR;
1176 if (d == ',' || d == ';' || d == '>')
1177 return Token.INTERR_NULLABLE;
1178 if (d == '*' || (d >= '0' && d <= '9'))
1179 return Token.INTERR;
1183 current_token = Token.NONE;
1185 switch (xtoken ()) {
1192 next_token = Token.INTERR;
1195 case Token.SEMICOLON:
1197 case Token.CLOSE_PARENS:
1198 case Token.OPEN_BRACKET:
1199 case Token.OP_GENERICS_GT:
1201 next_token = Token.INTERR_NULLABLE;
1209 if (next_token == -1) {
1210 switch (xtoken ()) {
1212 case Token.SEMICOLON:
1213 case Token.OPEN_BRACE:
1214 case Token.CLOSE_PARENS:
1216 next_token = Token.INTERR_NULLABLE;
1220 next_token = Token.INTERR;
1228 // All shorcuts failed, do it hard way
1230 while ((ntoken = xtoken ()) != Token.EOF) {
1231 if (ntoken == Token.SEMICOLON)
1234 if (ntoken == Token.COLON) {
1235 if (++colons == interrs)
1240 if (ntoken == Token.INTERR) {
1246 next_token = colons != interrs ? Token.INTERR_NULLABLE : Token.INTERR;
1255 bool decimal_digits (int c)
1258 bool seen_digits = false;
1261 if (number_pos == max_number_size)
1262 Error_NumericConstantTooLong ();
1263 number_builder [number_pos++] = (char) c;
1267 // We use peek_char2, because decimal_digits needs to do a
1268 // 2-character look-ahead (5.ToString for example).
1270 while ((d = peek_char2 ()) != -1){
1271 if (d >= '0' && d <= '9'){
1272 if (number_pos == max_number_size)
1273 Error_NumericConstantTooLong ();
1274 number_builder [number_pos++] = (char) d;
1284 static bool is_hex (int e)
1286 return (e >= '0' && e <= '9') || (e >= 'A' && e <= 'F') || (e >= 'a' && e <= 'f');
1289 static TypeCode real_type_suffix (int c)
1293 return TypeCode.Single;
1295 return TypeCode.Double;
1297 return TypeCode.Decimal;
1299 return TypeCode.Empty;
1303 ILiteralConstant integer_type_suffix (ulong ul, int c, Location loc)
1305 bool is_unsigned = false;
1306 bool is_long = false;
1309 bool scanning = true;
1322 // if we have not seen anything in between
1323 // report this error
1325 Report.Warning (78, 4, Location, "The 'l' suffix is easily confused with the digit '1' (use 'L' for clarity)");
1345 if (is_long && is_unsigned){
1346 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1350 // uint if possible, or ulong else.
1352 if ((ul & 0xffffffff00000000) == 0)
1353 return new UIntLiteral (context.BuiltinTypes, (uint) ul, loc);
1355 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1356 } else if (is_long){
1357 // long if possible, ulong otherwise
1358 if ((ul & 0x8000000000000000) != 0)
1359 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1361 return new LongLiteral (context.BuiltinTypes, (long) ul, loc);
1363 // int, uint, long or ulong in that order
1364 if ((ul & 0xffffffff00000000) == 0){
1365 uint ui = (uint) ul;
1367 if ((ui & 0x80000000) != 0)
1368 return new UIntLiteral (context.BuiltinTypes, ui, loc);
1370 return new IntLiteral (context.BuiltinTypes, (int) ui, loc);
1372 if ((ul & 0x8000000000000000) != 0)
1373 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1375 return new LongLiteral (context.BuiltinTypes, (long) ul, loc);
1381 // given `c' as the next char in the input decide whether
1382 // we need to convert to a special type, and then choose
1383 // the best representation for the integer
1385 int adjust_int (int c, Location loc)
1387 ILiteralConstant res;
1389 if (number_pos > 9){
1390 ulong ul = (uint) (number_builder [0] - '0');
1392 for (int i = 1; i < number_pos; i++){
1393 ul = checked ((ul * 10) + ((uint)(number_builder [i] - '0')));
1395 res = integer_type_suffix (ul, c, loc);
1397 uint ui = (uint) (number_builder [0] - '0');
1399 for (int i = 1; i < number_pos; i++){
1400 ui = checked ((ui * 10) + ((uint)(number_builder [i] - '0')));
1402 res = integer_type_suffix (ui, c, loc);
1404 } catch (OverflowException) {
1405 Error_NumericConstantTooLong ();
1406 res = new IntLiteral (context.BuiltinTypes, 0, loc);
1408 catch (FormatException) {
1409 Report.Error (1013, Location, "Invalid number");
1410 res = new IntLiteral (context.BuiltinTypes, 0, loc);
1415 res.ParsedValue = new char[number_pos];
1416 Array.Copy (number_builder, res.ParsedValue, number_pos);
1418 return Token.LITERAL;
1421 ILiteralConstant adjust_real (TypeCode t, Location loc)
1423 string s = new string (number_builder, 0, number_pos);
1424 const string error_details = "Floating-point constant is outside the range of type `{0}'";
1427 case TypeCode.Decimal:
1429 return new DecimalLiteral (context.BuiltinTypes, decimal.Parse (s, styles, csharp_format_info), loc);
1430 } catch (OverflowException) {
1431 Report.Error (594, Location, error_details, "decimal");
1432 return new DecimalLiteral (context.BuiltinTypes, 0, loc);
1434 case TypeCode.Single:
1436 return new FloatLiteral (context.BuiltinTypes, float.Parse (s, styles, csharp_format_info), loc);
1437 } catch (OverflowException) {
1438 Report.Error (594, Location, error_details, "float");
1439 return new FloatLiteral (context.BuiltinTypes, 0, loc);
1443 return new DoubleLiteral (context.BuiltinTypes, double.Parse (s, styles, csharp_format_info), loc);
1444 } catch (OverflowException) {
1445 Report.Error (594, loc, error_details, "double");
1446 return new DoubleLiteral (context.BuiltinTypes, 0, loc);
1451 ILiteralConstant handle_hex (Location loc)
1457 while ((d = peek_char ()) != -1){
1459 number_builder [number_pos++] = (char) d;
1465 string s = new String (number_builder, 0, number_pos);
1468 if (number_pos <= 8)
1469 ul = System.UInt32.Parse (s, NumberStyles.HexNumber);
1471 ul = System.UInt64.Parse (s, NumberStyles.HexNumber);
1473 return integer_type_suffix (ul, peek_char (), loc);
1474 } catch (OverflowException){
1475 Error_NumericConstantTooLong ();
1476 return new IntLiteral (context.BuiltinTypes, 0, loc);
1478 catch (FormatException) {
1479 Report.Error (1013, Location, "Invalid number");
1480 return new IntLiteral (context.BuiltinTypes, 0, loc);
1485 // Invoked if we know we have .digits or digits
1487 int is_number (int c)
1489 ILiteralConstant res;
1494 if (c >= '0' && c <= '9'){
1496 int peek = peek_char ();
1498 if (peek == 'x' || peek == 'X') {
1499 res = handle_hex (loc);
1502 res.ParsedValue = new char[number_pos + 2];
1503 res.ParsedValue[0] = (char) c;
1504 res.ParsedValue[1] = (char) peek;
1505 Array.Copy (number_builder, 0, res.ParsedValue, 2, number_pos);
1508 return Token.LITERAL;
1516 // We need to handle the case of
1517 // "1.1" vs "1.string" (LITERAL_FLOAT vs NUMBER DOT IDENTIFIER)
1519 bool is_real = false;
1521 if (decimal_digits ('.')){
1527 return adjust_int (-1, loc);
1531 if (c == 'e' || c == 'E'){
1533 if (number_pos == max_number_size)
1534 Error_NumericConstantTooLong ();
1535 number_builder [number_pos++] = (char) c;
1539 if (number_pos == max_number_size)
1540 Error_NumericConstantTooLong ();
1541 number_builder [number_pos++] = '+';
1543 } else if (c == '-') {
1544 if (number_pos == max_number_size)
1545 Error_NumericConstantTooLong ();
1546 number_builder [number_pos++] = '-';
1549 if (number_pos == max_number_size)
1550 Error_NumericConstantTooLong ();
1551 number_builder [number_pos++] = '+';
1558 var type = real_type_suffix (c);
1559 if (type == TypeCode.Empty && !is_real){
1561 return adjust_int (c, loc);
1566 if (type == TypeCode.Empty){
1571 val = res = adjust_real (type, loc);
1574 res.ParsedValue = new char[number_pos + (c != 0 ? 1 : 0)];
1575 Array.Copy (number_builder, res.ParsedValue, number_pos);
1577 res.ParsedValue[number_pos] = (char) c;
1580 return Token.LITERAL;
1584 // Accepts exactly count (4 or 8) hex, no more no less
1586 int getHex (int count, out int surrogate, out bool error)
1591 int top = count != -1 ? count : 4;
1596 for (i = 0; i < top; i++){
1599 if (c >= '0' && c <= '9')
1600 c = (int) c - (int) '0';
1601 else if (c >= 'A' && c <= 'F')
1602 c = (int) c - (int) 'A' + 10;
1603 else if (c >= 'a' && c <= 'f')
1604 c = (int) c - (int) 'a' + 10;
1610 total = (total * 16) + c;
1612 int p = peek_char ();
1615 if (!is_hex ((char)p))
1621 if (total > 0x0010FFFF) {
1626 if (total >= 0x00010000) {
1627 surrogate = ((total - 0x00010000) % 0x0400 + 0xDC00);
1628 total = ((total - 0x00010000) / 0x0400 + 0xD800);
1635 int escape (int c, out int surrogate)
1671 v = getHex (-1, out surrogate, out error);
1677 return EscapeUnicode (d, out surrogate);
1680 Report.Error (1009, Location, "Unrecognized escape sequence `\\{0}'", ((char)d).ToString ());
1689 int EscapeUnicode (int ch, out int surrogate)
1693 ch = getHex (8, out surrogate, out error);
1695 ch = getHex (4, out surrogate, out error);
1699 Report.Error (1009, Location, "Unrecognized escape sequence");
1707 if (putback_char != -1) {
1715 if (peek_char () == '\n') {
1721 } else if (x == '\n') {
1729 void advance_line ()
1739 if (putback_char == -1)
1740 putback_char = reader.Read ();
1741 return putback_char;
1746 if (putback_char != -1)
1747 return putback_char;
1748 return reader.Peek ();
1751 void putback (int c)
1753 if (putback_char != -1){
1754 Console.WriteLine ("Col: " + col);
1755 Console.WriteLine ("Row: " + line);
1756 Console.WriteLine ("Name: " + ref_name.Name);
1757 Console.WriteLine ("Current [{0}] putting back [{1}] ", putback_char, c);
1758 throw new Exception ("This should not happen putback on putback");
1760 if (c == '\n' || col == 0) {
1761 // It won't happen though.
1771 public bool advance ()
1773 return peek_char () != -1 || CompleteOnEOF;
1776 public Object Value {
1782 public Object value ()
1789 current_token = xtoken ();
1790 return current_token;
1793 int TokenizePreprocessorIdentifier (out int c)
1795 // skip over white space
1798 } while (c == ' ' || c == '\t');
1802 while (c != -1 && c >= 'a' && c <= 'z') {
1803 id_builder[pos++] = (char) c;
1806 int peek = peek_char ();
1807 if (peek == 'U' || peek == 'u') {
1809 c = EscapeUnicode (c, out surrogate);
1810 if (surrogate != 0) {
1811 if (is_identifier_part_character ((char) c)) {
1812 id_builder[pos++] = (char) c;
1823 PreprocessorDirective get_cmd_arg (out string arg)
1827 tokens_seen = false;
1830 var cmd = GetPreprocessorDirective (id_builder, TokenizePreprocessorIdentifier (out c));
1832 if ((cmd & PreprocessorDirective.CustomArgumentsParsing) != 0)
1835 // skip over white space
1836 while (c == ' ' || c == '\t')
1839 int has_identifier_argument = (int)(cmd & PreprocessorDirective.RequiresArgument);
1842 while (c != -1 && c != '\n') {
1843 if (c == '\\' && has_identifier_argument >= 0) {
1844 if (has_identifier_argument != 0) {
1845 has_identifier_argument = 1;
1847 int peek = peek_char ();
1848 if (peek == 'U' || peek == 'u') {
1850 c = EscapeUnicode (c, out surrogate);
1851 if (surrogate != 0) {
1852 if (is_identifier_part_character ((char) c)) {
1853 if (pos == value_builder.Length)
1854 Array.Resize (ref value_builder, pos * 2);
1856 value_builder[pos++] = (char) c;
1862 has_identifier_argument = -1;
1864 } else if (c == '/' && peek_char () == '/') {
1866 // Eat single-line comments
1871 } while (c != -1 && c != '\n');
1876 if (pos == value_builder.Length)
1877 Array.Resize (ref value_builder, pos * 2);
1879 value_builder[pos++] = (char) c;
1884 if (pos > max_id_size)
1885 arg = new string (value_builder, 0, pos);
1887 arg = InternIdentifier (value_builder, pos);
1889 // Eat any trailing whitespaces
1890 arg = arg.Trim (simple_whitespaces);
1897 // Handles the #line directive
1899 bool PreProcessLine (string arg)
1901 if (arg.Length == 0)
1904 if (arg == "default"){
1906 ref_name = file_name;
1908 Location.Push (file_name, ref_name);
1910 } else if (arg == "hidden"){
1918 if ((pos = arg.IndexOf (' ')) != -1 && pos != 0){
1919 ref_line = System.Int32.Parse (arg.Substring (0, pos));
1922 char [] quotes = { '\"' };
1924 string name = arg.Substring (pos). Trim (quotes);
1925 ref_name = context.LookupFile (file_name, name);
1926 file_name.AddIncludeFile (ref_name);
1928 Location.Push (file_name, ref_name);
1930 ref_line = System.Int32.Parse (arg);
1941 // Handles #define and #undef
1943 void PreProcessDefinition (bool is_define, string ident, bool caller_is_taking)
1945 if (ident.Length == 0 || ident == "true" || ident == "false"){
1946 Report.Error (1001, Location, "Missing identifier to pre-processor directive");
1950 if (ident.IndexOfAny (simple_whitespaces) != -1){
1951 Error_EndLineExpected ();
1955 if (!is_identifier_start_character (ident [0]))
1956 Report.Error (1001, Location, "Identifier expected: {0}", ident);
1958 foreach (char c in ident.Substring (1)){
1959 if (!is_identifier_part_character (c)){
1960 Report.Error (1001, Location, "Identifier expected: {0}", ident);
1965 if (!caller_is_taking)
1972 if (context.Settings.IsConditionalSymbolDefined (ident))
1975 file_name.AddDefine (ident);
1980 file_name.AddUndefine (ident);
1984 byte read_hex (out bool error)
1987 int c = get_char ();
1989 if ((c >= '0') && (c <= '9'))
1990 total = (int) c - (int) '0';
1991 else if ((c >= 'A') && (c <= 'F'))
1992 total = (int) c - (int) 'A' + 10;
1993 else if ((c >= 'a') && (c <= 'f'))
1994 total = (int) c - (int) 'a' + 10;
2003 if ((c >= '0') && (c <= '9'))
2004 total += (int) c - (int) '0';
2005 else if ((c >= 'A') && (c <= 'F'))
2006 total += (int) c - (int) 'A' + 10;
2007 else if ((c >= 'a') && (c <= 'f'))
2008 total += (int) c - (int) 'a' + 10;
2015 return (byte) total;
2019 // Parses #pragma checksum
2021 bool ParsePragmaChecksum ()
2024 // The syntax is ` "foo.txt" "{guid}" "hash"'
2026 int c = get_char ();
2031 string_builder.Length = 0;
2032 while (c != -1 && c != '\n') {
2039 string_builder.Append ((char) c);
2042 if (string_builder.Length == 0) {
2043 Report.Warning (1709, 1, Location, "Filename specified for preprocessor directive is empty");
2046 // TODO: Any white-spaces count
2050 SourceFile file = context.LookupFile (file_name, string_builder.ToString ());
2052 if (get_char () != '"' || get_char () != '{')
2056 byte[] guid_bytes = new byte [16];
2059 for (; i < 4; i++) {
2060 guid_bytes [i] = read_hex (out error);
2065 if (get_char () != '-')
2068 for (; i < 10; i++) {
2069 guid_bytes [i] = read_hex (out error);
2073 guid_bytes [i++] = read_hex (out error);
2077 if (get_char () != '-')
2081 for (; i < 16; i++) {
2082 guid_bytes [i] = read_hex (out error);
2087 if (get_char () != '}' || get_char () != '"')
2090 // TODO: Any white-spaces count
2095 if (get_char () != '"')
2098 // Any length of checksum
2099 List<byte> checksum_bytes = new List<byte> (16);
2102 while (c != '"' && c != -1) {
2103 checksum_bytes.Add (read_hex (out error));
2111 ReadSingleLineComment ();
2112 } else if (get_char () != '"') {
2116 file.SetChecksum (guid_bytes, checksum_bytes.ToArray ());
2117 ref_name.AutoGenerated = true;
2121 bool IsTokenIdentifierEqual (char[] identifier)
2123 for (int i = 0; i < identifier.Length; ++i) {
2124 if (identifier[i] != id_builder[i])
2131 int TokenizePragmaNumber (ref int c)
2137 if (c >= '0' && c <= '9') {
2139 uint ui = (uint) (number_builder[0] - '0');
2142 for (int i = 1; i < number_pos; i++) {
2143 ui = checked ((ui * 10) + ((uint) (number_builder[i] - '0')));
2147 } catch (OverflowException) {
2148 Error_NumericConstantTooLong ();
2155 // skip over white space
2156 while (c == ' ' || c == '\t')
2163 // skip over white space
2164 while (c == ' ' || c == '\t')
2169 ReadSingleLineComment ();
2171 Report.Warning (1692, 1, Location, "Invalid number");
2173 // Read everything till the end of the line or file
2176 } while (c != -1 && c != '\n');
2183 void ReadSingleLineComment ()
2185 if (peek_char () != '/')
2186 Report.Warning (1696, 1, Location, "Single-line comment or end-of-line expected");
2188 // Read everything till the end of the line or file
2192 } while (c != -1 && c != '\n');
2196 /// Handles #pragma directive
2198 void ParsePragmaDirective (string arg)
2201 int length = TokenizePreprocessorIdentifier (out c);
2202 if (length == pragma_warning.Length && IsTokenIdentifierEqual (pragma_warning)) {
2203 length = TokenizePreprocessorIdentifier (out c);
2206 // #pragma warning disable
2207 // #pragma warning restore
2209 if (length == pragma_warning_disable.Length) {
2210 bool disable = IsTokenIdentifierEqual (pragma_warning_disable);
2211 if (disable || IsTokenIdentifierEqual (pragma_warning_restore)) {
2212 // skip over white space
2213 while (c == ' ' || c == '\t')
2218 if (c == '\n' || c == '/') {
2220 ReadSingleLineComment ();
2223 // Disable/Restore all warnings
2226 Report.RegisterWarningRegion (loc).WarningDisable (loc.Row);
2228 Report.RegisterWarningRegion (loc).WarningEnable (loc.Row);
2232 // Disable/Restore a warning or group of warnings
2236 code = TokenizePragmaNumber (ref c);
2239 Report.RegisterWarningRegion (loc).WarningDisable (loc, code, Report);
2241 Report.RegisterWarningRegion (loc).WarningEnable (loc, code, Report);
2244 } while (code >= 0 && c != '\n' && c != -1);
2251 Report.Warning (1634, 1, Location, "Expected disable or restore");
2258 if (length == pragma_checksum.Length && IsTokenIdentifierEqual (pragma_checksum)) {
2259 if (c != ' ' || !ParsePragmaChecksum ()) {
2260 Report.Warning (1695, 1, Location,
2261 "Invalid #pragma checksum syntax. Expected \"filename\" \"{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}\" \"XXXX...\"");
2267 Report.Warning (1633, 1, Location, "Unrecognized #pragma directive");
2270 bool eval_val (string s)
2277 return file_name.IsConditionalDefined (context, s);
2280 bool pp_primary (ref string s)
2289 s = s.Substring (1);
2290 bool val = pp_expr (ref s, false);
2291 if (s.Length > 0 && s [0] == ')'){
2292 s = s.Substring (1);
2295 Error_InvalidDirective ();
2299 if (is_identifier_start_character (c)){
2305 if (is_identifier_part_character (c)){
2309 bool v = eval_val (s.Substring (0, j));
2310 s = s.Substring (j);
2313 bool vv = eval_val (s);
2318 Error_InvalidDirective ();
2322 bool pp_unary (ref string s)
2329 if (len > 1 && s [1] == '='){
2330 Error_InvalidDirective ();
2333 s = s.Substring (1);
2334 return ! pp_primary (ref s);
2336 return pp_primary (ref s);
2338 Error_InvalidDirective ();
2343 bool pp_eq (ref string s)
2345 bool va = pp_unary (ref s);
2351 if (len > 2 && s [1] == '='){
2352 s = s.Substring (2);
2353 return va == pp_unary (ref s);
2355 Error_InvalidDirective ();
2358 } else if (s [0] == '!' && len > 1 && s [1] == '='){
2359 s = s.Substring (2);
2361 return va != pp_unary (ref s);
2370 bool pp_and (ref string s)
2372 bool va = pp_eq (ref s);
2378 if (len > 2 && s [1] == '&'){
2379 s = s.Substring (2);
2380 return (va & pp_and (ref s));
2382 Error_InvalidDirective ();
2391 // Evaluates an expression for `#if' or `#elif'
2393 bool pp_expr (ref string s, bool isTerm)
2395 bool va = pp_and (ref s);
2402 if (len > 2 && s [1] == '|'){
2403 s = s.Substring (2);
2404 return va | pp_expr (ref s, isTerm);
2406 Error_InvalidDirective ();
2411 Error_EndLineExpected ();
2419 bool eval (string s)
2421 bool v = pp_expr (ref s, true);
2430 void Error_NumericConstantTooLong ()
2432 Report.Error (1021, Location, "Integral constant is too large");
2435 void Error_InvalidDirective ()
2437 Report.Error (1517, Location, "Invalid preprocessor directive");
2440 void Error_UnexpectedDirective (string extra)
2444 "Unexpected processor directive ({0})", extra);
2447 void Error_TokensSeen ()
2449 Report.Error (1032, Location,
2450 "Cannot define or undefine preprocessor symbols after first token in file");
2453 void Eror_WrongPreprocessorLocation ()
2455 Report.Error (1040, Location,
2456 "Preprocessor directives must appear as the first non-whitespace character on a line");
2459 void Error_EndLineExpected ()
2461 Report.Error (1025, Location, "Single-line comment or end-of-line expected");
2465 // Raises a warning when tokenizer found documentation comment
2466 // on unexpected place
2468 void WarningMisplacedComment (Location loc)
2470 if (doc_state != XmlCommentState.Error) {
2471 doc_state = XmlCommentState.Error;
2472 Report.Warning (1587, 2, loc, "XML comment is not placed on a valid language element");
2477 // if true, then the code continues processing the code
2478 // if false, the code stays in a loop until another directive is
2480 // When caller_is_taking is false we ignore all directives except the ones
2481 // which can help us to identify where the #if block ends
2482 bool ParsePreprocessingDirective (bool caller_is_taking)
2485 bool region_directive = false;
2487 var directive = get_cmd_arg (out arg);
2490 // The first group of pre-processing instructions is always processed
2492 switch (directive) {
2493 case PreprocessorDirective.Region:
2494 region_directive = true;
2496 goto case PreprocessorDirective.If;
2498 case PreprocessorDirective.Endregion:
2499 if (ifstack == null || ifstack.Count == 0){
2500 Error_UnexpectedDirective ("no #region for this #endregion");
2503 int pop = ifstack.Pop ();
2505 if ((pop & REGION) == 0)
2506 Report.Error (1027, Location, "Expected `#endif' directive");
2508 return caller_is_taking;
2510 case PreprocessorDirective.If:
2511 if (ifstack == null)
2512 ifstack = new Stack<int> (2);
2514 int flags = region_directive ? REGION : 0;
2515 if (ifstack.Count == 0){
2516 flags |= PARENT_TAKING;
2518 int state = ifstack.Peek ();
2519 if ((state & TAKING) != 0) {
2520 flags |= PARENT_TAKING;
2524 if (eval (arg) && caller_is_taking) {
2525 ifstack.Push (flags | TAKING);
2528 ifstack.Push (flags);
2531 case PreprocessorDirective.Endif:
2532 if (ifstack == null || ifstack.Count == 0){
2533 Error_UnexpectedDirective ("no #if for this #endif");
2536 pop = ifstack.Pop ();
2538 if ((pop & REGION) != 0)
2539 Report.Error (1038, Location, "#endregion directive expected");
2541 if (arg.Length != 0) {
2542 Error_EndLineExpected ();
2545 if (ifstack.Count == 0)
2548 int state = ifstack.Peek ();
2549 return (state & TAKING) != 0;
2552 case PreprocessorDirective.Elif:
2553 if (ifstack == null || ifstack.Count == 0){
2554 Error_UnexpectedDirective ("no #if for this #elif");
2557 int state = ifstack.Pop ();
2559 if ((state & REGION) != 0) {
2560 Report.Error (1038, Location, "#endregion directive expected");
2564 if ((state & ELSE_SEEN) != 0){
2565 Error_UnexpectedDirective ("#elif not valid after #else");
2569 if ((state & TAKING) != 0) {
2574 if (eval (arg) && ((state & PARENT_TAKING) != 0)){
2575 ifstack.Push (state | TAKING);
2579 ifstack.Push (state);
2583 case PreprocessorDirective.Else:
2584 if (ifstack == null || ifstack.Count == 0){
2585 Error_UnexpectedDirective ("no #if for this #else");
2588 int state = ifstack.Peek ();
2590 if ((state & REGION) != 0) {
2591 Report.Error (1038, Location, "#endregion directive expected");
2595 if ((state & ELSE_SEEN) != 0){
2596 Error_UnexpectedDirective ("#else within #else");
2602 if (arg.Length != 0) {
2603 Error_EndLineExpected ();
2608 if ((state & PARENT_TAKING) != 0) {
2609 ret = (state & TAKING) == 0;
2617 ifstack.Push (state | ELSE_SEEN);
2621 case PreprocessorDirective.Define:
2622 if (any_token_seen){
2623 Error_TokensSeen ();
2624 return caller_is_taking;
2626 PreProcessDefinition (true, arg, caller_is_taking);
2627 return caller_is_taking;
2629 case PreprocessorDirective.Undef:
2630 if (any_token_seen){
2631 Error_TokensSeen ();
2632 return caller_is_taking;
2634 PreProcessDefinition (false, arg, caller_is_taking);
2635 return caller_is_taking;
2637 case PreprocessorDirective.Invalid:
2638 Report.Error (1024, Location, "Wrong preprocessor directive");
2643 // These are only processed if we are in a `taking' block
2645 if (!caller_is_taking)
2649 case PreprocessorDirective.Error:
2650 Report.Error (1029, Location, "#error: '{0}'", arg);
2653 case PreprocessorDirective.Warning:
2654 Report.Warning (1030, 1, Location, "#warning: `{0}'", arg);
2657 case PreprocessorDirective.Pragma:
2658 if (context.Settings.Version == LanguageVersion.ISO_1) {
2659 Report.FeatureIsNotAvailable (context, Location, "#pragma");
2662 ParsePragmaDirective (arg);
2665 case PreprocessorDirective.Line:
2666 if (!PreProcessLine (arg))
2669 "The line number specified for #line directive is missing or invalid");
2670 return caller_is_taking;
2673 throw new NotImplementedException (directive.ToString ());
2676 private int consume_string (bool quoted)
2680 Location start_location = Location;
2682 start_location = start_location - 1;
2687 if (quoted && peek_char () == '"') {
2688 if (pos == value_builder.Length)
2689 Array.Resize (ref value_builder, pos * 2);
2691 value_builder[pos++] = (char) c;
2700 s = InternIdentifier (value_builder, pos);
2702 s = new string (value_builder, 0, pos);
2704 val = new StringLiteral (context.BuiltinTypes, s, start_location);
2705 return Token.LITERAL;
2710 Report.Error (1010, Location, "Newline in constant");
2711 } else if (c == '\\' && !quoted) {
2713 c = escape (c, out surrogate);
2716 if (surrogate != 0) {
2717 if (pos == value_builder.Length)
2718 Array.Resize (ref value_builder, pos * 2);
2720 value_builder[pos++] = (char) c;
2723 } else if (c == -1) {
2724 Report.Error (1039, Location, "Unterminated string literal");
2728 if (pos == value_builder.Length)
2729 Array.Resize (ref value_builder, pos * 2);
2731 value_builder[pos++] = (char) c;
2735 private int consume_identifier (int s)
2737 int res = consume_identifier (s, false);
2739 if (doc_state == XmlCommentState.Allowed)
2740 doc_state = XmlCommentState.NotAllowed;
2745 int consume_identifier (int c, bool quoted)
2748 // This method is very performance sensitive. It accounts
2749 // for approximately 25% of all parser time
2759 c = escape (c, out surrogate);
2760 if (surrogate != 0) {
2761 id_builder [pos++] = (char) c;
2766 id_builder [pos++] = (char) c;
2772 if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c == '_' || (c >= '0' && c <= '9')) {
2773 id_builder [pos++] = (char) c;
2780 c = escape (c, out surrogate);
2781 if (is_identifier_part_character ((char) c))
2782 id_builder[pos++] = (char) c;
2784 if (surrogate != 0) {
2790 } else if (Char.IsLetter ((char) c) || Char.GetUnicodeCategory ((char) c) == UnicodeCategory.ConnectorPunctuation) {
2791 id_builder [pos++] = (char) c;
2798 } catch (IndexOutOfRangeException) {
2799 Report.Error (645, Location, "Identifier too long (limit is 512 chars)");
2807 // Optimization: avoids doing the keyword lookup
2808 // on uppercase letters
2810 if (id_builder [0] >= '_' && !quoted) {
2811 int keyword = GetKeyword (id_builder, pos);
2812 if (keyword != -1) {
2813 val = LocatedToken.Create (null, ref_line, column);
2818 string s = InternIdentifier (id_builder, pos);
2819 val = LocatedToken.Create (s, ref_line, column);
2820 if (quoted && parsing_attribute_section)
2821 AddEscapedIdentifier (((LocatedToken) val).Location);
2823 return Token.IDENTIFIER;
2826 static string InternIdentifier (char[] charBuffer, int length)
2829 // Keep identifiers in an array of hashtables to avoid needless
2832 var identifiers_group = identifiers[length];
2834 if (identifiers_group != null) {
2835 if (identifiers_group.TryGetValue (charBuffer, out s)) {
2839 // TODO: this should be number of files dependant
2840 // corlib compilation peaks at 1000 and System.Core at 150
2841 int capacity = length > 20 ? 10 : 100;
2842 identifiers_group = new Dictionary<char[], string> (capacity, new IdentifiersComparer (length));
2843 identifiers[length] = identifiers_group;
2846 char[] chars = new char[length];
2847 Array.Copy (charBuffer, chars, length);
2849 s = new string (charBuffer, 0, length);
2850 identifiers_group.Add (chars, s);
2854 public int xtoken ()
2858 // Whether we have seen comments on the current line
2859 bool comments_seen = false;
2860 while ((c = get_char ()) != -1) {
2863 col = ((col - 1 + tab_size) / tab_size) * tab_size;
2871 case 0xFEFF: // Ignore BOM anywhere in the file
2874 /* This is required for compatibility with .NET
2876 if (peek_char () == 0xBB) {
2879 if (get_char () == 0xBF)
2887 return consume_identifier (c);
2890 val = LocatedToken.Create (ref_line, col);
2891 return Token.OPEN_BRACE;
2893 val = LocatedToken.Create (ref_line, col);
2894 return Token.CLOSE_BRACE;
2896 // To block doccomment inside attribute declaration.
2897 if (doc_state == XmlCommentState.Allowed)
2898 doc_state = XmlCommentState.NotAllowed;
2900 val = LocatedToken.Create (ref_line, col);
2902 if (parsing_block == 0 || lambda_arguments_parsing)
2903 return Token.OPEN_BRACKET;
2905 int next = peek_char ();
2909 return Token.OPEN_BRACKET;
2917 next = peek_token ();
2918 if (next == Token.COMMA || next == Token.CLOSE_BRACKET)
2919 return Token.OPEN_BRACKET;
2921 return Token.OPEN_BRACKET_EXPR;
2923 return Token.OPEN_BRACKET_EXPR;
2926 LocatedToken.CreateOptional (ref_line, col, ref val);
2927 return Token.CLOSE_BRACKET;
2929 val = LocatedToken.Create (ref_line, col);
2931 // An expression versions of parens can appear in block context only
2933 if (parsing_block != 0 && !lambda_arguments_parsing) {
2936 // Optmize most common case where we know that parens
2939 switch (current_token) {
2940 case Token.IDENTIFIER:
2948 case Token.DELEGATE:
2949 case Token.OP_GENERICS_GT:
2950 return Token.OPEN_PARENS;
2953 // Optimize using peek
2954 int xx = peek_char ();
2961 return Token.OPEN_PARENS;
2964 lambda_arguments_parsing = true;
2966 d = TokenizeOpenParens ();
2968 lambda_arguments_parsing = false;
2972 return Token.OPEN_PARENS;
2974 LocatedToken.CreateOptional (ref_line, col, ref val);
2975 return Token.CLOSE_PARENS;
2977 LocatedToken.CreateOptional (ref_line, col, ref val);
2980 LocatedToken.CreateOptional (ref_line, col, ref val);
2981 return Token.SEMICOLON;
2983 val = LocatedToken.Create (ref_line, col);
2986 val = LocatedToken.Create (ref_line, col);
2987 return TokenizePossibleNullableType ();
2989 val = LocatedToken.Create (ref_line, col);
2990 if (parsing_generic_less_than++ > 0)
2991 return Token.OP_GENERICS_LT;
2993 return TokenizeLessThan ();
2996 val = LocatedToken.Create (ref_line, col);
3004 if (parsing_generic_less_than > 1 || (parsing_generic_less_than == 1 && d != '>')) {
3005 parsing_generic_less_than--;
3006 return Token.OP_GENERICS_GT;
3015 return Token.OP_SHIFT_RIGHT_ASSIGN;
3017 return Token.OP_SHIFT_RIGHT;
3023 val = LocatedToken.Create (ref_line, col);
3027 } else if (d == '=') {
3028 d = Token.OP_ADD_ASSIGN;
3036 val = LocatedToken.Create (ref_line, col);
3040 } else if (d == '=')
3041 d = Token.OP_SUB_ASSIGN;
3051 val = LocatedToken.Create (ref_line, col);
3052 if (peek_char () == '='){
3059 val = LocatedToken.Create (ref_line, col);
3070 return Token.ASSIGN;
3073 val = LocatedToken.Create (ref_line, col);
3077 return Token.OP_AND;
3081 return Token.OP_AND_ASSIGN;
3083 return Token.BITWISE_AND;
3086 val = LocatedToken.Create (ref_line, col);
3094 return Token.OP_OR_ASSIGN;
3096 return Token.BITWISE_OR;
3099 val = LocatedToken.Create (ref_line, col);
3100 if (peek_char () == '='){
3102 return Token.OP_MULT_ASSIGN;
3109 val = LocatedToken.Create (ref_line, col);
3111 return Token.OP_DIV_ASSIGN;
3114 // Handle double-slash comments.
3117 if (doc_processing) {
3118 if (peek_char () == '/') {
3120 // Don't allow ////.
3121 if ((d = peek_char ()) != '/') {
3122 if (doc_state == XmlCommentState.Allowed)
3123 handle_one_line_xml_comment ();
3124 else if (doc_state == XmlCommentState.NotAllowed)
3125 WarningMisplacedComment (Location - 3);
3128 if (xml_comment_buffer.Length > 0)
3129 doc_state = XmlCommentState.NotAllowed;
3133 while ((d = get_char ()) != -1 && d != '\n');
3135 any_token_seen |= tokens_seen;
3136 tokens_seen = false;
3137 comments_seen = false;
3139 } else if (d == '*'){
3141 bool docAppend = false;
3142 if (doc_processing && peek_char () == '*') {
3144 // But when it is /**/, just do nothing.
3145 if (peek_char () == '/') {
3149 if (doc_state == XmlCommentState.Allowed)
3151 else if (doc_state == XmlCommentState.NotAllowed) {
3152 WarningMisplacedComment (Location - 2);
3156 int current_comment_start = 0;
3158 current_comment_start = xml_comment_buffer.Length;
3159 xml_comment_buffer.Append (Environment.NewLine);
3162 while ((d = get_char ()) != -1){
3163 if (d == '*' && peek_char () == '/'){
3165 comments_seen = true;
3169 xml_comment_buffer.Append ((char) d);
3172 any_token_seen |= tokens_seen;
3173 tokens_seen = false;
3175 // Reset 'comments_seen' just to be consistent.
3176 // It doesn't matter either way, here.
3178 comments_seen = false;
3182 Report.Error (1035, Location, "End-of-file found, '*/' expected");
3185 update_formatted_doc_comment (current_comment_start);
3188 val = LocatedToken.Create (ref_line, col);
3192 val = LocatedToken.Create (ref_line, col);
3193 if (peek_char () == '='){
3195 return Token.OP_MOD_ASSIGN;
3197 return Token.PERCENT;
3200 val = LocatedToken.Create (ref_line, col);
3201 if (peek_char () == '='){
3203 return Token.OP_XOR_ASSIGN;
3205 return Token.CARRET;
3208 val = LocatedToken.Create (ref_line, col);
3209 if (peek_char () == ':') {
3211 return Token.DOUBLE_COLON;
3215 case '0': case '1': case '2': case '3': case '4':
3216 case '5': case '6': case '7': case '8': case '9':
3218 return is_number (c);
3220 case '\n': // white space
3221 any_token_seen |= tokens_seen;
3222 tokens_seen = false;
3223 comments_seen = false;
3229 if (d >= '0' && d <= '9')
3230 return is_number (c);
3232 LocatedToken.CreateOptional (ref_line, col, ref val);
3236 if (tokens_seen || comments_seen) {
3237 Eror_WrongPreprocessorLocation ();
3241 if (ParsePreprocessingDirective (true))
3244 bool directive_expected = false;
3245 while ((c = get_char ()) != -1) {
3247 directive_expected = true;
3248 } else if (!directive_expected) {
3249 // TODO: Implement comment support for disabled code and uncomment this code
3251 // Eror_WrongPreprocessorLocation ();
3252 // return Token.ERROR;
3257 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\v' )
3261 if (ParsePreprocessingDirective (false))
3264 directive_expected = false;
3268 tokens_seen = false;
3275 return consume_string (false);
3278 return TokenizeBackslash ();
3284 return consume_string (true);
3287 if (is_identifier_start_character (c)){
3288 return consume_identifier (c, true);
3291 Report.Error (1646, Location, "Keyword, identifier, or string expected after verbatim specifier: @");
3294 case EvalStatementParserCharacter:
3295 return Token.EVAL_STATEMENT_PARSER;
3296 case EvalCompilationUnitParserCharacter:
3297 return Token.EVAL_COMPILATION_UNIT_PARSER;
3298 case EvalUsingDeclarationsParserCharacter:
3299 return Token.EVAL_USING_DECLARATIONS_UNIT_PARSER;
3300 case DocumentationXref:
3301 return Token.DOC_SEE;
3304 if (is_identifier_start_character (c)) {
3306 return consume_identifier (c);
3309 if (char.IsWhiteSpace ((char) c))
3312 Report.Error (1056, Location, "Unexpected character `{0}'", ((char) c).ToString ());
3317 return Token.COMPLETE_COMPLETION;
3320 return Token.GENERATE_COMPLETION;
3327 int TokenizeBackslash ()
3329 int c = get_char ();
3332 val = new CharLiteral (context.BuiltinTypes, (char) c, Location);
3333 Report.Error (1011, Location, "Empty character literal");
3334 return Token.LITERAL;
3338 Report.Error (1010, Location, "Newline in constant");
3343 c = escape (c, out d);
3347 throw new NotImplementedException ();
3349 val = new CharLiteral (context.BuiltinTypes, (char) c, Location);
3353 Report.Error (1012, Location, "Too many characters in character literal");
3355 // Try to recover, read until newline or next "'"
3356 while ((c = get_char ()) != -1) {
3357 if (c == '\n' || c == '\'')
3362 return Token.LITERAL;
3365 int TokenizeLessThan ()
3368 if (handle_typeof) {
3370 if (parse_generic_dimension (out d)) {
3373 return Token.GENERIC_DIMENSION;
3378 // Save current position and parse next token.
3380 if (parse_less_than ()) {
3381 if (parsing_generic_declaration && (parsing_generic_declaration_doc || token () != Token.DOT)) {
3382 d = Token.OP_GENERICS_LT_DECL;
3384 d = Token.OP_GENERICS_LT;
3391 parsing_generic_less_than = 0;
3400 return Token.OP_SHIFT_LEFT_ASSIGN;
3402 return Token.OP_SHIFT_LEFT;
3413 // Handles one line xml comment
3415 private void handle_one_line_xml_comment ()
3418 while ((c = peek_char ()) == ' ')
3419 get_char (); // skip heading whitespaces.
3420 while ((c = peek_char ()) != -1 && c != '\n' && c != '\r') {
3421 xml_comment_buffer.Append ((char) get_char ());
3423 if (c == '\r' || c == '\n')
3424 xml_comment_buffer.Append (Environment.NewLine);
3428 // Remove heading "*" in Javadoc-like xml documentation.
3430 private void update_formatted_doc_comment (int current_comment_start)
3432 int length = xml_comment_buffer.Length - current_comment_start;
3433 string [] lines = xml_comment_buffer.ToString (
3434 current_comment_start,
3435 length).Replace ("\r", "").Split ('\n');
3437 // The first line starts with /**, thus it is not target
3438 // for the format check.
3439 for (int i = 1; i < lines.Length; i++) {
3440 string s = lines [i];
3441 int idx = s.IndexOf ('*');
3444 if (i < lines.Length - 1)
3448 head = s.Substring (0, idx);
3449 foreach (char c in head)
3452 lines [i] = s.Substring (idx + 1);
3454 xml_comment_buffer.Remove (current_comment_start, length);
3455 xml_comment_buffer.Insert (current_comment_start, String.Join (Environment.NewLine, lines));
3459 // Checks if there was incorrect doc comments and raise
3462 public void check_incorrect_doc_comment ()
3464 if (xml_comment_buffer.Length > 0)
3465 WarningMisplacedComment (Location);
3469 // Consumes the saved xml comment lines (if any)
3470 // as for current target member or type.
3472 public string consume_doc_comment ()
3474 if (xml_comment_buffer.Length > 0) {
3475 string ret = xml_comment_buffer.ToString ();
3476 reset_doc_comment ();
3483 get { return context.Report; }
3486 void reset_doc_comment ()
3488 xml_comment_buffer.Length = 0;
3491 public void cleanup ()
3493 if (ifstack != null && ifstack.Count >= 1) {
3494 int state = ifstack.Pop ();
3495 if ((state & REGION) != 0)
3496 Report.Error (1038, Location, "#endregion directive expected");
3498 Report.Error (1027, Location, "Expected `#endif' directive");
3504 // Indicates whether it accepts XML documentation or not.
3506 public enum XmlCommentState {
3507 // comment is allowed in this state.
3509 // comment is not allowed in this state.
3511 // once comments appeared when it is NotAllowed, then the
3512 // state is changed to it, until the state is changed to