summaryrefslogtreecommitdiffstats
path: root/third_party/rust/urlencoding/README.md
blob: 5088cf1298016f90f8cce69ed3ac629e4750d978 (plain)
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
40
41
42
43
44
45
46
47
48
49
50
# urlencoding

[![Latest Version](https://img.shields.io/crates/v/urlencoding.svg)](https://crates.io/crates/urlencoding)

A Rust library for doing URL percentage encoding.

Installation
============

This crate can be downloaded through Cargo. To do so, add the following line to your `Cargo.toml` file, under `dependencies`:

```toml
urlencoding = "1.0.0"
```

Usage
=====

To encode a string, do the following:

```rust
extern crate urlencoding;

use urlencoding::encode;

fn main() {
  let encoded = encode("This string will be URL encoded.");
  println!("{}", encoded);
  // This%20string%20will%20be%20URL%20encoded.
}
```

To decode a string, it's only slightly different:

```rust
extern crate urlencoding;

use urlencoding::decode;

fn main() {
  let decoded = decode("%F0%9F%91%BE%20Exterminate%21");
  println!("{}", decoded.unwrap());
  // 👾 Exterminate!
}
```

License
=======

This project is licensed under the MIT license, Copyright (c) 2017 Bertram Truong. For more information see the `LICENSE` file.