#json #numbers #encode

encoder

Blazing fast encoder written in Rust

8 releases

0.2.4 Feb 5, 2024
0.2.3 Feb 2, 2024
0.2.2 Jan 25, 2024
0.1.2 Jan 19, 2024

#684 in Encoding

Download history 49/week @ 2024-03-13 16/week @ 2024-03-20 27/week @ 2024-03-27 22/week @ 2024-04-03 14/week @ 2024-04-10 23/week @ 2024-04-17 32/week @ 2024-04-24 4/week @ 2024-05-01 28/week @ 2024-05-08 39/week @ 2024-05-15 71/week @ 2024-05-22 16/week @ 2024-05-29 66/week @ 2024-06-05 99/week @ 2024-06-12 115/week @ 2024-06-19 236/week @ 2024-06-26

518 downloads per month
Used in 2 crates

MIT license

33KB
285 lines

Encoder

Blazing fast encoder written in Rust

Crates.io MIT licensed Documentation Build Status Build Status Build Status

Quick Start

Number encoding

use encoder::number::Encode;

fn main() {
    let mut buf = vec![];
    1_i32.encode(&mut buf);
    2_u32.encode(&mut buf);
    1_f32.encode(&mut buf);
    2_f64.encode(&mut buf);
    assert_eq!(String::from_utf8_lossy(&buf), r#"121.02.0"#);

    assert_eq!(1_i32.stringify(), "1");
    assert_eq!(2_u32.stringify(), "2");
    assert_eq!(1_f32.stringify(), "1.0");
    assert_eq!(2_f64.stringify(), "2.0");
}

Json encoding

use encoder::json::Encode;

fn main() {
    let mut buf = vec![];
    "Hello, 世界! 👋".encode(&mut buf);
    assert_eq!(String::from_utf8_lossy(&buf), r#""Hello, 世界! 👋""#);
    assert_eq!("Hello, 世界! 👋".stringify(), r#""Hello, 世界! 👋""#);
}

Benchmark

  • MacBook Air, Apple M2 24G, Sonoma 14.2.1
Module Name Time
number i8_max [1.1773 ns 1.1780 ns 1.1791 ns]
number i8_min [1.1773 ns 1.1774 ns 1.1776 ns]
number u8_max [1.1775 ns 1.1777 ns 1.1780 ns]
number u8_min [1.1773 ns 1.1775 ns 1.1777 ns]
number i16_max [7.3593 ns 7.3655 ns 7.3741 ns]
number i16_min [7.6517 ns 7.6528 ns 7.6539 ns]
number u16_max [1.1774 ns 1.1776 ns 1.1777 ns]
number u16_min [1.1771 ns 1.1772 ns 1.1774 ns]
number i32_max [7.0644 ns 7.0683 ns 7.0738 ns]
number i32_min [8.5311 ns 8.5325 ns 8.5340 ns]
number u32_max [1.3218 ns 1.3220 ns 1.3223 ns]
number u32_min [1.1774 ns 1.1777 ns 1.1780 ns]
number i64_max [10.301 ns 10.303 ns 10.306 ns]
number i64_min [10.864 ns 10.871 ns 10.878 ns]
number u64_max [1.3884 ns 1.3898 ns 1.3913 ns]
number u64_min [1.1750 ns 1.1752 ns 1.1755 ns]
number i128_max [19.795 ns 19.802 ns 19.809 ns]
number i128_min [17.784 ns 17.786 ns 17.788 ns]
number u128_max [13.505 ns 13.511 ns 13.520 ns]
number u128_min [4.6991 ns 4.6997 ns 4.7006 ns]
number isize_max [10.277 ns 10.282 ns 10.288 ns]
number isize_min [10.850 ns 10.854 ns 10.857 ns]
number usize_max [1.3721 ns 1.3728 ns 1.3736 ns]
number usize_min [1.1742 ns 1.1743 ns 1.1743 ns]
number true [1.1747 ns 1.1751 ns 1.1757 ns]
number false [1.1749 ns 1.1751 ns 1.1753 ns]
number f32_max [8.3038 ns 8.3095 ns 8.3153 ns]
number f32_min [8.4419 ns 8.4457 ns 8.4494 ns]
number f64_max [13.167 ns 13.169 ns 13.171 ns]
number f64_min [13.238 ns 13.241 ns 13.244 ns]
json char [8.8353 ns 8.8492 ns 8.8689 ns]
json str [12.660 ns 12.662 ns 12.664 ns]
json string [12.656 ns 12.658 ns 12.660 ns]
json option [5.5423 ns 5.5446 ns 5.5471 ns]
json array_raw [19.427 ns 19.430 ns 19.433 ns]
json array_vec [16.483 ns 16.485 ns 16.488 ns]
json array_vec_deque [20.307 ns 20.310 ns 20.313 ns]
json set_hash [19.272 ns 19.281 ns 19.295 ns]
json set_btree [25.390 ns 25.400 ns 25.413 ns]
json set_index [16.761 ns 16.773 ns 16.789 ns]
json object_hash [54.982 ns 55.042 ns 55.124 ns]
json object_btree [61.862 ns 61.924 ns 61.975 ns]
json object_index [55.700 ns 55.758 ns 55.837 ns]
  • AWS c5.2xlarge, 8C 16G, Ubuntu 22.04
Module Name Time
number i8_max [3.0645 ns 3.0648 ns 3.0650 ns]
number i8_min [2.7861 ns 2.7862 ns 2.7863 ns]
number u8_max [3.0649 ns 3.0650 ns 3.0651 ns]
number u8_min [2.7877 ns 2.7879 ns 2.7881 ns]
number i16_max [11.146 ns 11.147 ns 11.147 ns]
number i16_min [12.263 ns 12.264 ns 12.264 ns]
number u16_max [3.0648 ns 3.0650 ns 3.0653 ns]
number u16_min [2.7858 ns 2.7859 ns 2.7860 ns]
number i32_max [11.853 ns 11.860 ns 11.867 ns]
number i32_min [13.127 ns 13.132 ns 13.137 ns]
number u32_max [3.0660 ns 3.0662 ns 3.0663 ns]
number u32_min [2.7874 ns 2.7876 ns 2.7878 ns]
number i64_max [15.666 ns 15.667 ns 15.668 ns]
number i64_min [16.215 ns 16.217 ns 16.218 ns]
number u64_max [3.0650 ns 3.0651 ns 3.0652 ns]
number u64_min [2.7863 ns 2.7864 ns 2.7865 ns]
number i128_max [32.571 ns 32.573 ns 32.575 ns]
number i128_min [32.663 ns 32.665 ns 32.667 ns]
number u128_max [19.219 ns 19.220 ns 19.221 ns]
number u128_min [9.4300 ns 9.4523 ns 9.4748 ns]
number isize_max [15.665 ns 15.666 ns 15.666 ns]
number isize_min [16.203 ns 16.204 ns 16.205 ns]
number usize_max [3.0659 ns 3.0660 ns 3.0662 ns]
number usize_min [2.7862 ns 2.7864 ns 2.7866 ns]
number true [2.7860 ns 2.7861 ns 2.7862 ns]
number false [3.0650 ns 3.0652 ns 3.0654 ns]
number f32_max [18.247 ns 18.264 ns 18.281 ns]
number f32_min [18.287 ns 18.306 ns 18.324 ns]
number f64_max [25.632 ns 25.641 ns 25.650 ns]
number f64_min [25.569 ns 25.576 ns 25.584 ns]
json char [16.928 ns 16.959 ns 16.991 ns]
json str [17.812 ns 17.825 ns 17.838 ns]
json string [18.040 ns 18.053 ns 18.066 ns]
json option [9.5428 ns 9.5551 ns 9.5672 ns]
json array_raw [42.524 ns 42.558 ns 42.592 ns]
json array_vec [38.338 ns 38.343 ns 38.349 ns]
json array_vec_deque [37.892 ns 37.894 ns 37.896 ns]
json set_hash [36.211 ns 36.213 ns 36.215 ns]
json set_btree [45.391 ns 45.416 ns 45.442 ns]
json set_index [34.817 ns 34.818 ns 34.819 ns]
json object_hash [84.059 ns 84.226 ns 84.389 ns]
json object_btree [85.961 ns 86.056 ns 86.156 ns]
json object_index [72.589 ns 72.626 ns 72.660 ns]

License

This software is released under the MIT License.

Third-party libraries used herein remain the property of their respective authors. Modified library code resides in the 'lib' directory. Our sincere thanks to these authors.

Dependencies

~6.5MB
~121K SLoC