Add helper methods for skipping Dart VM native bodies.

pkg/front_end/lib/src/fasta/parser/dart_vm_native.dart

+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file

[ahe, 2017/02/03 17:26:42]

It's 2017.

[ahe, 2017/02/06 10:17:54]

Done.

+// for details. All rights reserved. Use of this source code is governed by a

[ahe, 2017/02/03 17:26:42]

Add note to listener events about these helper methods.

[ahe, 2017/02/06 10:17:54]

Done.

+// BSD-style license that can be found in the LICENSE file.
+
+/// Implements support for Dart VM native method bodies on this form:
+///
+///     native STRING

[Siggi Cherem (dart-lang), 2017/02/03 17:18:52]

consider adding one more sentence saying that this is in a separate file because
parser.dart is spec compliant and this is not part of the spec syntax?

[ahe, 2017/02/06 10:17:54]

Done.

+library fasta.parser.dart_vm_native;
+
+import '../scanner/token.dart' show
+    Token;
+
+import '../scanner/token_constants.dart' show
+    STRING_TOKEN;
+
+import '../util/link.dart' show
+    Link;
+
+import 'parser.dart' show
+    optional;
+
+/// When parsing a Dart VM library file, we may encounter a native clause
+/// instead of a function body. This method skips such a clause.
+///
+/// This method is designed to be called when encountering
+/// [ErrorKind.ExpectedBlockToSkip] in [Listener.handleUnrecoverableError].
+Token skipNativeClause(Token token) {
+  if (!optional("native", token)) return null;
+  token = token.next;
+  if (token.kind != STRING_TOKEN) return null;
+  token = token.next;
+  if (!optional(";", token)) return null;
+  return token;
+}
+
+/// When parsing a Dart VM library file, we may encounter native getters like
+///
+///     int get length native "List_getLength";
+///
+/// This will result in [identifiers] being
+///
+///     [";", '"List_getLength"', "native", "length", "get"]
+///
+/// We need to remove '"List_getLength"' and "native" from that list.
+///
+/// This method designed to be called from [Listener.handleMemberName].
+Link<Token> removeNativeClause(Link<Token> identifiers) {
+  Link<Token> result = identifiers.tail;
+  if (result.head.kind != STRING_TOKEN) return identifiers;
+  result = result.tail;
+  if (result.isEmpty) return identifiers;
+  if (optional('native', result.head)) {
+    return result.tail.prepend(identifiers.head);
+  }
+  return identifiers;
+}