New analyzer snapshot.

pkg/analyzer/lib/src/generated/source.dart

 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
+
 library engine.source;
+
 import 'java_core.dart';
 import 'sdk.dart' show DartSdk;
 import 'engine.dart' show AnalysisContext;
+
 /**
  * Instances of the class `SourceFactory` resolve possibly relative URI's against an existing
  * [Source].
  *
  * @coverage dart.engine.source
  */
 class SourceFactory {
-
   /**
    * The analysis context that this source factory is associated with.
    */
   AnalysisContext context;
 
   /**
    * The resolvers used to resolve absolute URI's.
    */
   List<UriResolver> _resolvers;
 
@@ skipping 174 matching lines @@
         if (result != null) {
           return result;
         }
       }
       return null;
     } else {
       return containingSource.resolveRelative(containedUri);
     }
   }
 }
+
 /**
  * The abstract class `UriResolver` defines the behavior of objects that are used to resolve
  * URI's for a source factory. Subclasses of this class are expected to resolve a single scheme of
  * absolute URI.
  *
  * @coverage dart.engine.source
  */
 abstract class UriResolver {
-
   /**
    * If this resolver should be used for URI's of the given kind, resolve the given absolute URI.
    * The URI does not need to have the scheme handled by this resolver if the kind matches. Return a
    * [Source] representing the file to which it was resolved, or `null` if it
    * could not be resolved.
    *
    * @param contentCache the content cache used to access the contents of the returned source
    * @param kind the kind of URI that was originally resolved in order to produce an encoding with
    *          the given URI
    * @param uri the URI to be resolved
@@ skipping 12 matching lines @@
   Source resolveAbsolute(ContentCache contentCache, Uri uri);
 
   /**
    * Return an absolute URI that represents the given source.
    *
    * @param source the source to get URI for
    * @return the absolute URI representing the given source, may be `null`
    */
   Uri restoreAbsolute(Source source) => null;
 }
+
 /**
  * The interface `Source` defines the behavior of objects representing source code that can be
  * compiled.
  *
  * @coverage dart.engine.source
  */
 abstract class Source {
-
   /**
    * An empty array of sources.
    */
   static final List<Source> EMPTY_ARRAY = new List<Source>(0);
 
   /**
    * Return `true` if the given object is a source that represents the same source code as
    * this source.
    *
    * @param object the object to be compared with this object
@@ skipping 92 matching lines @@
    * only intended to be invoked by a [SourceFactory]. Source factories will
    * only invoke this method if the URI is relative, so implementations of this method are not
    * required to, and generally do not, verify the argument. The result of invoking this method with
    * an absolute URI is intentionally left unspecified.
    *
    * @param relativeUri the relative URI to be resolved against the containing source
    * @return a [Source] representing the URI to which given URI was resolved
    */
   Source resolveRelative(Uri relativeUri);
 }
+
 /**
  * The interface `ContentReceiver` defines the behavior of objects that can receive the
  * content of a source.
  */
 abstract class Source_ContentReceiver {
-
   /**
    * Accept the contents of a source represented as a character buffer.
    *
    * @param contents the contents of the source
    * @param modificationTime the time at which the contents were last set
    */
   void accept(CharBuffer contents, int modificationTime);
 
   /**
    * Accept the contents of a source represented as a string.
    *
    * @param contents the contents of the source
    * @param modificationTime the time at which the contents were last set
    */
   void accept2(String contents, int modificationTime);
 }
+
 /**
  * The enumeration `SourceKind` defines the different kinds of sources that are known to the
  * analysis engine.
  *
  * @coverage dart.engine.source
  */
 class SourceKind extends Enum<SourceKind> {
-
   /**
    * A source containing HTML. The HTML might or might not contain Dart scripts.
    */
   static final SourceKind HTML = new SourceKind('HTML', 0);
 
   /**
    * A Dart compilation unit that is not a part of another library. Libraries might or might not
    * contain any directives, including a library directive.
    */
   static final SourceKind LIBRARY = new SourceKind('LIBRARY', 1);
 
   /**
    * A Dart compilation unit that is part of another library. Parts contain a part-of directive.
    */
   static final SourceKind PART = new SourceKind('PART', 2);
 
   /**
    * An unknown kind of source. Used both when it is not possible to identify the kind of a source
    * and also when the kind of a source is not known without performing a computation and the client
    * does not want to spend the time to identify the kind.
    */
   static final SourceKind UNKNOWN = new SourceKind('UNKNOWN', 3);
+
   static final List<SourceKind> values = [HTML, LIBRARY, PART, UNKNOWN];
+
   SourceKind(String name, int ordinal) : super(name, ordinal);
 }
