nbt-rs 0.5.0

A simple rust library for dealing with NBT
Documentation 
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

//! Functions for serializing NBT data into bytes.

use crate::{
    traits::NbtSerialize,
    types::{NbtCompound, NbtString, NbtTagId},
};

/// Serializes a named `NbtCompound` into a `Vec` of bytes.
/// This function is guaranteed never to fail nor to generate any invalid nbt data.
///
/// # Examples
/// ```
/// let raw = include_bytes!("../tests/data/level_uncompressed.dat");
/// let (name, compound) = nbt_rs::parse_nbt(raw).unwrap();
/// let serialized = nbt_rs::serialize_nbt(&name, &compound);
/// assert_eq!(serialized, raw);
/// ```
pub fn serialize_nbt(name: &NbtString, data: &NbtCompound) -> Vec<u8> {
    // 4KiB is small enough not to matter compared to how much
    // does it speed thing up for an average nbt file.
    let mut buffer = Vec::with_capacity(4096);
    buffer.push(NbtTagId::Compound as u8);
    name.serialize_nbt_payload(&mut buffer);
    data.serialize_nbt_payload(&mut buffer);
    buffer
}