Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/BurntSushi/byteorder
Rust library for reading/writing numbers in big-endian and little-endian.
https://github.com/BurntSushi/byteorder
Last synced: about 2 months ago
JSON representation
Rust library for reading/writing numbers in big-endian and little-endian.
- Host: GitHub
- URL: https://github.com/BurntSushi/byteorder
- Owner: BurntSushi
- License: unlicense
- Created: 2015-02-03T23:28:34.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-02T05:23:17.000Z (8 months ago)
- Last Synced: 2024-05-16T09:05:02.197Z (7 months ago)
- Language: Rust
- Size: 280 KB
- Stars: 938
- Watchers: 13
- Forks: 143
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
Awesome Lists containing this project
- awesome-rust-cn - BurntSushi/byteorder - endian, little-endian and native byte orders [<img src="https://api.travis-ci.org/BurntSushi/byteorder.svg?branch=master">](https://travis-ci.org/BurntSushi/byteorder) (Libraries / Encoding)
- awesome-rust - BurntSushi/byteorder - endian, little-endian and native byte orders [<img src="https://api.travis-ci.org/BurntSushi/byteorder.svg?branch=master">](https://travis-ci.org/BurntSushi/byteorder) (Libraries / Encoding)
- awesome-rust - BurntSushi/byteorder - endian, little-endian and native byte orders (Libraries / Encoding)
- awesome-rust-cn - BurntSushi/byteorder
- awesome-rust-zh - BurntSushi/byteorder - 支持 大-字节序，小-字节序 和 原生 字节顺序[<img src="https://api.travis-ci.org/BurntSushi/byteorder.svg?branch=master">](https://travis-ci.org/BurntSushi/byteorder) (库 / 编码(Encoding))
- awesome-rust - BurntSushi/byteorder - Supports big-endian, little-endian and native byte orders (Libraries / Encoding)
- awesome-rust - BurntSushi/byteorder - endian, little-endian and native byte orders [<img src="https://api.travis-ci.org/BurntSushi/byteorder.svg?branch=master">](https://travis-ci.org/BurntSushi/byteorder) (库 Libraries / 加密 Encoding)
- fucking-awesome-rust - BurntSushi/byteorder - Supports big-endian, little-endian and native byte orders (Libraries / Encoding)
- fucking-awesome-rust - BurntSushi/byteorder - Supports big-endian, little-endian and native byte orders (Libraries / Encoding)
README
byteorder
=========
This crate provides convenience methods for encoding and decoding
numbers in either big-endian or little-endian order.
[](https://github.com/BurntSushi/byteorder/actions)
[](https://crates.io/crates/byteorder)
Dual-licensed under MIT or the [UNLICENSE](https://unlicense.org/).
### Documentation
https://docs.rs/byteorder
### Installation
This crate works with Cargo and is on
[crates.io](https://crates.io/crates/byteorder). Add it to your `Cargo.toml`
like so:
```toml
[dependencies]
byteorder = "1"
```
If you want to augment existing `Read` and `Write` traits, then import the
extension methods like so:
```rust
use byteorder::{ReadBytesExt, WriteBytesExt, BigEndian, LittleEndian};
```
For example:
```rust
use std::io::Cursor;
use byteorder::{BigEndian, ReadBytesExt};
let mut rdr = Cursor::new(vec![2, 5, 3, 0]);
// Note that we use type parameters to indicate which kind of byte order
// we want!
assert_eq!(517, rdr.read_u16::().unwrap());
assert_eq!(768, rdr.read_u16::().unwrap());
```
### `no_std` crates
This crate has a feature, `std`, that is enabled by default. To use this crate
in a `no_std` context, add the following to your `Cargo.toml`:
```toml
[dependencies]
byteorder = { version = "1", default-features = false }
```
### Minimum Rust version policy
This crate's minimum supported `rustc` version is `1.60.0`.
The current policy is that the minimum Rust version required to use this crate
can be increased in minor version updates. For example, if `crate 1.0` requires
Rust 1.20.0, then `crate 1.0.z` for all values of `z` will also require Rust
1.20.0 or newer. However, `crate 1.y` for `y > 0` may require a newer minimum
version of Rust.
In general, this crate will be conservative with respect to the minimum
supported version of Rust.
### Alternatives
Note that as of Rust 1.32, the standard numeric types provide built-in methods
like `to_le_bytes` and `from_le_bytes`, which support some of the same use
cases.