+
 /**
  * The enumeration `UriKind` defines the different kinds of URI's that are known to the
  * analysis engine. These are used to keep track of the kind of URI associated with a given source.
  *
  * @coverage dart.engine.source
  */
 class UriKind extends Enum<UriKind> {
-
   /**
    * A 'dart:' URI.
    */
   static final UriKind DART_URI = new UriKind('DART_URI', 0, 0x64);
 
   /**
    * A 'file:' URI.
    */
   static final UriKind FILE_URI = new UriKind('FILE_URI', 1, 0x66);
 
   /**
    * A 'package:' URI referencing source package itself.
    */
   static final UriKind PACKAGE_SELF_URI = new UriKind('PACKAGE_SELF_URI', 2, 0x73);
 
   /**
    * A 'package:' URI.
    */
   static final UriKind PACKAGE_URI = new UriKind('PACKAGE_URI', 3, 0x70);
+
   static final List<UriKind> values = [DART_URI, FILE_URI, PACKAGE_SELF_URI, PACKAGE_URI];
 
   /**
    * Return the URI kind represented by the given encoding, or `null` if there is no kind with
    * the given encoding.
    *
    * @param encoding the single character encoding used to identify the URI kind to be returned
    * @return the URI kind represented by the given encoding
    */
   static UriKind fromEncoding(int encoding) {
@@ skipping 19 matching lines @@
 
   /**
    * Initialize a newly created URI kind to have the given encoding.
    *
    * @param encoding the single character encoding used to identify this kind of URI.
    */
   UriKind(String name, int ordinal, int encoding) : super(name, ordinal) {
     this.encoding = encoding;
   }
 }
+
 /**
  * A source range defines an [Element]'s source coordinates relative to its [Source].
  *
  * @coverage dart.engine.utilities
  */
 class SourceRange {
-
   /**
    * The 0-based index of the first character of the source code for this element, relative to the
    * source buffer in which this element is contained.
    */
   int offset = 0;
 
   /**
    * The number of characters of the source code for this element, relative to the source buffer in
    * which this element is contained.
    */
@@ skipping 30 matching lines @@
    */
   bool covers(SourceRange otherRange) => offset <= otherRange.offset && otherRange.end <= end;
 
   /**
    * @return `true` if this [SourceRange] ends in <code>otherRange</code>.
    */
   bool endsIn(SourceRange otherRange) {
     int thisEnd = end;
     return otherRange.contains(thisEnd);
   }
+
   bool operator ==(Object obj) {
     if (obj is! SourceRange) {
       return false;
     }
     SourceRange sourceRange = obj as SourceRange;
     return sourceRange.offset == offset && sourceRange.length == length;
   }
 
   /**
    * @return the 0-based index of the after-last character of the source code for this element,
    *         relative to the source buffer in which this element is contained.
    */
   int get end => offset + length;
 
   /**
    * @return the expanded instance of [SourceRange], which has the same center.
    */
   SourceRange getExpanded(int delta) => new SourceRange(offset - delta, delta + length + delta);
 
   /**
    * @return the instance of [SourceRange] with end moved on "delta".
    */
   SourceRange getMoveEnd(int delta) => new SourceRange(offset, length + delta);
 
   /**
    * @return the expanded translated of [SourceRange], with moved start and the same length.
    */
   SourceRange getTranslated(int delta) => new SourceRange(offset + delta, length);
+
   int get hashCode => 31 * offset + length;
 
   /**
    * @return `true` if this [SourceRange] intersects with given.
    */
   bool intersects(SourceRange other) {
     if (other == null) {
       return false;
     }
     if (end <= other.offset) {
       return false;
     }
     if (offset >= other.end) {
       return false;
     }
     return true;
   }
 
   /**
    * @return `true` if this [SourceRange] starts in <code>otherRange</code>.
    */
   bool startsIn(SourceRange otherRange) => otherRange.contains(offset);
+
   String toString() {
     JavaStringBuilder builder = new JavaStringBuilder();
     builder.append("[offset=");
     builder.append(offset);
     builder.append(", length=");
     builder.append(length);
     builder.append("]");
     return builder.toString();
   }
 }
+
 /**
  * The interface `SourceContainer` is used by clients to define a collection of sources
  *
  * Source containers are not used within analysis engine, but can be used by clients to group
  * sources for the purposes of accessing composite dependency information. For example, the Eclipse
  * client uses source containers to represent Eclipse projects, which allows it to easily compute
  * project-level dependencies.
  *
  * @coverage dart.engine.source
  */
 abstract class SourceContainer {
-
   /**
    * Determine if the specified source is part of the receiver's collection of sources.
    *
    * @param source the source in question
    * @return `true` if the receiver contains the source, else `false`
    */
   bool contains(Source source);
 }
+
 /**
  * Instances of the class `DartUriResolver` resolve `dart` URI's.
  *
  * @coverage dart.engine.source
  */
 class DartUriResolver extends UriResolver {
-
   /**
    * The Dart SDK against which URI's are to be resolved.
    */
   DartSdk dartSdk;
 
   /**
    * The name of the `dart` scheme.
    */
   static String _DART_SCHEME = "dart";
 
   /**
    * Return `true` if the given URI is a `dart:` URI.
    *
    * @param uri the URI being tested
    * @return `true` if the given URI is a `dart:` URI
    */
   static bool isDartUri(Uri uri) => _DART_SCHEME == uri.scheme;
 
   /**
    * Initialize a newly created resolver to resolve Dart URI's against the given platform within the
    * given Dart SDK.
    *
    * @param sdk the Dart SDK against which URI's are to be resolved
    */
   DartUriResolver(DartSdk sdk) {
     this.dartSdk = sdk;
   }
+
   Source fromEncoding(ContentCache contentCache, UriKind kind, Uri uri) {
     if (identical(kind, UriKind.DART_URI)) {
       return dartSdk.fromEncoding(contentCache, kind, uri);
     }
     return null;
   }
+
   Source resolveAbsolute(ContentCache contentCache, Uri uri) {
     if (!isDartUri(uri)) {
       return null;
     }
     return dartSdk.mapDartUri(uri.toString());
   }
 }
+
 /**
  * Instances of the class `LineInfo` encapsulate information about line and column information
  * within a source file.
  *
  * @coverage dart.engine.utilities
  */
 class LineInfo {
-
   /**
    * An array containing the offsets of the first character of each line in the source code.
    */
   List<int> _lineStarts;
 
   /**
    * Initialize a newly created set of line information to represent the data encoded in the given
    * array.
    *
    * @param lineStarts the offsets of the first character of each line in the source code
@@ skipping 16 matching lines @@
   LineInfo_Location getLocation(int offset) {
     int lineCount = _lineStarts.length;
     for (int i = 1; i < lineCount; i++) {
       if (offset < _lineStarts[i]) {
         return new LineInfo_Location(i, offset - _lineStarts[i - 1] + 1);
       }
     }
     return new LineInfo_Location(lineCount, offset - _lineStarts[lineCount - 1] + 1);
   }
 }
+
 /**
  * Instances of the class `Location` represent the location of a character as a line and
  * column pair.
  */
 class LineInfo_Location {
-
   /**
    * The one-based index of the line containing the character.
    */
   int lineNumber = 0;
 
   /**
    * The one-based index of the column containing the character.
    */
   int columnNumber = 0;
 
   /**
    * Initialize a newly created location to represent the location of the character at the given
    * line and column position.
    *
    * @param lineNumber the one-based index of the line containing the character
    * @param columnNumber the one-based index of the column containing the character
    */
   LineInfo_Location(int lineNumber, int columnNumber) {
     this.lineNumber = lineNumber;
     this.columnNumber = columnNumber;
   }
 }
+
 /**
  * Instances of class `ContentCache` hold content used to override the default content of a
  * [Source].
  *
  * @coverage dart.engine.source
  */
 class ContentCache {
-
   /**
    * A table mapping sources to the contents of those sources. This is used to override the default
    * contents of a source.
    */
   Map<Source, String> _contentMap = new Map<Source, String>();
 
   /**
    * A table mapping sources to the modification stamps of those sources. This is used when the
    * default contents of a source has been overridden.
    */
@@ skipping 35 matching lines @@
   String setContents(Source source, String contents) {
     if (contents == null) {
       _stampMap.remove(source);
       return _contentMap.remove(source);
     } else {
       _stampMap[source] = JavaSystem.currentTimeMillis();
       return javaMapPut(_contentMap, source, contents);
     }
   }
 }