#htmlescape #html #entity

htmlescape

A library for HTML entity encoding and decoding

1 unstable release

Uses old Rust 2015

0.3.1 Apr 2, 2017
Download history 7365/week @ 2021-10-04 7530/week @ 2021-10-11 7306/week @ 2021-10-18 7052/week @ 2021-10-25 7816/week @ 2021-11-01 7215/week @ 2021-11-08 7645/week @ 2021-11-15 6941/week @ 2021-11-22 7852/week @ 2021-11-29 8185/week @ 2021-12-06 9561/week @ 2021-12-13 7170/week @ 2021-12-20 6976/week @ 2021-12-27 7979/week @ 2022-01-03 7516/week @ 2022-01-10 7453/week @ 2022-01-17

30,741 downloads per month
Used in 94 crates (37 directly)

Apache-2.0 / MIT / MPL-2.0

54KB
606 lines

A HTML entity encoding library for Rust

Build Status

Example usage

All example assume a extern crate htmlescape; and use htmlescape::{relevant functions here}; is present.

###Encoding htmlescape::encode_minimal() encodes an input string using a minimal set of HTML entities.

let title = "Cats & dogs";
let tag = format!("<title>{}</title>", encode_minimal(title));
assert_eq!(tag.as_slice(), "<title>Cats &amp; dogs</title>");

There is also a htmlescape::encode_attribute() function for encoding strings that are to be used as html attribute values.

###Decoding htmlescape::decode_html() decodes an encoded string, replacing HTML entities with the corresponding characters. Named, hex, and decimal entities are supported. A Result value is returned, with either the decoded string in Ok, or an error in Err.

let encoded = "Cats&#x20;&amp;&#32;dogs";
let decoded = match decode_html(encoded) {
  Err(reason) => panic!("Error {:?} at character {}", reason.kind, reason.position),
  Ok(s) => s
};
assert_eq!(decoded.as_slice(), "Cats & dogs");

###Avoiding allocations Both the encoding and decoding functions are available in forms that take a Writer for output rather than returning an String. These version can be used to avoid allocation and copying if the returned String was just going to be written to a Writer anyway.

No runtime deps

&X