OLD | NEW |
| (Empty) |
1 // Copyright (c) 2013, 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 part of dart.core; | |
6 | |
7 /// Opaque name used by mirrors, invocations and [Function.apply]. | |
8 abstract class Symbol { | |
9 /** | |
10 * Constructs a new Symbol. | |
11 * | |
12 * The name must be a valid public Dart member name, | |
13 * public constructor name, or library name, optionally qualified. | |
14 * | |
15 * A qualified name is a valid name preceded by a public identifier name | |
16 * and a '`.`', e.g., `foo.bar.baz=` is a qualified version of `baz=`. | |
17 * That means that the content of the [name] String must be either | |
18 * | |
19 * * a valid public Dart identifier | |
20 * (that is, an identifier not starting with "`_`"), | |
21 * * such an identifier followed by "=" (a setter name), | |
22 * * the name of a declarable operator | |
23 * (one of "`+`", "`-`", "`*`", "`/`", "`%`", "`~/`", "`&`", "`|`", | |
24 * "`^`", "`~`", "`<<`", "`>>`", "`<`", "`<=`", "`>`", "`>=`", "`==`", | |
25 * "`[]`", "`[]=`", or "`unary-`"), | |
26 * * any of the above preceeded by any number of qualifiers, | |
27 * where a qualifier is a non-private identifier followed by '`.`', | |
28 * * or the empty string (the default name of a library with no library | |
29 * name declaration). | |
30 * | |
31 * The following text is non-normative: | |
32 * | |
33 * Creating non-const Symbol instances may result in larger output. If | |
34 * possible, use [MirrorsUsed] in "dart:mirrors" to specify which names might | |
35 * be passed to this constructor. | |
36 */ | |
37 const factory Symbol(String name) = internal.Symbol; | |
38 | |
39 /** | |
40 * Returns a hash code compatible with [operator==]. | |
41 * | |
42 * Equal symbols have the same hash code. | |
43 */ | |
44 int get hashCode; | |
45 | |
46 /** | |
47 * Symbols are equal to other symbols that correspond to the same member name. | |
48 * | |
49 * Qualified member names, like `#foo.bar` are equal only if they have the | |
50 * same identifiers before the same final member name. | |
51 */ | |
52 bool operator ==(Object other); | |
53 } | |
OLD | NEW |