Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(224)

Side by Side Diff: packages/charcode/README.md

Issue 1400473008: Roll Observatory packages and add a roll script (Closed) Base URL: git@github.com:dart-lang/observatory_pub_packages.git@master
Patch Set: Created 5 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « packages/charcode/LICENSE ('k') | packages/charcode/lib/ascii.dart » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
(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).
OLDNEW
« no previous file with comments | « packages/charcode/LICENSE ('k') | packages/charcode/lib/ascii.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698