[go: up one dir, main page]

itoap 0.1.3

Even faster functions for printing integers with decimal format
Documentation
# Welcome to itoap 👋

[![Version](https://img.shields.io/crates/v/itoap)](https://crates.io/crates/itoap)
[![docs](https://docs.rs/itoap/badge.svg)](https://docs.rs/itoap)
[![Tests](https://github.com/Kogia-sima/itoap/workflows/Tests/badge.svg)](https://github.com/Kogia-sima/itoap/actions)
[![codecov](https://codecov.io/gh/Kogia-sima/itoap/branch/master/graph/badge.svg?token=76KRG3QI6U)](https://codecov.io/gh/Kogia-sima/itoap)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Kogia-sima/itoap/blob/master/LICENSE)

This crate provides even faster functions for printing integers with default format
than [itoa](https://crates.io/crates/itoa) crate.

## Comparison with `itoa` crate

If you want to write integers in decimal format to `String`, `Vec` or any other
contiguous buffer, then this crate is the best choice.

If you want to write integers to a `std::io::Write` or `std::fmt::Write`, 
[itoa](https://github.com/dtolnay/itoa) crate and `itoap` crate shows almost same
performance, but `itoap` outputs slightly larger binary.

The implementation is based on the `sse2` algorithm from
[itoa-benchmark](https://github.com/miloyip/itoa-benchmark) repository.
While `itoa` crate writes integers from **last** digits, this algorithm writes
from **first** digits. It allows integers to be written directly to the buffer.
That's why `itoap` is faster than `itoa`.

## Benchmark result

![Benchmark result](./bench.png)

## Author

👤 **Ryohei Machida**

* Github: [@Kogia-sima]https://github.com/Kogia-sima

## 🤝 Contributing

Contributions, issues and feature requests are welcome!

Feel free to check [issues page](https://github.com/Kogia-sima/itoap/issues). 

## Show your support

Give a ⭐️ if this project helped you!

## 📝 License

Copyright © 2014-2016 Milo Yip, 2020 [Ryohei Machida](https://github.com/Kogia-sima).

This project is [MIT](https://github.com/Kogia-sima/itoap/blob/master/LICENSE) licensed.

***
_This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_