5 releases
0.0.4 | Jul 5, 2020 |
---|---|
0.0.3 | Jul 5, 2020 |
0.0.2 | Jun 29, 2020 |
0.0.1 | May 26, 2020 |
0.0.0 | May 25, 2020 |
#17 in #sized
40KB
523 lines
bumpy_vector
A vector-like object where elements can be larger than one item. We use this primarily to represent objects in a binary that are made up of one or more bytes.
Goal
h2gb is a tool for analyzing binary files. Importantly, a binary file is a series of objects, each of which take up some number of bytes. We need a datatype to represent this unusual requirement, hence coming up with BumpyVector!
Usage
Instantiate with a maximum size, then use somewhat like a vector:
use bumpy_vector::{BumpyEntry, BumpyVector};
// Instantiate with a maximum size of 100 and a type of String
let mut v: BumpyVector<String> = BumpyVector::new(100);
// Create a 10-byte entry at the start
let entry: BumpyEntry<String> = BumpyEntry {
entry: String::from("hello"),
size: 10,
index: 0,
};
// Insert it into the BumpyVector
assert!(v.insert(entry).is_ok());
// Create another entry, this time from a tuple, that overlaps the first
let entry: BumpyEntry<String> = (String::from("error"), 1, 5).into();
assert!(v.insert(entry).is_err());
// Create an entry that's off the end of the object
let entry: BumpyEntry<String> = (String::from("error"), 1000, 5).into();
assert!(v.insert(entry).is_err());
// There is still one entry in this vector
assert_eq!(1, v.len());
Serialize / deserialize
When installed with the 'serialize' feature:
bumpy_vector = { version = "~0.0.0", features = ["serialize"] }
Serialization support using serde is enabled. The
BumpyVector
can be serialized with any of the serializers that Serde
supports, such as ron:
use bumpy_vector::BumpyVector;
// Assumes "serialize" feature is enabled: `bumpy_vector = { features = ["serialize"] }`
fn main() {
let mut h: BumpyVector<String> = BumpyVector::new(10);
h.insert((String::from("a"), 1, 2).into()).unwrap();
// Serialize
let serialized = ron::ser::to_string(&h).unwrap();
// Deserialize
let h: BumpyVector<String> = ron::de::from_str(&serialized).unwrap();
}
License: MIT
Dependencies
~0–315KB