OLD | NEW |
---|---|
(Empty) | |
1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 library string_scanner.exception; | |
6 | |
7 import 'package:source_maps/source_maps.dart'; | |
8 | |
9 /// An exception thrown by a [StringScanner] that failed to parse a string. | |
10 class StringScannerException implements FormatException { | |
11 /// The error message. | |
12 final String message; | |
13 | |
14 /// The source string being parsed. | |
15 final String string; | |
Bob Nystrom
2014/05/28 21:28:57
Given that you use "sourceUrl" below, how about "s
nweiz
2014/05/28 23:56:34
I think it's better that it match [StringScanner.s
| |
16 | |
17 /// The URL of the source file being parsed. | |
18 /// | |
19 /// This may be `null`, indicating that the source URL is unknown. | |
20 final Uri sourceUrl; | |
21 | |
22 /// The span within [string] that caused the exception. | |
23 final Span span; | |
24 | |
25 StringScannerException(this.message, this.string, this.sourceUrl, this.span); | |
26 | |
27 /// Returns a detailed description of this exception. | |
28 /// | |
29 /// If [useColors] is true, the section of the source that caused the | |
30 /// exception will be colored using ANSI color codes. By default, it's colored | |
31 /// red, but a different ANSI code may passed via [color]. | |
32 String toString({bool useColors: false, String color}) { | |
Bob Nystrom
2014/05/28 21:28:57
I'd personally prefer not using a default value he
nweiz
2014/05/28 23:56:34
I generally agree for non-boolean values, but for
Bob Nystrom
2014/05/29 15:51:00
I definitely agree that users need to understand w
nweiz
2014/05/29 20:06:26
I don't think allowing users to pass null to any o
| |
33 return "Error on " + span.getLocationMessage( | |
34 message, useColors: useColors, color: color); | |
35 } | |
36 } | |
37 | |
OLD | NEW |