OLD | NEW |
(Empty) | |
| 1 Character code constants. |
| 2 |
| 3 These libraries define symbolic names for some character codes. |
| 4 |
| 5 This is not an official Goggle package, and is not supported by Google. |
| 6 |
| 7 ## Using |
| 8 |
| 9 Import either one of the libraries: |
| 10 |
| 11 import "package:charcode/ascii.dart" |
| 12 import "package:charcode/html_entity.dart" |
| 13 |
| 14 or import both libraries using the `charcode.dart` library: |
| 15 |
| 16 import "package:charcode/charcode.dart" |
| 17 |
| 18 # Naming |
| 19 |
| 20 The character names are preceded by a `$` to avoid conflicting with other |
| 21 variables due to the short and common names (for example "$i"). |
| 22 |
| 23 The characters that are valid in a Dart identifier directly follow the `$`. |
| 24 Examples: `$_`, `$a`, `$B` and `$3`. Other characters are given symbolic names. |
| 25 |
| 26 The names of letters are lower-case for lower-case letters, and mixed- or |
| 27 upper-case for upper-case letters. The names of symbols are all lower-case, |
| 28 and omit suffixes like "sign", "symbol" and "mark". E |
| 29 xamples: `$plus`, `$exclamation` |
| 30 |
| 31 The `ascii.dart` library defines a symbolic name for each ASCII character. |
| 32 For some chraceters, it has more than one name. For example the common `$tab` |
| 33 and the official `$ht` for the horisontal tab. |
| 34 |
| 35 The `html_entity.dart` library defines a constant for each HTML 4.01 character |
| 36 entity, using the standard entity abbreviation, incluing its case. |
| 37 Examples: `$nbsp` for `&nbps;`, `$aring` for the lower-case `å` |
| 38 and `$Aring` for the upper-case `Å`. |
| 39 |
| 40 The HTML entities includes all characters in the Latin-1 code page, greek |
| 41 letters and some mathematical symbols. |
| 42 |
| 43 The `charcode.dart` library just exports both `ascii.dart` and |
| 44 `html_entity.dart`. |
| 45 |
| 46 # Rationale |
| 47 |
| 48 The Dart language doesn't have character literals. If that ever happens, this |
| 49 library will be irrelevant. Until then, this library can be used for the most |
| 50 common characters. |
| 51 See [http://dartbug.com/4415](request for character literals). |
OLD | NEW |