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@gmail.com)
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
12 // Copyright 2011 Xamarin, Inc (http://www.xamarin.com)
17 using System.Collections.Generic;
18 using System.Globalization;
19 using System.Diagnostics;
20 using System.Collections;
25 // This class has to be used by parser only, it reuses token
26 // details once a file is parsed
28 public class LocatedToken
30 public int row, column;
32 public SourceFile file;
34 public LocatedToken ()
38 public LocatedToken (string value, Location loc)
41 file = loc.SourceFile;
46 public override string ToString ()
48 return string.Format ("Token '{0}' at {1},{2}", Value, row, column);
51 public Location Location
53 get { return new Location (file, row, column); }
63 /// Tokenizer for C# source code.
65 public class Tokenizer : yyParser.yyInput
69 public readonly T Token;
70 public KeywordEntry<T> Next;
71 public readonly char[] Value;
73 public KeywordEntry (string value, T token)
75 this.Value = value.ToCharArray ();
80 sealed class IdentifiersComparer : IEqualityComparer<char[]>
84 public IdentifiersComparer (int length)
89 public bool Equals (char[] x, char[] y)
91 for (int i = 0; i < length; ++i)
98 public int GetHashCode (char[] obj)
101 for (int i = 0; i < length; ++i)
102 h = (h << 5) - h + obj [i];
108 public class LocatedTokenBuffer
110 readonly LocatedToken[] buffer;
113 public LocatedTokenBuffer ()
115 buffer = new LocatedToken[0];
118 public LocatedTokenBuffer (LocatedToken[] buffer)
120 this.buffer = buffer ?? new LocatedToken[0];
123 public LocatedToken Create (SourceFile file, int row, int column)
125 return Create (null, file, row, column);
128 public LocatedToken Create (string value, SourceFile file, int row, int column)
131 // TODO: I am not very happy about the logic but it's the best
132 // what I could come up with for now.
133 // Ideally we should be using just tiny buffer (256 elements) which
134 // is enough to hold all details for currect stack and recycle elements
135 // poped from the stack but there is a trick needed to recycle
139 if (pos >= buffer.Length) {
140 entry = new LocatedToken ();
144 entry = new LocatedToken ();
153 entry.column = column;
158 // Used for token not required by expression evaluator
160 [Conditional ("FULL_AST")]
161 public void CreateOptional (SourceFile file, int row, int col, ref object token)
163 token = Create (file, row, col);
167 public enum PreprocessorDirective
173 If = 3 | RequiresArgument,
175 Elif = 5 | RequiresArgument,
177 Define = 7 | RequiresArgument,
178 Undef = 8 | RequiresArgument,
181 Pragma = 11 | CustomArgumentsParsing,
182 Line = 12 | CustomArgumentsParsing,
184 CustomArgumentsParsing = 1 << 10,
185 RequiresArgument = 1 << 11
188 readonly SeekableStreamReader reader;
189 readonly CompilationSourceFile source_file;
190 readonly CompilerContext context;
191 readonly Report Report;
194 SourceFile current_source;
195 Location hidden_block_start;
201 readonly int tab_size;
202 bool handle_get_set = false;
203 bool handle_remove_add = false;
205 bool lambda_arguments_parsing;
206 List<Location> escaped_identifiers;
207 int parsing_generic_less_than;
208 readonly bool doc_processing;
209 readonly LocatedTokenBuffer ltb;
212 // Used mainly for parser optimizations. Some expressions for instance
213 // can appear only in block (including initializer, base initializer)
216 public int parsing_block;
217 internal bool query_parsing;
220 // When parsing type only, useful for ambiguous nullable types
222 public int parsing_type;
225 // Set when parsing generic declaration (type or method header)
227 public bool parsing_generic_declaration;
228 public bool parsing_generic_declaration_doc;
231 // The value indicates that we have not reach any declaration or
234 public int parsing_declaration;
236 public bool parsing_attribute_section;
238 public bool parsing_modifiers;
241 // The special characters to inject on streams to run the unit parser
242 // in the special expression mode. Using private characters from
243 // Plane Sixteen (U+100000 to U+10FFFD)
245 // This character is only tested just before the tokenizer is about to report
246 // an error; So on the regular operation mode, this addition will have no
247 // impact on the tokenizer's performance.
250 public const int EvalStatementParserCharacter = 0x100000;
251 public const int EvalCompilationUnitParserCharacter = 0x100001;
252 public const int EvalUsingDeclarationsParserCharacter = 0x100002;
253 public const int DocumentationXref = 0x100003;
255 const int UnicodeLS = 0x2028;
256 const int UnicodePS = 0x2029;
259 // XML documentation buffer. The save point is used to divide
260 // comments on types and comments on members.
262 StringBuilder xml_comment_buffer;
265 // See comment on XmlCommentState enumeration.
267 XmlCommentState xml_doc_state = XmlCommentState.Allowed;
270 // Whether tokens have been seen on this line
272 bool tokens_seen = false;
275 // Set to true once the GENERATE_COMPLETION token has bee
276 // returned. This helps produce one GENERATE_COMPLETION,
277 // as many COMPLETE_COMPLETION as necessary to complete the
278 // AST tree and one final EOF.
283 // Whether a token has been seen on the file
284 // This is needed because `define' is not allowed to be used
285 // after a token has been seen.
292 static readonly KeywordEntry<int>[][] keywords;
293 static readonly KeywordEntry<PreprocessorDirective>[][] keywords_preprocessor;
294 static readonly HashSet<string> keyword_strings;
295 static readonly NumberStyles styles;
296 static readonly NumberFormatInfo csharp_format_info;
299 static readonly char[] pragma_warning = "warning".ToCharArray ();
300 static readonly char[] pragma_warning_disable = "disable".ToCharArray ();
301 static readonly char[] pragma_warning_restore = "restore".ToCharArray ();
302 static readonly char[] pragma_checksum = "checksum".ToCharArray ();
303 static readonly char[] line_hidden = "hidden".ToCharArray ();
304 static readonly char[] line_default = "default".ToCharArray ();
306 static readonly char[] simple_whitespaces = new char[] { ' ', '\t' };
308 public bool PropertyParsing {
309 get { return handle_get_set; }
310 set { handle_get_set = value; }
313 public bool EventParsing {
314 get { return handle_remove_add; }
315 set { handle_remove_add = value; }
318 public bool ConstraintsParsing {
319 get { return handle_where; }
320 set { handle_where = value; }
323 public XmlCommentState doc_state {
324 get { return xml_doc_state; }
326 if (value == XmlCommentState.Allowed) {
327 check_incorrect_doc_comment ();
328 reset_doc_comment ();
330 xml_doc_state = value;
335 // This is used to trigger completion generation on the parser
336 public bool CompleteOnEOF;
338 void AddEscapedIdentifier (Location loc)
340 if (escaped_identifiers == null)
341 escaped_identifiers = new List<Location> ();
343 escaped_identifiers.Add (loc);
346 public bool IsEscapedIdentifier (ATypeNameExpression name)
348 return escaped_identifiers != null && escaped_identifiers.Contains (name.Location);
352 // Values for the associated token returned
354 internal int putback_char; // Used by repl only
360 const int TAKING = 1;
361 const int ELSE_SEEN = 4;
362 const int PARENT_TAKING = 8;
363 const int REGION = 16;
366 // pre-processor if stack state:
370 public const int MaxIdentifierLength = 512;
371 public const int MaxNumberLength = 512;
373 readonly char[] id_builder;
374 readonly Dictionary<char[], string>[] identifiers;
375 readonly char[] number_builder;
378 char[] value_builder = new char[64];
387 // This is used when the tokenizer needs to save
388 // the current position as it needs to do some parsing
389 // on its own to deamiguate a token in behalf of the
392 Stack<Position> position_stack = new Stack<Position> (2);
399 public Location hidden;
400 public int putback_char;
401 public int previous_col;
402 public Stack<int> ifstack;
403 public int parsing_generic_less_than;
404 public int current_token;
407 public Position (Tokenizer t)
409 position = t.reader.Position;
411 ref_line = t.ref_line;
413 hidden = t.hidden_block_start;
414 putback_char = t.putback_char;
415 previous_col = t.previous_col;
416 if (t.ifstack != null && t.ifstack.Count != 0) {
417 // There is no simple way to clone Stack<T> all
418 // methods reverse the order
419 var clone = t.ifstack.ToArray ();
420 Array.Reverse (clone);
421 ifstack = new Stack<int> (clone);
423 parsing_generic_less_than = t.parsing_generic_less_than;
424 current_token = t.current_token;
429 public Tokenizer (SeekableStreamReader input, CompilationSourceFile file, ParserSession session, Report report)
431 this.source_file = file;
432 this.context = file.Compiler;
433 this.current_source = file.SourceFile;
434 this.identifiers = session.Identifiers;
435 this.id_builder = session.IDBuilder;
436 this.number_builder = session.NumberBuilder;
437 this.ltb = new LocatedTokenBuffer (session.LocatedTokens);
438 this.Report = report;
444 xml_comment_buffer = new StringBuilder ();
445 doc_processing = context.Settings.DocumentationFile != null;
447 tab_size = context.Settings.TabSize;
450 public void PushPosition ()
452 position_stack.Push (new Position (this));
455 public void PopPosition ()
457 Position p = position_stack.Pop ();
459 reader.Position = p.position;
460 ref_line = p.ref_line;
463 hidden_block_start = p.hidden;
464 putback_char = p.putback_char;
465 previous_col = p.previous_col;
467 parsing_generic_less_than = p.parsing_generic_less_than;
468 current_token = p.current_token;
472 // Do not reset the position, ignore it.
473 public void DiscardPosition ()
475 position_stack.Pop ();
478 static void AddKeyword (string kw, int token)
480 keyword_strings.Add (kw);
482 AddKeyword (keywords, kw, token);
485 static void AddPreprocessorKeyword (string kw, PreprocessorDirective directive)
487 AddKeyword (keywords_preprocessor, kw, directive);
490 static void AddKeyword<T> (KeywordEntry<T>[][] keywords, string kw, T token)
492 int length = kw.Length;
493 if (keywords[length] == null) {
494 keywords[length] = new KeywordEntry<T>['z' - '_' + 1];
497 int char_index = kw[0] - '_';
498 var kwe = keywords[length][char_index];
500 keywords[length][char_index] = new KeywordEntry<T> (kw, token);
504 while (kwe.Next != null) {
508 kwe.Next = new KeywordEntry<T> (kw, token);
516 keyword_strings = new HashSet<string> ();
518 // 11 is the length of the longest keyword for now
519 keywords = new KeywordEntry<int>[11][];
521 AddKeyword ("__arglist", Token.ARGLIST);
522 AddKeyword ("__makeref", Token.MAKEREF);
523 AddKeyword ("__reftype", Token.REFTYPE);
524 AddKeyword ("__refvalue", Token.REFVALUE);
525 AddKeyword ("abstract", Token.ABSTRACT);
526 AddKeyword ("as", Token.AS);
527 AddKeyword ("add", Token.ADD);
528 AddKeyword ("base", Token.BASE);
529 AddKeyword ("bool", Token.BOOL);
530 AddKeyword ("break", Token.BREAK);
531 AddKeyword ("byte", Token.BYTE);
532 AddKeyword ("case", Token.CASE);
533 AddKeyword ("catch", Token.CATCH);
534 AddKeyword ("char", Token.CHAR);
535 AddKeyword ("checked", Token.CHECKED);
536 AddKeyword ("class", Token.CLASS);
537 AddKeyword ("const", Token.CONST);
538 AddKeyword ("continue", Token.CONTINUE);
539 AddKeyword ("decimal", Token.DECIMAL);
540 AddKeyword ("default", Token.DEFAULT);
541 AddKeyword ("delegate", Token.DELEGATE);
542 AddKeyword ("do", Token.DO);
543 AddKeyword ("double", Token.DOUBLE);
544 AddKeyword ("else", Token.ELSE);
545 AddKeyword ("enum", Token.ENUM);
546 AddKeyword ("event", Token.EVENT);
547 AddKeyword ("explicit", Token.EXPLICIT);
548 AddKeyword ("extern", Token.EXTERN);
549 AddKeyword ("false", Token.FALSE);
550 AddKeyword ("finally", Token.FINALLY);
551 AddKeyword ("fixed", Token.FIXED);
552 AddKeyword ("float", Token.FLOAT);
553 AddKeyword ("for", Token.FOR);
554 AddKeyword ("foreach", Token.FOREACH);
555 AddKeyword ("goto", Token.GOTO);
556 AddKeyword ("get", Token.GET);
557 AddKeyword ("if", Token.IF);
558 AddKeyword ("implicit", Token.IMPLICIT);
559 AddKeyword ("in", Token.IN);
560 AddKeyword ("int", Token.INT);
561 AddKeyword ("interface", Token.INTERFACE);
562 AddKeyword ("internal", Token.INTERNAL);
563 AddKeyword ("is", Token.IS);
564 AddKeyword ("lock", Token.LOCK);
565 AddKeyword ("long", Token.LONG);
566 AddKeyword ("namespace", Token.NAMESPACE);
567 AddKeyword ("new", Token.NEW);
568 AddKeyword ("null", Token.NULL);
569 AddKeyword ("object", Token.OBJECT);
570 AddKeyword ("operator", Token.OPERATOR);
571 AddKeyword ("out", Token.OUT);
572 AddKeyword ("override", Token.OVERRIDE);
573 AddKeyword ("params", Token.PARAMS);
574 AddKeyword ("private", Token.PRIVATE);
575 AddKeyword ("protected", Token.PROTECTED);
576 AddKeyword ("public", Token.PUBLIC);
577 AddKeyword ("readonly", Token.READONLY);
578 AddKeyword ("ref", Token.REF);
579 AddKeyword ("remove", Token.REMOVE);
580 AddKeyword ("return", Token.RETURN);
581 AddKeyword ("sbyte", Token.SBYTE);
582 AddKeyword ("sealed", Token.SEALED);
583 AddKeyword ("set", Token.SET);
584 AddKeyword ("short", Token.SHORT);
585 AddKeyword ("sizeof", Token.SIZEOF);
586 AddKeyword ("stackalloc", Token.STACKALLOC);
587 AddKeyword ("static", Token.STATIC);
588 AddKeyword ("string", Token.STRING);
589 AddKeyword ("struct", Token.STRUCT);
590 AddKeyword ("switch", Token.SWITCH);
591 AddKeyword ("this", Token.THIS);
592 AddKeyword ("throw", Token.THROW);
593 AddKeyword ("true", Token.TRUE);
594 AddKeyword ("try", Token.TRY);
595 AddKeyword ("typeof", Token.TYPEOF);
596 AddKeyword ("uint", Token.UINT);
597 AddKeyword ("ulong", Token.ULONG);
598 AddKeyword ("unchecked", Token.UNCHECKED);
599 AddKeyword ("unsafe", Token.UNSAFE);
600 AddKeyword ("ushort", Token.USHORT);
601 AddKeyword ("using", Token.USING);
602 AddKeyword ("virtual", Token.VIRTUAL);
603 AddKeyword ("void", Token.VOID);
604 AddKeyword ("volatile", Token.VOLATILE);
605 AddKeyword ("while", Token.WHILE);
606 AddKeyword ("partial", Token.PARTIAL);
607 AddKeyword ("where", Token.WHERE);
610 AddKeyword ("from", Token.FROM);
611 AddKeyword ("join", Token.JOIN);
612 AddKeyword ("on", Token.ON);
613 AddKeyword ("equals", Token.EQUALS);
614 AddKeyword ("select", Token.SELECT);
615 AddKeyword ("group", Token.GROUP);
616 AddKeyword ("by", Token.BY);
617 AddKeyword ("let", Token.LET);
618 AddKeyword ("orderby", Token.ORDERBY);
619 AddKeyword ("ascending", Token.ASCENDING);
620 AddKeyword ("descending", Token.DESCENDING);
621 AddKeyword ("into", Token.INTO);
623 // Contextual async keywords
624 AddKeyword ("async", Token.ASYNC);
625 AddKeyword ("await", Token.AWAIT);
627 keywords_preprocessor = new KeywordEntry<PreprocessorDirective>[10][];
629 AddPreprocessorKeyword ("region", PreprocessorDirective.Region);
630 AddPreprocessorKeyword ("endregion", PreprocessorDirective.Endregion);
631 AddPreprocessorKeyword ("if", PreprocessorDirective.If);
632 AddPreprocessorKeyword ("endif", PreprocessorDirective.Endif);
633 AddPreprocessorKeyword ("elif", PreprocessorDirective.Elif);
634 AddPreprocessorKeyword ("else", PreprocessorDirective.Else);
635 AddPreprocessorKeyword ("define", PreprocessorDirective.Define);
636 AddPreprocessorKeyword ("undef", PreprocessorDirective.Undef);
637 AddPreprocessorKeyword ("error", PreprocessorDirective.Error);
638 AddPreprocessorKeyword ("warning", PreprocessorDirective.Warning);
639 AddPreprocessorKeyword ("pragma", PreprocessorDirective.Pragma);
640 AddPreprocessorKeyword ("line", PreprocessorDirective.Line);
642 csharp_format_info = NumberFormatInfo.InvariantInfo;
643 styles = NumberStyles.Float;
646 int GetKeyword (char[] id, int id_len)
649 // Keywords are stored in an array of arrays grouped by their
650 // length and then by the first character
652 if (id_len >= keywords.Length || keywords [id_len] == null)
655 int first_index = id [0] - '_';
656 if (first_index > 'z' - '_')
659 var kwe = keywords [id_len] [first_index];
666 for (int i = 1; i < id_len; ++i) {
667 if (id [i] != kwe.Value [i]) {
673 } while (res == 0 && kwe != null);
687 if (!handle_remove_add)
691 if (parsing_declaration == 0)
692 res = Token.EXTERN_ALIAS;
695 if (peek_token () == Token.COLON) {
697 res = Token.DEFAULT_COLON;
701 if (!(handle_where && current_token != Token.COLON) && !query_parsing)
706 // A query expression is any expression that starts with `from identifier'
707 // followed by any token except ; , =
709 if (!query_parsing) {
710 if (lambda_arguments_parsing || parsing_block == 0) {
716 // HACK: to disable generics micro-parser, because PushPosition does not
717 // store identifiers array
718 parsing_generic_less_than = 1;
720 case Token.IDENTIFIER:
733 next_token = xtoken ();
734 if (next_token == Token.SEMICOLON || next_token == Token.COMMA || next_token == Token.EQUALS || next_token == Token.ASSIGN)
737 res = Token.FROM_FIRST;
738 query_parsing = true;
739 if (context.Settings.Version <= LanguageVersion.ISO_2)
740 Report.FeatureIsNotAvailable (context, Location, "query expressions");
743 Expression.Error_VoidInvalidInTheContext (Location, Report);
747 // HACK: A token is not a keyword so we need to restore identifiers buffer
748 // which has been overwritten before we grabbed the identifier
749 id_builder [0] = 'f'; id_builder [1] = 'r'; id_builder [2] = 'o'; id_builder [3] = 'm';
763 case Token.ASCENDING:
764 case Token.DESCENDING:
771 case Token.NAMESPACE:
772 // TODO: some explanation needed
773 check_incorrect_doc_comment ();
774 parsing_modifiers = false;
778 if (parsing_block > 0) {
783 // Save current position and parse next token.
786 next_token = token ();
787 bool ok = (next_token == Token.CLASS) ||
788 (next_token == Token.STRUCT) ||
789 (next_token == Token.INTERFACE) ||
790 (next_token == Token.VOID);
795 if (next_token == Token.VOID) {
796 if (context.Settings.Version <= LanguageVersion.ISO_2)
797 Report.FeatureIsNotAvailable (context, Location, "partial methods");
798 } else if (context.Settings.Version == LanguageVersion.ISO_1)
799 Report.FeatureIsNotAvailable (context, Location, "partial types");
804 if (next_token < Token.LAST_KEYWORD) {
805 Report.Error (267, Location,
806 "The `partial' modifier can be used only immediately before `class', `struct', `interface', or `void' keyword");
810 // HACK: A token is not a keyword so we need to restore identifiers buffer
811 // which has been overwritten before we grabbed the identifier
823 if (parsing_modifiers) {
825 // Skip attributes section or constructor called async
827 if (parsing_attribute_section || peek_token () == Token.OPEN_PARENS) {
832 } else if (parsing_block > 0) {
833 switch (peek_token ()) {
835 case Token.OPEN_PARENS_LAMBDA:
838 case Token.IDENTIFIER:
841 if (xtoken () != Token.ARROW) {
849 // peek_token could overwrite id_buffer
850 id_builder [0] = 'a'; id_builder [1] = 's'; id_builder [2] = 'y'; id_builder [3] = 'n'; id_builder [4] = 'c';
858 if (res == Token.ASYNC && context.Settings.Version <= LanguageVersion.V_4) {
859 Report.FeatureIsNotAvailable (context, Location, "asynchronous functions");
865 if (parsing_block == 0)
875 static PreprocessorDirective GetPreprocessorDirective (char[] id, int id_len)
878 // Keywords are stored in an array of arrays grouped by their
879 // length and then by the first character
881 if (id_len >= keywords_preprocessor.Length || keywords_preprocessor[id_len] == null)
882 return PreprocessorDirective.Invalid;
884 int first_index = id[0] - '_';
885 if (first_index > 'z' - '_')
886 return PreprocessorDirective.Invalid;
888 var kwe = keywords_preprocessor[id_len][first_index];
890 return PreprocessorDirective.Invalid;
892 PreprocessorDirective res = PreprocessorDirective.Invalid;
895 for (int i = 1; i < id_len; ++i) {
896 if (id[i] != kwe.Value[i]) {
902 } while (res == PreprocessorDirective.Invalid && kwe != null);
907 public Location Location {
909 return new Location (current_source, ref_line, col);
913 static bool is_identifier_start_character (int c)
915 return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c == '_' || Char.IsLetter ((char)c);
918 static bool is_identifier_part_character (char c)
920 if (c >= 'a' && c <= 'z')
923 if (c >= 'A' && c <= 'Z')
926 if (c == '_' || (c >= '0' && c <= '9'))
932 return is_identifier_part_character_slow_part (c);
935 static bool is_identifier_part_character_slow_part (char c)
937 if (Char.IsLetter (c))
940 switch (Char.GetUnicodeCategory (c)) {
941 case UnicodeCategory.ConnectorPunctuation:
943 // combining-character: A Unicode character of classes Mn or Mc
944 case UnicodeCategory.NonSpacingMark:
945 case UnicodeCategory.SpacingCombiningMark:
947 // decimal-digit-character: A Unicode character of the class Nd
948 case UnicodeCategory.DecimalDigitNumber:
955 public static bool IsKeyword (string s)
957 return keyword_strings.Contains (s);
961 // Open parens micro parser. Detects both lambda and cast ambiguity.
963 int TokenizeOpenParens ()
968 int bracket_level = 0;
969 bool is_type = false;
970 bool can_be_type = false;
973 ptoken = current_token;
976 switch (current_token) {
977 case Token.CLOSE_PARENS:
981 // Expression inside parens is lambda, (int i) =>
983 if (current_token == Token.ARROW)
984 return Token.OPEN_PARENS_LAMBDA;
987 // Expression inside parens is single type, (int[])
990 if (current_token == Token.SEMICOLON)
991 return Token.OPEN_PARENS;
993 return Token.OPEN_PARENS_CAST;
997 // Expression is possible cast, look at next token, (T)null
1000 switch (current_token) {
1001 case Token.OPEN_PARENS:
1004 case Token.IDENTIFIER:
1008 case Token.DELEGATE:
1018 case Token.UNCHECKED:
1024 // These can be part of a member access
1038 return Token.OPEN_PARENS_CAST;
1041 return Token.OPEN_PARENS;
1044 case Token.DOUBLE_COLON:
1045 if (ptoken != Token.IDENTIFIER && ptoken != Token.OP_GENERICS_GT)
1050 case Token.IDENTIFIER:
1054 if (bracket_level == 0) {
1060 case Token.OP_GENERICS_LT:
1062 case Token.DOUBLE_COLON:
1064 if (bracket_level == 0)
1068 can_be_type = is_type = false;
1088 if (bracket_level == 0)
1093 if (bracket_level == 0) {
1094 bracket_level = 100;
1095 can_be_type = is_type = false;
1099 case Token.OP_GENERICS_LT:
1100 case Token.OPEN_BRACKET:
1101 if (bracket_level++ == 0)
1105 case Token.OP_GENERICS_GT:
1106 case Token.CLOSE_BRACKET:
1110 case Token.INTERR_NULLABLE:
1112 if (bracket_level == 0)
1118 can_be_type = is_type = false;
1122 return Token.OPEN_PARENS;
1127 public static bool IsValidIdentifier (string s)
1129 if (s == null || s.Length == 0)
1132 if (!is_identifier_start_character (s [0]))
1135 for (int i = 1; i < s.Length; i ++)
1136 if (! is_identifier_part_character (s [i]))
1142 bool parse_less_than (ref int genericDimension)
1145 int the_token = token ();
1146 if (the_token == Token.OPEN_BRACKET) {
1148 the_token = token ();
1149 if (the_token == Token.EOF)
1152 if (the_token == Token.CLOSE_BRACKET)
1155 the_token = token ();
1156 } else if (the_token == Token.IN || the_token == Token.OUT) {
1157 the_token = token ();
1159 switch (the_token) {
1160 case Token.IDENTIFIER:
1178 case Token.OP_GENERICS_GT:
1179 genericDimension = 1;
1187 the_token = token ();
1188 } while (the_token == Token.COMMA);
1190 if (the_token == Token.OP_GENERICS_GT) {
1200 the_token = token ();
1202 if (the_token == Token.OP_GENERICS_GT)
1204 else if (the_token == Token.COMMA || the_token == Token.DOT || the_token == Token.DOUBLE_COLON)
1206 else if (the_token == Token.INTERR_NULLABLE || the_token == Token.STAR)
1208 else if (the_token == Token.OP_GENERICS_LT) {
1209 if (!parse_less_than (ref genericDimension))
1212 } else if (the_token == Token.OPEN_BRACKET) {
1214 the_token = token ();
1215 if (the_token == Token.CLOSE_BRACKET)
1217 else if (the_token == Token.COMMA)
1218 goto rank_specifiers;
1225 public int peek_token ()
1230 the_token = token ();
1237 // Tonizes `?' using custom disambiguous rules to return one
1238 // of following tokens: INTERR_NULLABLE, OP_COALESCING, INTERR
1240 // Tricky expression looks like:
1242 // Foo ? a = x ? b : c;
1244 int TokenizePossibleNullableType ()
1246 if (parsing_block == 0 || parsing_type > 0)
1247 return Token.INTERR_NULLABLE;
1249 int d = peek_char ();
1252 return Token.OP_COALESCING;
1256 return Token.INTERR_OPERATOR;
1260 if (d == ',' || d == ';' || d == '>')
1261 return Token.INTERR_NULLABLE;
1262 if (d == '*' || (d >= '0' && d <= '9'))
1263 return Token.INTERR;
1267 current_token = Token.NONE;
1276 case Token.OPEN_BRACKET_EXPR:
1277 next_token = Token.INTERR_OPERATOR;
1285 next_token = Token.INTERR;
1288 case Token.SEMICOLON:
1290 case Token.CLOSE_PARENS:
1291 case Token.OPEN_BRACKET:
1292 case Token.OP_GENERICS_GT:
1294 case Token.OP_COALESCING:
1296 next_token = Token.INTERR_NULLABLE;
1299 case Token.OPEN_PARENS:
1300 case Token.OPEN_PARENS_CAST:
1301 case Token.OPEN_PARENS_LAMBDA:
1306 case Token.OP_GENERICS_LT:
1307 case Token.OP_GENERICS_LT_DECL:
1308 case Token.GENERIC_DIMENSION:
1318 if (next_token == -1) {
1319 switch (xtoken ()) {
1321 case Token.SEMICOLON:
1322 case Token.OPEN_BRACE:
1324 next_token = Token.INTERR_NULLABLE;
1328 next_token = Token.INTERR;
1331 case Token.OPEN_PARENS:
1332 case Token.OPEN_PARENS_CAST:
1333 case Token.OPEN_PARENS_LAMBDA:
1337 case Token.OPEN_BRACKET:
1338 case Token.OPEN_BRACKET_EXPR:
1342 case Token.CLOSE_PARENS:
1346 case Token.OP_GENERICS_LT:
1347 case Token.OP_GENERICS_LT_DECL:
1348 case Token.GENERIC_DIMENSION:
1358 // All shorcuts failed, do it hard way
1360 while ((ntoken = xtoken ()) != Token.EOF) {
1362 case Token.OPEN_BRACE:
1365 case Token.OPEN_PARENS:
1366 case Token.OPEN_PARENS_CAST:
1367 case Token.OPEN_PARENS_LAMBDA:
1370 case Token.CLOSE_BRACE:
1373 case Token.OP_GENERICS_LT:
1374 case Token.OP_GENERICS_LT_DECL:
1375 case Token.GENERIC_DIMENSION:
1378 case Token.OPEN_BRACKET:
1379 case Token.OPEN_BRACKET_EXPR:
1382 case Token.CLOSE_BRACKET:
1385 case Token.CLOSE_PARENS:
1392 return Token.INTERR_NULLABLE;
1394 case Token.OP_GENERICS_GT:
1401 return Token.INTERR_NULLABLE;
1407 if (ntoken == Token.SEMICOLON)
1413 if (ntoken == Token.COMMA) {
1414 if (generics != 0 || brackets != 0)
1418 return Token.INTERR_NULLABLE;
1421 if (ntoken == Token.COLON) {
1422 if (++colons == interrs)
1427 if (ntoken == Token.INTERR) {
1433 next_token = colons != interrs && braces == 0 ? Token.INTERR_NULLABLE : Token.INTERR;
1442 bool decimal_digits (int c)
1445 bool seen_digits = false;
1448 if (number_pos == MaxNumberLength)
1449 Error_NumericConstantTooLong ();
1450 number_builder [number_pos++] = (char) c;
1454 // We use peek_char2, because decimal_digits needs to do a
1455 // 2-character look-ahead (5.ToString for example).
1457 while ((d = peek_char2 ()) != -1){
1458 if (d >= '0' && d <= '9'){
1459 if (number_pos == MaxNumberLength)
1460 Error_NumericConstantTooLong ();
1461 number_builder [number_pos++] = (char) d;
1471 static bool is_hex (int e)
1473 return (e >= '0' && e <= '9') || (e >= 'A' && e <= 'F') || (e >= 'a' && e <= 'f');
1476 static TypeCode real_type_suffix (int c)
1480 return TypeCode.Single;
1482 return TypeCode.Double;
1484 return TypeCode.Decimal;
1486 return TypeCode.Empty;
1490 ILiteralConstant integer_type_suffix (ulong ul, int c, Location loc)
1492 bool is_unsigned = false;
1493 bool is_long = false;
1496 bool scanning = true;
1509 // if we have not seen anything in between
1510 // report this error
1512 Report.Warning (78, 4, Location, "The `l' suffix is easily confused with the digit `1' (use `L' for clarity)");
1532 if (is_long && is_unsigned){
1533 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1537 // uint if possible, or ulong else.
1539 if ((ul & 0xffffffff00000000) == 0)
1540 return new UIntLiteral (context.BuiltinTypes, (uint) ul, loc);
1542 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1543 } else if (is_long){
1544 // long if possible, ulong otherwise
1545 if ((ul & 0x8000000000000000) != 0)
1546 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1548 return new LongLiteral (context.BuiltinTypes, (long) ul, loc);
1550 // int, uint, long or ulong in that order
1551 if ((ul & 0xffffffff00000000) == 0){
1552 uint ui = (uint) ul;
1554 if ((ui & 0x80000000) != 0)
1555 return new UIntLiteral (context.BuiltinTypes, ui, loc);
1557 return new IntLiteral (context.BuiltinTypes, (int) ui, loc);
1559 if ((ul & 0x8000000000000000) != 0)
1560 return new ULongLiteral (context.BuiltinTypes, ul, loc);
1562 return new LongLiteral (context.BuiltinTypes, (long) ul, loc);
1568 // given `c' as the next char in the input decide whether
1569 // we need to convert to a special type, and then choose
1570 // the best representation for the integer
1572 ILiteralConstant adjust_int (int c, Location loc)
1575 if (number_pos > 9){
1576 ulong ul = (uint) (number_builder [0] - '0');
1578 for (int i = 1; i < number_pos; i++){
1579 ul = checked ((ul * 10) + ((uint)(number_builder [i] - '0')));
1582 return integer_type_suffix (ul, c, loc);
1584 uint ui = (uint) (number_builder [0] - '0');
1586 for (int i = 1; i < number_pos; i++){
1587 ui = checked ((ui * 10) + ((uint)(number_builder [i] - '0')));
1590 return integer_type_suffix (ui, c, loc);
1592 } catch (OverflowException) {
1593 Error_NumericConstantTooLong ();
1594 return new IntLiteral (context.BuiltinTypes, 0, loc);
1596 catch (FormatException) {
1597 Report.Error (1013, Location, "Invalid number");
1598 return new IntLiteral (context.BuiltinTypes, 0, loc);
1602 ILiteralConstant adjust_real (TypeCode t, Location loc)
1604 string s = new string (number_builder, 0, number_pos);
1605 const string error_details = "Floating-point constant is outside the range of type `{0}'";
1608 case TypeCode.Decimal:
1610 return new DecimalLiteral (context.BuiltinTypes, decimal.Parse (s, styles, csharp_format_info), loc);
1611 } catch (OverflowException) {
1612 Report.Error (594, Location, error_details, "decimal");
1613 return new DecimalLiteral (context.BuiltinTypes, 0, loc);
1615 case TypeCode.Single:
1617 return new FloatLiteral (context.BuiltinTypes, float.Parse (s, styles, csharp_format_info), loc);
1618 } catch (OverflowException) {
1619 Report.Error (594, Location, error_details, "float");
1620 return new FloatLiteral (context.BuiltinTypes, 0, loc);
1624 return new DoubleLiteral (context.BuiltinTypes, double.Parse (s, styles, csharp_format_info), loc);
1625 } catch (OverflowException) {
1626 Report.Error (594, loc, error_details, "double");
1627 return new DoubleLiteral (context.BuiltinTypes, 0, loc);
1632 ILiteralConstant handle_hex (Location loc)
1638 while ((d = peek_char ()) != -1){
1640 number_builder [number_pos++] = (char) d;
1646 string s = new String (number_builder, 0, number_pos);
1649 if (number_pos <= 8)
1650 ul = System.UInt32.Parse (s, NumberStyles.HexNumber);
1652 ul = System.UInt64.Parse (s, NumberStyles.HexNumber);
1654 return integer_type_suffix (ul, peek_char (), loc);
1655 } catch (OverflowException){
1656 Error_NumericConstantTooLong ();
1657 return new IntLiteral (context.BuiltinTypes, 0, loc);
1659 catch (FormatException) {
1660 Report.Error (1013, Location, "Invalid number");
1661 return new IntLiteral (context.BuiltinTypes, 0, loc);
1666 // Invoked if we know we have .digits or digits
1668 int is_number (int c, bool dotLead)
1670 ILiteralConstant res;
1673 int read_start = reader.Position - 1;
1676 // Caller did peek_char
1686 int peek = peek_char ();
1688 if (peek == 'x' || peek == 'X') {
1689 val = res = handle_hex (loc);
1691 res.ParsedValue = reader.ReadChars (read_start, reader.Position - 1);
1694 return Token.LITERAL;
1702 // We need to handle the case of
1703 // "1.1" vs "1.string" (LITERAL_FLOAT vs NUMBER DOT IDENTIFIER)
1705 bool is_real = false;
1710 if (decimal_digits ('.')){
1716 val = res = adjust_int (-1, loc);
1719 res.ParsedValue = reader.ReadChars (read_start, reader.Position - 1);
1721 return Token.LITERAL;
1725 if (c == 'e' || c == 'E'){
1728 if (number_pos == MaxNumberLength)
1729 Error_NumericConstantTooLong ();
1730 number_builder [number_pos++] = (char) c;
1734 if (number_pos == MaxNumberLength)
1735 Error_NumericConstantTooLong ();
1736 number_builder [number_pos++] = '+';
1738 } else if (c == '-') {
1739 if (number_pos == MaxNumberLength)
1740 Error_NumericConstantTooLong ();
1741 number_builder [number_pos++] = '-';
1744 if (number_pos == MaxNumberLength)
1745 Error_NumericConstantTooLong ();
1746 number_builder [number_pos++] = '+';
1753 var type = real_type_suffix (c);
1754 if (type == TypeCode.Empty && !is_real) {
1755 res = adjust_int (c, loc);
1759 if (type != TypeCode.Empty) {
1763 res = adjust_real (type, loc);
1769 var chars = reader.ReadChars (read_start, reader.Position - (type == TypeCode.Empty && c > 0 ? 1 : 0));
1770 if (chars[chars.Length - 1] == '\r')
1771 Array.Resize (ref chars, chars.Length - 1);
1772 res.ParsedValue = chars;
1775 return Token.LITERAL;
1779 // Accepts exactly count (4 or 8) hex, no more no less
1781 int getHex (int count, out int surrogate, out bool error)
1786 int top = count != -1 ? count : 4;
1791 for (i = 0; i < top; i++){
1794 if (c >= '0' && c <= '9')
1795 c = (int) c - (int) '0';
1796 else if (c >= 'A' && c <= 'F')
1797 c = (int) c - (int) 'A' + 10;
1798 else if (c >= 'a' && c <= 'f')
1799 c = (int) c - (int) 'a' + 10;
1805 total = (total * 16) + c;
1807 int p = peek_char ();
1810 if (!is_hex ((char)p))
1816 if (total > 0x0010FFFF) {
1821 if (total >= 0x00010000) {
1822 surrogate = ((total - 0x00010000) % 0x0400 + 0xDC00);
1823 total = ((total - 0x00010000) / 0x0400 + 0xD800);
1830 int escape (int c, out int surrogate)
1866 v = getHex (-1, out surrogate, out error);
1872 return EscapeUnicode (d, out surrogate);
1875 Report.Error (1009, Location, "Unrecognized escape sequence `\\{0}'", ((char)d).ToString ());
1884 int EscapeUnicode (int ch, out int surrogate)
1888 ch = getHex (8, out surrogate, out error);
1890 ch = getHex (4, out surrogate, out error);
1894 Report.Error (1009, Location, "Unrecognized escape sequence");
1902 if (putback_char != -1) {
1911 if (peek_char () == '\n') {
1917 } else if (x == '\n') {
1922 } else if (x >= UnicodeLS && x <= UnicodePS) {
1931 void advance_line ()
1941 if (putback_char == -1)
1942 putback_char = reader.Read ();
1943 return putback_char;
1948 if (putback_char != -1)
1949 return putback_char;
1950 return reader.Peek ();
1953 public void putback (int c)
1955 if (putback_char != -1) {
1956 throw new InternalErrorException (string.Format ("Secondary putback [{0}] putting back [{1}] is not allowed", (char)putback_char, (char) c), Location);
1959 if (c == '\n' || col == 0 || (c >= UnicodeLS && c <= UnicodePS)) {
1960 // It won't happen though.
1970 public bool advance ()
1972 return peek_char () != -1 || CompleteOnEOF;
1975 public Object Value {
1981 public Object value ()
1988 current_token = xtoken ();
1989 return current_token;
1992 int TokenizePreprocessorIdentifier (out int c)
1994 // skip over white space
1997 } while (c == ' ' || c == '\t');
2001 while (c != -1 && c >= 'a' && c <= 'z') {
2002 id_builder[pos++] = (char) c;
2005 int peek = peek_char ();
2006 if (peek == 'U' || peek == 'u') {
2008 c = EscapeUnicode (c, out surrogate);
2009 if (surrogate != 0) {
2010 if (is_identifier_part_character ((char) c)) {
2011 id_builder[pos++] = (char) c;
2022 PreprocessorDirective get_cmd_arg (out string arg)
2026 tokens_seen = false;
2029 var cmd = GetPreprocessorDirective (id_builder, TokenizePreprocessorIdentifier (out c));
2031 if ((cmd & PreprocessorDirective.CustomArgumentsParsing) != 0)
2034 // skip over white space
2035 while (c == ' ' || c == '\t')
2038 int has_identifier_argument = (int)(cmd & PreprocessorDirective.RequiresArgument);
2041 while (c != -1 && c != '\n' && c != UnicodeLS && c != UnicodePS) {
2042 if (c == '\\' && has_identifier_argument >= 0) {
2043 if (has_identifier_argument != 0) {
2044 has_identifier_argument = 1;
2046 int peek = peek_char ();
2047 if (peek == 'U' || peek == 'u') {
2049 c = EscapeUnicode (c, out surrogate);
2050 if (surrogate != 0) {
2051 if (is_identifier_part_character ((char) c)) {
2052 if (pos == value_builder.Length)
2053 Array.Resize (ref value_builder, pos * 2);
2055 value_builder[pos++] = (char) c;
2061 has_identifier_argument = -1;
2063 } else if (c == '/' && peek_char () == '/') {
2065 // Eat single-line comments
2072 if (pos == value_builder.Length)
2073 Array.Resize (ref value_builder, pos * 2);
2075 value_builder[pos++] = (char) c;
2080 if (pos > MaxIdentifierLength)
2081 arg = new string (value_builder, 0, pos);
2083 arg = InternIdentifier (value_builder, pos);
2085 // Eat any trailing whitespaces
2086 arg = arg.Trim (simple_whitespaces);
2093 // Handles the #line directive
2095 bool PreProcessLine ()
2097 Location loc = Location;
2101 int length = TokenizePreprocessorIdentifier (out c);
2102 if (length == line_default.Length) {
2103 if (!IsTokenIdentifierEqual (line_default))
2106 current_source = source_file.SourceFile;
2107 if (!hidden_block_start.IsNull) {
2108 current_source.RegisterHiddenScope (hidden_block_start, loc);
2109 hidden_block_start = Location.Null;
2116 if (length == line_hidden.Length) {
2117 if (!IsTokenIdentifierEqual (line_hidden))
2120 if (hidden_block_start.IsNull)
2121 hidden_block_start = loc;
2126 if (length != 0 || c < '0' || c > '9') {
2128 // Eat any remaining characters to continue parsing on next line
2134 int new_line = TokenizeNumber (c);
2137 // Eat any remaining characters to continue parsing on next line
2140 return new_line != 0;
2145 // skip over white space
2148 } while (c == ' ' || c == '\t');
2149 } else if (c == '"') {
2153 if (c != '\n' && c != '/' && c != '"' && c != UnicodeLS && c != UnicodePS) {
2155 // Eat any remaining characters to continue parsing on next line
2159 Report.Error (1578, loc, "Filename, single-line comment or end-of-line expected");
2163 string new_file_name = null;
2165 new_file_name = TokenizeFileName (ref c);
2167 // skip over white space
2168 while (c == ' ' || c == '\t') {
2173 if (c == '\n' || c == UnicodeLS || c == UnicodePS) {
2175 } else if (c == '/') {
2176 ReadSingleLineComment ();
2179 // Eat any remaining characters to continue parsing on next line
2183 Error_EndLineExpected ();
2187 if (new_file_name != null) {
2188 current_source = context.LookupFile (source_file, new_file_name);
2189 source_file.AddIncludeFile (current_source);
2192 if (!hidden_block_start.IsNull) {
2193 current_source.RegisterHiddenScope (hidden_block_start, loc);
2194 hidden_block_start = Location.Null;
2197 ref_line = new_line;
2202 // Handles #define and #undef
2204 void PreProcessDefinition (bool is_define, string ident, bool caller_is_taking)
2206 if (ident.Length == 0 || ident == "true" || ident == "false"){
2207 Report.Error (1001, Location, "Missing identifier to pre-processor directive");
2211 if (ident.IndexOfAny (simple_whitespaces) != -1){
2212 Error_EndLineExpected ();
2216 if (!is_identifier_start_character (ident [0]))
2217 Report.Error (1001, Location, "Identifier expected: {0}", ident);
2219 foreach (char c in ident.Substring (1)){
2220 if (!is_identifier_part_character (c)){
2221 Report.Error (1001, Location, "Identifier expected: {0}", ident);
2226 if (!caller_is_taking)
2233 if (context.Settings.IsConditionalSymbolDefined (ident))
2236 source_file.AddDefine (ident);
2241 source_file.AddUndefine (ident);
2245 byte read_hex (out bool error)
2248 int c = get_char ();
2250 if ((c >= '0') && (c <= '9'))
2251 total = (int) c - (int) '0';
2252 else if ((c >= 'A') && (c <= 'F'))
2253 total = (int) c - (int) 'A' + 10;
2254 else if ((c >= 'a') && (c <= 'f'))
2255 total = (int) c - (int) 'a' + 10;
2264 if ((c >= '0') && (c <= '9'))
2265 total += (int) c - (int) '0';
2266 else if ((c >= 'A') && (c <= 'F'))
2267 total += (int) c - (int) 'A' + 10;
2268 else if ((c >= 'a') && (c <= 'f'))
2269 total += (int) c - (int) 'a' + 10;
2276 return (byte) total;
2280 // Parses #pragma checksum
2282 bool ParsePragmaChecksum ()
2285 // The syntax is ` "foo.txt" "{guid}" "hash"'
2287 // guid is predefined hash algorithm guid {406ea660-64cf-4c82-b6f0-42d48172a799} for md5
2289 int c = get_char ();
2294 string file_name = TokenizeFileName (ref c);
2296 // TODO: Any white-spaces count
2300 SourceFile file = context.LookupFile (source_file, file_name);
2302 if (get_char () != '"' || get_char () != '{')
2306 byte[] guid_bytes = new byte [16];
2309 for (; i < 4; i++) {
2310 guid_bytes [i] = read_hex (out error);
2315 if (get_char () != '-')
2318 for (; i < 10; i++) {
2319 guid_bytes [i] = read_hex (out error);
2323 guid_bytes [i++] = read_hex (out error);
2327 if (get_char () != '-')
2331 for (; i < 16; i++) {
2332 guid_bytes [i] = read_hex (out error);
2337 if (get_char () != '}' || get_char () != '"')
2340 // TODO: Any white-spaces count
2345 if (get_char () != '"')
2348 // Any length of checksum
2349 List<byte> checksum_bytes = new List<byte> (16);
2351 var checksum_location = Location;
2353 while (c != '"' && c != -1) {
2354 checksum_bytes.Add (read_hex (out error));
2362 ReadSingleLineComment ();
2363 } else if (get_char () != '"') {
2367 if (context.Settings.GenerateDebugInfo) {
2368 var chsum = checksum_bytes.ToArray ();
2370 if (file.HasChecksum) {
2371 if (!ArrayComparer.IsEqual (file.Checksum, chsum)) {
2372 // TODO: Report.SymbolRelatedToPreviousError
2373 Report.Warning (1697, 1, checksum_location, "Different checksum values specified for file `{0}'", file.Name);
2377 file.SetChecksum (guid_bytes, chsum);
2378 current_source.AutoGenerated = true;
2384 bool IsTokenIdentifierEqual (char[] identifier)
2386 for (int i = 0; i < identifier.Length; ++i) {
2387 if (identifier[i] != id_builder[i])
2394 int TokenizeNumber (int value)
2398 decimal_digits (value);
2399 uint ui = (uint) (number_builder[0] - '0');
2402 for (int i = 1; i < number_pos; i++) {
2403 ui = checked ((ui * 10) + ((uint) (number_builder[i] - '0')));
2407 } catch (OverflowException) {
2408 Error_NumericConstantTooLong ();
2413 string TokenizeFileName (ref int c)
2415 var string_builder = new StringBuilder ();
2416 while (c != -1 && c != '\n' && c != UnicodeLS && c != UnicodePS) {
2423 string_builder.Append ((char) c);
2426 if (string_builder.Length == 0) {
2427 Report.Warning (1709, 1, Location, "Filename specified for preprocessor directive is empty");
2431 return string_builder.ToString ();
2434 int TokenizePragmaNumber (ref int c)
2440 if (c >= '0' && c <= '9') {
2441 number = TokenizeNumber (c);
2445 // skip over white space
2446 while (c == ' ' || c == '\t')
2453 // skip over white space
2454 while (c == ' ' || c == '\t')
2459 ReadSingleLineComment ();
2461 Report.Warning (1692, 1, Location, "Invalid number");
2463 // Read everything till the end of the line or file
2471 void ReadToEndOfLine ()
2476 } while (c != -1 && c != '\n' && c != UnicodeLS && c != UnicodePS);
2479 void ReadSingleLineComment ()
2481 if (peek_char () != '/')
2482 Report.Warning (1696, 1, Location, "Single-line comment or end-of-line expected");
2484 // Read everything till the end of the line or file
2489 /// Handles #pragma directive
2491 void ParsePragmaDirective ()
2494 int length = TokenizePreprocessorIdentifier (out c);
2495 if (length == pragma_warning.Length && IsTokenIdentifierEqual (pragma_warning)) {
2496 length = TokenizePreprocessorIdentifier (out c);
2499 // #pragma warning disable
2500 // #pragma warning restore
2502 if (length == pragma_warning_disable.Length) {
2503 bool disable = IsTokenIdentifierEqual (pragma_warning_disable);
2504 if (disable || IsTokenIdentifierEqual (pragma_warning_restore)) {
2505 // skip over white space
2506 while (c == ' ' || c == '\t')
2511 if (c == '\n' || c == '/' || c == UnicodeLS || c == UnicodePS) {
2513 ReadSingleLineComment ();
2516 // Disable/Restore all warnings
2519 Report.RegisterWarningRegion (loc).WarningDisable (loc.Row);
2521 Report.RegisterWarningRegion (loc).WarningEnable (loc.Row);
2525 // Disable/Restore a warning or group of warnings
2529 code = TokenizePragmaNumber (ref c);
2532 Report.RegisterWarningRegion (loc).WarningDisable (loc, code, context.Report);
2534 Report.RegisterWarningRegion (loc).WarningEnable (loc, code, context);
2537 } while (code >= 0 && c != '\n' && c != -1 && c != UnicodeLS && c != UnicodePS);
2544 Report.Warning (1634, 1, Location, "Expected disable or restore");
2546 // Eat any remaining characters on the line
2555 if (length == pragma_checksum.Length && IsTokenIdentifierEqual (pragma_checksum)) {
2556 if (c != ' ' || !ParsePragmaChecksum ()) {
2557 Report.Warning (1695, 1, Location,
2558 "Invalid #pragma checksum syntax. Expected \"filename\" \"{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}\" \"XXXX...\"");
2564 Report.Warning (1633, 1, Location, "Unrecognized #pragma directive");
2567 bool eval_val (string s)
2574 return source_file.IsConditionalDefined (s);
2577 bool pp_primary (ref string s)
2586 s = s.Substring (1);
2587 bool val = pp_expr (ref s, false);
2588 if (s.Length > 0 && s [0] == ')'){
2589 s = s.Substring (1);
2592 Error_InvalidDirective ();
2596 if (is_identifier_start_character (c)){
2602 if (is_identifier_part_character (c)){
2606 bool v = eval_val (s.Substring (0, j));
2607 s = s.Substring (j);
2610 bool vv = eval_val (s);
2615 Error_InvalidDirective ();
2619 bool pp_unary (ref string s)
2626 if (len > 1 && s [1] == '='){
2627 Error_InvalidDirective ();
2630 s = s.Substring (1);
2631 return ! pp_primary (ref s);
2633 return pp_primary (ref s);
2635 Error_InvalidDirective ();
2640 bool pp_eq (ref string s)
2642 bool va = pp_unary (ref s);
2648 if (len > 2 && s [1] == '='){
2649 s = s.Substring (2);
2650 return va == pp_unary (ref s);
2652 Error_InvalidDirective ();
2655 } else if (s [0] == '!' && len > 1 && s [1] == '='){
2656 s = s.Substring (2);
2658 return va != pp_unary (ref s);
2667 bool pp_and (ref string s)
2669 bool va = pp_eq (ref s);
2675 if (len > 2 && s [1] == '&'){
2676 s = s.Substring (2);
2677 return (va & pp_and (ref s));
2679 Error_InvalidDirective ();
2688 // Evaluates an expression for `#if' or `#elif'
2690 bool pp_expr (ref string s, bool isTerm)
2692 bool va = pp_and (ref s);
2699 if (len > 2 && s [1] == '|'){
2700 s = s.Substring (2);
2701 return va | pp_expr (ref s, isTerm);
2703 Error_InvalidDirective ();
2708 Error_EndLineExpected ();
2716 bool eval (string s)
2718 bool v = pp_expr (ref s, true);
2727 void Error_NumericConstantTooLong ()
2729 Report.Error (1021, Location, "Integral constant is too large");
2732 void Error_InvalidDirective ()
2734 Report.Error (1517, Location, "Invalid preprocessor directive");
2737 void Error_UnexpectedDirective (string extra)
2741 "Unexpected processor directive ({0})", extra);
2744 void Error_TokensSeen ()
2746 Report.Error (1032, Location,
2747 "Cannot define or undefine preprocessor symbols after first token in file");
2750 void Eror_WrongPreprocessorLocation ()
2752 Report.Error (1040, Location,
2753 "Preprocessor directives must appear as the first non-whitespace character on a line");
2756 void Error_EndLineExpected ()
2758 Report.Error (1025, Location, "Single-line comment or end-of-line expected");
2762 // Raises a warning when tokenizer found documentation comment
2763 // on unexpected place
2765 void WarningMisplacedComment (Location loc)
2767 if (doc_state != XmlCommentState.Error) {
2768 doc_state = XmlCommentState.Error;
2769 Report.Warning (1587, 2, loc, "XML comment is not placed on a valid language element");
2774 // if true, then the code continues processing the code
2775 // if false, the code stays in a loop until another directive is
2777 // When caller_is_taking is false we ignore all directives except the ones
2778 // which can help us to identify where the #if block ends
2779 bool ParsePreprocessingDirective (bool caller_is_taking)
2782 bool region_directive = false;
2784 var directive = get_cmd_arg (out arg);
2787 // The first group of pre-processing instructions is always processed
2789 switch (directive) {
2790 case PreprocessorDirective.Region:
2791 region_directive = true;
2793 goto case PreprocessorDirective.If;
2795 case PreprocessorDirective.Endregion:
2796 if (ifstack == null || ifstack.Count == 0){
2797 Error_UnexpectedDirective ("no #region for this #endregion");
2800 int pop = ifstack.Pop ();
2802 if ((pop & REGION) == 0)
2803 Report.Error (1027, Location, "Expected `#endif' directive");
2805 return caller_is_taking;
2807 case PreprocessorDirective.If:
2808 if (ifstack == null)
2809 ifstack = new Stack<int> (2);
2811 int flags = region_directive ? REGION : 0;
2812 if (ifstack.Count == 0){
2813 flags |= PARENT_TAKING;
2815 int state = ifstack.Peek ();
2816 if ((state & TAKING) != 0) {
2817 flags |= PARENT_TAKING;
2821 if (eval (arg) && caller_is_taking) {
2822 ifstack.Push (flags | TAKING);
2825 ifstack.Push (flags);
2828 case PreprocessorDirective.Endif:
2829 if (ifstack == null || ifstack.Count == 0){
2830 Error_UnexpectedDirective ("no #if for this #endif");
2833 pop = ifstack.Pop ();
2835 if ((pop & REGION) != 0)
2836 Report.Error (1038, Location, "#endregion directive expected");
2838 if (arg.Length != 0) {
2839 Error_EndLineExpected ();
2842 if (ifstack.Count == 0)
2845 int state = ifstack.Peek ();
2846 return (state & TAKING) != 0;
2849 case PreprocessorDirective.Elif:
2850 if (ifstack == null || ifstack.Count == 0){
2851 Error_UnexpectedDirective ("no #if for this #elif");
2854 int state = ifstack.Pop ();
2856 if ((state & REGION) != 0) {
2857 Report.Error (1038, Location, "#endregion directive expected");
2861 if ((state & ELSE_SEEN) != 0){
2862 Error_UnexpectedDirective ("#elif not valid after #else");
2866 if ((state & TAKING) != 0) {
2871 if (eval (arg) && ((state & PARENT_TAKING) != 0)){
2872 ifstack.Push (state | TAKING);
2876 ifstack.Push (state);
2880 case PreprocessorDirective.Else:
2881 if (ifstack == null || ifstack.Count == 0){
2882 Error_UnexpectedDirective ("no #if for this #else");
2885 int state = ifstack.Peek ();
2887 if ((state & REGION) != 0) {
2888 Report.Error (1038, Location, "#endregion directive expected");
2892 if ((state & ELSE_SEEN) != 0){
2893 Error_UnexpectedDirective ("#else within #else");
2899 if (arg.Length != 0) {
2900 Error_EndLineExpected ();
2905 if ((state & PARENT_TAKING) != 0) {
2906 ret = (state & TAKING) == 0;
2914 ifstack.Push (state | ELSE_SEEN);
2918 case PreprocessorDirective.Define:
2919 if (any_token_seen){
2920 if (caller_is_taking)
2921 Error_TokensSeen ();
2922 return caller_is_taking;
2924 PreProcessDefinition (true, arg, caller_is_taking);
2925 return caller_is_taking;
2927 case PreprocessorDirective.Undef:
2928 if (any_token_seen){
2929 if (caller_is_taking)
2930 Error_TokensSeen ();
2931 return caller_is_taking;
2933 PreProcessDefinition (false, arg, caller_is_taking);
2934 return caller_is_taking;
2936 case PreprocessorDirective.Invalid:
2937 Report.Error (1024, Location, "Wrong preprocessor directive");
2942 // These are only processed if we are in a `taking' block
2944 if (!caller_is_taking)
2948 case PreprocessorDirective.Error:
2949 Report.Error (1029, Location, "#error: '{0}'", arg);
2952 case PreprocessorDirective.Warning:
2953 Report.Warning (1030, 1, Location, "#warning: `{0}'", arg);
2956 case PreprocessorDirective.Pragma:
2957 if (context.Settings.Version == LanguageVersion.ISO_1) {
2958 Report.FeatureIsNotAvailable (context, Location, "#pragma");
2961 ParsePragmaDirective ();
2964 case PreprocessorDirective.Line:
2965 Location loc = Location;
2966 if (!PreProcessLine ())
2967 Report.Error (1576, loc, "The line number specified for #line directive is missing or invalid");
2969 return caller_is_taking;
2972 throw new NotImplementedException (directive.ToString ());
2975 private int consume_string (bool quoted)
2979 Location start_location = Location;
2981 start_location = start_location - 1;
2984 int reader_pos = reader.Position;
2988 // Cannot use get_char because of \r in quoted strings
2989 if (putback_char != -1) {
2999 if (quoted && peek_char () == '"') {
3000 if (pos == value_builder.Length)
3001 Array.Resize (ref value_builder, pos * 2);
3003 value_builder[pos++] = (char) c;
3012 s = InternIdentifier (value_builder, pos);
3014 s = new string (value_builder, 0, pos);
3016 ILiteralConstant res = new StringLiteral (context.BuiltinTypes, s, start_location);
3019 res.ParsedValue = quoted ?
3020 reader.ReadChars (reader_pos - 2, reader.Position - 1) :
3021 reader.ReadChars (reader_pos - 1, reader.Position);
3024 return Token.LITERAL;
3027 if (c == '\n' || c == UnicodeLS || c == UnicodePS) {
3029 Report.Error (1010, Location, "Newline in constant");
3033 // Don't add \r to string literal
3034 if (pos > 1 && value_builder [pos - 1] == '\r')
3037 val = new StringLiteral (context.BuiltinTypes, new string (value_builder, 0, pos), start_location);
3038 return Token.LITERAL;
3042 } else if (c == '\\' && !quoted) {
3045 c = escape (c, out surrogate);
3048 if (surrogate != 0) {
3049 if (pos == value_builder.Length)
3050 Array.Resize (ref value_builder, pos * 2);
3052 value_builder[pos++] = (char) c;
3055 } else if (c == -1) {
3056 Report.Error (1039, Location, "Unterminated string literal");
3062 if (pos == value_builder.Length)
3063 Array.Resize (ref value_builder, pos * 2);
3065 value_builder[pos++] = (char) c;
3069 private int consume_identifier (int s)
3071 int res = consume_identifier (s, false);
3073 if (doc_state == XmlCommentState.Allowed)
3074 doc_state = XmlCommentState.NotAllowed;
3079 int consume_identifier (int c, bool quoted)
3082 // This method is very performance sensitive. It accounts
3083 // for approximately 25% of all parser time
3093 c = escape (c, out surrogate);
3094 if (surrogate != 0) {
3095 id_builder [pos++] = (char) c;
3100 id_builder [pos++] = (char) c;
3106 if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c == '_' || (c >= '0' && c <= '9')) {
3107 id_builder [pos++] = (char) c;
3114 c = escape (c, out surrogate);
3115 if (is_identifier_part_character ((char) c))
3116 id_builder[pos++] = (char) c;
3118 if (surrogate != 0) {
3124 } else if (is_identifier_part_character_slow_part ((char) c)) {
3125 id_builder [pos++] = (char) c;
3132 } catch (IndexOutOfRangeException) {
3133 Report.Error (645, Location, "Identifier too long (limit is 512 chars)");
3141 // Optimization: avoids doing the keyword lookup
3142 // on uppercase letters
3144 if (id_builder [0] >= '_' && !quoted) {
3145 int keyword = GetKeyword (id_builder, pos);
3146 if (keyword != -1) {
3147 val = ltb.Create (keyword == Token.AWAIT ? "await" : null, current_source, ref_line, column);
3152 string s = InternIdentifier (id_builder, pos);
3153 val = ltb.Create (s, current_source, ref_line, column);
3154 if (quoted && parsing_attribute_section)
3155 AddEscapedIdentifier (((LocatedToken) val).Location);
3157 return Token.IDENTIFIER;
3160 string InternIdentifier (char[] charBuffer, int length)
3163 // Keep identifiers in an array of hashtables to avoid needless
3166 var identifiers_group = identifiers[length];
3168 if (identifiers_group != null) {
3169 if (identifiers_group.TryGetValue (charBuffer, out s)) {
3173 // TODO: this should be number of files dependant
3174 // corlib compilation peaks at 1000 and System.Core at 150
3175 int capacity = length > 20 ? 10 : 100;
3176 identifiers_group = new Dictionary<char[], string> (capacity, new IdentifiersComparer (length));
3177 identifiers[length] = identifiers_group;
3180 char[] chars = new char[length];
3181 Array.Copy (charBuffer, chars, length);
3183 s = new string (charBuffer, 0, length);
3184 identifiers_group.Add (chars, s);
3188 public int xtoken ()
3192 // Whether we have seen comments on the current line
3193 bool comments_seen = false;
3194 while ((c = get_char ()) != -1) {
3197 col = ((col - 1 + tab_size) / tab_size) * tab_size;
3205 case 0xFEFF: // Ignore BOM anywhere in the file
3208 /* This is required for compatibility with .NET
3210 if (peek_char () == 0xBB) {
3213 if (get_char () == 0xBF)
3221 return consume_identifier (c);
3224 val = ltb.Create (current_source, ref_line, col);
3225 return Token.OPEN_BRACE;
3227 val = ltb.Create (current_source, ref_line, col);
3228 return Token.CLOSE_BRACE;
3230 // To block doccomment inside attribute declaration.
3231 if (doc_state == XmlCommentState.Allowed)
3232 doc_state = XmlCommentState.NotAllowed;
3234 val = ltb.Create (current_source, ref_line, col);
3236 if (parsing_block == 0 || lambda_arguments_parsing)
3237 return Token.OPEN_BRACKET;
3239 int next = peek_char ();
3243 return Token.OPEN_BRACKET;
3253 next = peek_token ();
3254 if (next == Token.COMMA || next == Token.CLOSE_BRACKET)
3255 return Token.OPEN_BRACKET;
3257 return Token.OPEN_BRACKET_EXPR;
3259 return Token.OPEN_BRACKET_EXPR;
3262 ltb.CreateOptional (current_source, ref_line, col, ref val);
3263 return Token.CLOSE_BRACKET;
3265 val = ltb.Create (current_source, ref_line, col);
3267 // An expression versions of parens can appear in block context only
3269 if (parsing_block != 0 && !lambda_arguments_parsing) {
3272 // Optmize most common case where we know that parens
3275 switch (current_token) {
3276 case Token.IDENTIFIER:
3285 case Token.DELEGATE:
3286 case Token.OP_GENERICS_GT:
3287 return Token.OPEN_PARENS;
3290 // Optimize using peek
3291 int xx = peek_char ();
3298 return Token.OPEN_PARENS;
3301 lambda_arguments_parsing = true;
3303 d = TokenizeOpenParens ();
3305 lambda_arguments_parsing = false;
3309 return Token.OPEN_PARENS;
3311 ltb.CreateOptional (current_source, ref_line, col, ref val);
3312 return Token.CLOSE_PARENS;
3314 ltb.CreateOptional (current_source, ref_line, col, ref val);
3317 ltb.CreateOptional (current_source, ref_line, col, ref val);
3318 return Token.SEMICOLON;
3320 val = ltb.Create (current_source, ref_line, col);
3323 val = ltb.Create (current_source, ref_line, col);
3324 return TokenizePossibleNullableType ();
3326 val = ltb.Create (current_source, ref_line, col);
3327 if (parsing_generic_less_than++ > 0)
3328 return Token.OP_GENERICS_LT;
3330 return TokenizeLessThan ();
3333 val = ltb.Create (current_source, ref_line, col);
3341 if (parsing_generic_less_than > 1 || (parsing_generic_less_than == 1 && d != '>')) {
3342 parsing_generic_less_than--;
3343 return Token.OP_GENERICS_GT;
3352 return Token.OP_SHIFT_RIGHT_ASSIGN;
3354 return Token.OP_SHIFT_RIGHT;
3360 val = ltb.Create (current_source, ref_line, col);
3364 } else if (d == '=') {
3365 d = Token.OP_ADD_ASSIGN;
3373 val = ltb.Create (current_source, ref_line, col);
3377 } else if (d == '=')
3378 d = Token.OP_SUB_ASSIGN;
3388 val = ltb.Create (current_source, ref_line, col);
3389 if (peek_char () == '='){
3396 val = ltb.Create (current_source, ref_line, col);
3407 return Token.ASSIGN;
3410 val = ltb.Create (current_source, ref_line, col);
3414 return Token.OP_AND;
3418 return Token.OP_AND_ASSIGN;
3420 return Token.BITWISE_AND;
3423 val = ltb.Create (current_source, ref_line, col);
3431 return Token.OP_OR_ASSIGN;
3433 return Token.BITWISE_OR;
3436 val = ltb.Create (current_source, ref_line, col);
3437 if (peek_char () == '='){
3439 return Token.OP_MULT_ASSIGN;
3446 val = ltb.Create (current_source, ref_line, col);
3448 return Token.OP_DIV_ASSIGN;
3451 // Handle double-slash comments.
3454 if (doc_processing) {
3455 if (peek_char () == '/') {
3457 // Don't allow ////.
3458 if ((d = peek_char ()) != '/') {
3459 if (doc_state == XmlCommentState.Allowed)
3460 handle_one_line_xml_comment ();
3461 else if (doc_state == XmlCommentState.NotAllowed)
3462 WarningMisplacedComment (Location - 3);
3465 if (xml_comment_buffer.Length > 0)
3466 doc_state = XmlCommentState.NotAllowed;
3472 any_token_seen |= tokens_seen;
3473 tokens_seen = false;
3474 comments_seen = false;
3476 } else if (d == '*'){
3478 bool docAppend = false;
3479 if (doc_processing && peek_char () == '*') {
3481 // But when it is /**/, just do nothing.
3482 if (peek_char () == '/') {
3486 if (doc_state == XmlCommentState.Allowed)
3488 else if (doc_state == XmlCommentState.NotAllowed) {
3489 WarningMisplacedComment (Location - 2);
3493 int current_comment_start = 0;
3495 current_comment_start = xml_comment_buffer.Length;
3496 xml_comment_buffer.Append (Environment.NewLine);
3499 while ((d = get_char ()) != -1){
3500 if (d == '*' && peek_char () == '/'){
3502 comments_seen = true;
3506 xml_comment_buffer.Append ((char) d);
3508 if (d == '\n' || d == UnicodeLS || d == UnicodePS){
3509 any_token_seen |= tokens_seen;
3510 tokens_seen = false;
3512 // Reset 'comments_seen' just to be consistent.
3513 // It doesn't matter either way, here.
3515 comments_seen = false;
3519 Report.Error (1035, Location, "End-of-file found, '*/' expected");
3522 update_formatted_doc_comment (current_comment_start);
3525 val = ltb.Create (current_source, ref_line, col);
3529 val = ltb.Create (current_source, ref_line, col);
3530 if (peek_char () == '='){
3532 return Token.OP_MOD_ASSIGN;
3534 return Token.PERCENT;
3537 val = ltb.Create (current_source, ref_line, col);
3538 if (peek_char () == '='){
3540 return Token.OP_XOR_ASSIGN;
3542 return Token.CARRET;
3545 val = ltb.Create (current_source, ref_line, col);
3546 if (peek_char () == ':') {
3548 return Token.DOUBLE_COLON;
3552 case '0': case '1': case '2': case '3': case '4':
3553 case '5': case '6': case '7': case '8': case '9':
3555 return is_number (c, false);
3557 case '\n': // white space
3560 any_token_seen |= tokens_seen;
3561 tokens_seen = false;
3562 comments_seen = false;
3568 if (d >= '0' && d <= '9')
3569 return is_number (c, true);
3571 ltb.CreateOptional (current_source, ref_line, col, ref val);
3575 if (tokens_seen || comments_seen) {
3576 Eror_WrongPreprocessorLocation ();
3580 if (ParsePreprocessingDirective (true))
3583 bool directive_expected = false;
3584 while ((c = get_char ()) != -1) {
3586 directive_expected = true;
3587 } else if (!directive_expected) {
3588 // TODO: Implement comment support for disabled code and uncomment this code
3590 // Eror_WrongPreprocessorLocation ();
3591 // return Token.ERROR;
3596 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\v' || c == UnicodeLS || c == UnicodePS)
3600 if (ParsePreprocessingDirective (false))
3603 directive_expected = false;
3607 tokens_seen = false;
3614 return consume_string (false);
3617 return TokenizeBackslash ();
3623 return consume_string (true);
3626 if (is_identifier_start_character (c)){
3627 return consume_identifier (c, true);
3630 Report.Error (1646, Location, "Keyword, identifier, or string expected after verbatim specifier: @");
3633 case EvalStatementParserCharacter:
3634 return Token.EVAL_STATEMENT_PARSER;
3635 case EvalCompilationUnitParserCharacter:
3636 return Token.EVAL_COMPILATION_UNIT_PARSER;
3637 case EvalUsingDeclarationsParserCharacter:
3638 return Token.EVAL_USING_DECLARATIONS_UNIT_PARSER;
3639 case DocumentationXref:
3640 return Token.DOC_SEE;
3643 if (is_identifier_start_character (c)) {
3645 return consume_identifier (c);
3648 if (char.IsWhiteSpace ((char) c))
3651 Report.Error (1056, Location, "Unexpected character `{0}'", ((char) c).ToString ());
3656 return Token.COMPLETE_COMPLETION;
3659 return Token.GENERATE_COMPLETION;
3666 int TokenizeBackslash ()
3669 int read_start = reader.Position;
3671 Location start_location = Location;
3672 int c = get_char ();
3675 val = new CharLiteral (context.BuiltinTypes, (char) c, start_location);
3676 Report.Error (1011, start_location, "Empty character literal");
3677 return Token.LITERAL;
3680 if (c == '\n' || c == UnicodeLS || c == UnicodePS) {
3681 Report.Error (1010, start_location, "Newline in constant");
3686 c = escape (c, out d);
3690 throw new NotImplementedException ();
3692 ILiteralConstant res = new CharLiteral (context.BuiltinTypes, (char) c, start_location);
3697 Report.Error (1012, start_location, "Too many characters in character literal");
3699 // Try to recover, read until newline or next "'"
3700 while ((c = get_char ()) != -1) {
3701 if (c == '\n' || c == '\'' || c == UnicodeLS || c == UnicodePS)
3707 res.ParsedValue = reader.ReadChars (read_start - 1, reader.Position);
3710 return Token.LITERAL;
3713 int TokenizeLessThan ()
3717 // Save current position and parse next token.
3719 int generic_dimension = 0;
3720 if (parse_less_than (ref generic_dimension)) {
3721 if (parsing_generic_declaration && (parsing_generic_declaration_doc || token () != Token.DOT)) {
3722 d = Token.OP_GENERICS_LT_DECL;
3724 if (generic_dimension > 0) {
3725 val = generic_dimension;
3727 return Token.GENERIC_DIMENSION;
3730 d = Token.OP_GENERICS_LT;
3737 parsing_generic_less_than = 0;
3746 return Token.OP_SHIFT_LEFT_ASSIGN;
3748 return Token.OP_SHIFT_LEFT;
3759 // Handles one line xml comment
3761 private void handle_one_line_xml_comment ()
3764 while ((c = peek_char ()) == ' ')
3765 get_char (); // skip heading whitespaces.
3766 while ((c = peek_char ()) != -1 && c != '\n' && c != '\r') {
3767 xml_comment_buffer.Append ((char) get_char ());
3769 if (c == '\r' || c == '\n')
3770 xml_comment_buffer.Append (Environment.NewLine);
3774 // Remove heading "*" in Javadoc-like xml documentation.
3776 private void update_formatted_doc_comment (int current_comment_start)
3778 int length = xml_comment_buffer.Length - current_comment_start;
3779 string [] lines = xml_comment_buffer.ToString (
3780 current_comment_start,
3781 length).Replace ("\r", "").Split ('\n');
3783 // The first line starts with /**, thus it is not target
3784 // for the format check.
3785 for (int i = 1; i < lines.Length; i++) {
3786 string s = lines [i];
3787 int idx = s.IndexOf ('*');
3790 if (i < lines.Length - 1)
3794 head = s.Substring (0, idx);
3795 foreach (char c in head)
3798 lines [i] = s.Substring (idx + 1);
3800 xml_comment_buffer.Remove (current_comment_start, length);
3801 xml_comment_buffer.Insert (current_comment_start, String.Join (Environment.NewLine, lines));
3805 // Checks if there was incorrect doc comments and raise
3808 public void check_incorrect_doc_comment ()
3810 if (xml_comment_buffer.Length > 0)
3811 WarningMisplacedComment (Location);
3815 // Consumes the saved xml comment lines (if any)
3816 // as for current target member or type.
3818 public string consume_doc_comment ()
3820 if (xml_comment_buffer.Length > 0) {
3821 string ret = xml_comment_buffer.ToString ();
3822 reset_doc_comment ();
3828 void reset_doc_comment ()
3830 xml_comment_buffer.Length = 0;
3833 public void cleanup ()
3835 if (ifstack != null && ifstack.Count >= 1) {
3836 int state = ifstack.Pop ();
3837 if ((state & REGION) != 0)
3838 Report.Error (1038, Location, "#endregion directive expected");
3840 Report.Error (1027, Location, "Expected `#endif' directive");
3846 // Indicates whether it accepts XML documentation or not.
3848 public enum XmlCommentState {
3849 // comment is allowed in this state.
3851 // comment is not allowed in this state.
3853 // once comments appeared when it is NotAllowed, then the
3854 // state is changed to it, until the state is changed to