File: README.md

package info (click to toggle)
rust-entities 1.0.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, forky, sid, trixie
  • size: 300 kB
  • sloc: makefile: 4
file content (39 lines) | stat: -rw-r--r-- 1,196 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# entities [![Build Status](https://travis-ci.org/p-jackson/entities.svg?branch=master)](https://travis-ci.org/p-jackson/entities) [![Crates.io](https://img.shields.io/crates/v/entities.svg?maxAge=3600)](https://crates.io/crates/entities)

Provides the raw data needed to convert to and from HTML entities.

## Basic Usage

```rust
extern crate entities;
use entities::ENTITIES;

fn main() {
    let entity = ENTITIES
        .iter()
        .find(|e| e.entity == ">")
        .unwrap();

    assert_eq!(entity.characters, ">");
    assert_eq!(entity.entity, ">");
}
```

There isn't a 1-to-1 mapping of entities to "characters" which is why this
crate provides a flat array rather than a map—the best way to map the
entities depends on the problem _you're_ trying to solve.

If you want to create a mapping structure you can make one using static `str`
slices to reuse the statically allocated strings from this crate e.g.

```rust
fn make_mapping() -> HashMap<&'static str, &'static str> {
    let mut mapping = HashMap::new();
    mapping.insert(ENTITIES[0].entity, ENTITIES[0].characters);
    mapping
}
```

## Documentation

[https://docs.rs/entities](https://docs.rs/entities)