Struct Data

Source

pub struct Data(/* private fields */);

Expand description

A variable-size byte array wrapper for safely handling binary data of arbitrary length.

Data provides a flexible container for binary data that doesn’t have a fixed size, such as:

Encrypted memo fields
Variable-length signatures
Script data
Other protocol elements that can vary in size

Unlike Blob<N>, which is for fixed-size data, Data can hold any amount of bytes and can grow or shrink as needed.

§Zcash Concept Relation

Zcash uses variable-length data structures in many parts of the protocol:

Encrypted memos in shielded transactions
Script data in transparent transactions
Signatures and other cryptographic proofs

§Data Preservation

Data preserves variable-length binary blobs exactly as they appear in wallet files, ensuring that encrypted data, scripts, and other variable-length content maintain their exact representation during the migration process.

§Examples

// Create from raw bytes
let bytes = vec![1, 2, 3, 4, 5];
let data = Data::from_vec(bytes.clone());
assert_eq!(data.len(), 5);

// Access via indexing
assert_eq!(data[0], 1);
assert_eq!(&data[1..3], &[2, 3]);

Implementations§

Source §

impl Data

Source

pub fn new() -> Self

Creates a new empty Data instance.

§Examples

let data = Data::new();
assert!(data.is_empty());

Source

pub fn from_bytes(data: impl AsRef<[u8]>) -> Self

Creates a Data instance from anything that can be referenced as a byte slice.

This is a convenience method that allows creating a Data from various byte-containing types.

§Examples

// From a slice
let data1 = Data::from_bytes(&[1, 2, 3]);

// From a Vec
let data2 = Data::from_bytes(vec![1, 2, 3]);

// From another Data instance
let data3 = Data::from_bytes(&data1);

assert_eq!(data1, data2);
assert_eq!(data2, data3);

Source

pub fn len(&self) -> usize

Returns the number of bytes in the data.

§Examples

let data = Data::from_bytes(&[1, 2, 3]);
assert_eq!(data.len(), 3);

Source

pub fn is_empty(&self) -> bool

Returns true if the data contains no bytes.

§Examples

let empty = Data::new();
assert!(empty.is_empty());

let non_empty = Data::from_bytes(&[1, 2, 3]);
assert!(!non_empty.is_empty());

Source

pub fn to_vec(&self) -> Vec<u8> ⓘ

Converts the data to a Vec<u8>, creating a copy.

§Examples

let data = Data::from_bytes(&[1, 2, 3]);
let vec = data.to_vec();
assert_eq!(vec, vec![1, 2, 3]);

Source

pub fn from_slice(data: &[u8]) -> Self

Creates a Data instance from a byte slice.

§Examples

let slice = &[1, 2, 3];
let data = Data::from_slice(slice);
assert_eq!(data.to_vec(), slice);

Source

pub fn from_vec(data: Vec<u8>) -> Self

Creates a Data instance from a Vec<u8>, taking ownership of the vector.

This is more efficient than from_slice when you already have a vector, as it avoids making a copy of the data.

§Examples

let vec = vec![1, 2, 3];
let data = Data::from_vec(vec.clone());
assert_eq!(data.to_vec(), vec);

Source

pub fn from_hex(hex: &str) -> Result<Self>

Creates a Data instance from a hexadecimal string.

§Errors

Returns an error if the hex string is invalid (contains non-hex characters or has an odd length).

§Examples

let hex = "010203";
let data = Data::from_hex(hex).unwrap();
assert_eq!(data.to_vec(), vec![1, 2, 3]);

// Invalid hex string
let result = Data::from_hex("01020Z");
assert!(result.is_err());

Source

pub fn concat(a: &[&dyn AsRef<[u8]>]) -> Self

Concatenates multiple byte arrays into a single Data instance.

This is useful for combining multiple binary data sources into one.

§Examples


let data1: &[u8] = &[1, 2];
let data2: &[u8] = &[3, 4];
let combined = Data::concat(&[&data1, &data2]);

assert_eq!(combined.to_vec(), vec![1, 2, 3, 4]);

Trait Implementations§

Source §

impl AsRef<[u8]> for Data

Source §

fn as_ref(&self) -> &[u8] ⓘ

Converts this type into a shared reference of the (usually inferred) input type.

Source §

impl AsRef<Data> for Data

Source §

fn as_ref(&self) -> &Data

Converts this type into a shared reference of the (usually inferred) input type.

Source §

impl Clone for Data

Source §

fn clone(&self) -> Data

Returns a copy of the value. Read more

1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Source §

impl Debug for Data

Source §

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Source §

impl Default for Data

Source §

fn default() -> Self

Returns the “default value” for a type. Read more

Source §