fix WS
1 file changed
tree: aa27203834b8e74bdea4151601acd21fa541b59b
  1. lib/
  2. LICENSE
  3. pubspec.yaml
  4. README.md
README.md

Characterter code constants.

These libraries define symbolic names for some character codes.

Using

Import either one of the libraries:

import "package:charcode/ascii.dart"
import "package:charcode/html_entity.dart"

or import both libraries using the charcode.dart library:

import "package:charcode/charcode.dart"

Naming

The character names are preceded by a $ to avoid conflicting with other variables due to the short and common names (for example “$i”).

The characters that are valid in a Dart identifier directly follow the $. Examples: $_, $a, $B and $3. Other characters are given symbolic names.

The names of letters are lower-case for lower-case letters, and mixed- or upper-case for upper-case letters. The names of symbols are all lower-case, and omit suffixes like “sign”, “symbol” and “mark”. E xamples: $plus, $exclamation

The ascii.dart library defines a symbolic name for each ASCII character. For some chraceters, it has more than one name. For example the common $tab and the official $ht for the horisontal tab.

The html_entity.dart library defines a constant for each HTML 4.01 character entity, using the standard entity abbreviation, incluing its case. Examples: $nbsp for &nbps;, $aring for the lower-case å and $Aring for the upper-case Å.

The HTML entities includes all characters in the Latin-1 code page, greek letters and some mathematical symbols.

The charcode.dart library just exports both ascii.dart and html_entity.dart.

Rationale

The Dart language doesn't have character literals. If that ever happens, this library will be irrelevant. See [http://dartbug.com/4415](request for character literals).