Struct Guid

pub struct Guid<'a> { /* private fields */ }

‘#GUID’ is a heap, which contains a sequence of 128-bit GUIDs

The Guid object provides helper methods to access the data within this blob, and parse / process it properly according to the standard.

Examples

use dotscope::metadata::streams::Guid;
let data = &[0u8; 32];
let guid_heap = Guid::from(data).unwrap();
// Accessing GUIDs would require valid data and index

Reference

• ‘https://ecma-international.org/wp-content/uploads/ECMA-335_6th_edition_june_2012.pdf’ - II.24.2.5

Implementations

impl<'a> Guid<'a>

pub fn from(data: &'a [u8]) -> Result<Guid<'a>>

Create a Guid object from a sequence of bytes

Arguments

• ‘data’ - The byte slice from which this object shall be created

Errors

Returns an error if the data is too small to contain a valid GUID (less than 16 bytes)

pub fn get(&self, index: usize) -> Result<Guid>

Returns the GUID at the specified index

GUID has to be build, hence no ‘view’ possible

Arguments

• ‘index’ - The index of the GUID to be accessed within the blob (comes from metadata tables)

Errors

Returns an error if the index is out of bounds or if the GUID data cannot be parsed

pub fn iter(&self) -> GuidIterator<'_>

Returns an iterator over all GUIDs in the heap

Provides access to all 16-byte GUID entries in sequential order. Each iteration yields a Result<(usize, uguid::Guid)> with the index and GUID value.

Examples

use dotscope::metadata::streams::Guid;

let data = &[0u8; 32]; // Two empty GUIDs
let guids = Guid::from(data).unwrap();

for result in guids.iter() {
    match result {
        Ok((index, guid)) => println!("GUID {}: {}", index, guid),
        Err(e) => eprintln!("Error: {}", e),
    }
}

Trait Implementations

impl<'a> IntoIterator for &'a Guid<'a>

type Item = Result<(usize, Guid), Error>

The type of the elements being iterated over.

type IntoIter = GuidIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.