Type Alias gimli::read::EndianBuf

source ·

pub type EndianBuf<'input, Endian> = EndianSlice<'input, Endian>;

👎Deprecated: EndianBuf has been renamed to EndianSlice, use that instead.

Expand description

EndianBuf has been renamed to EndianSlice. For ease of upgrading across gimli versions, we export this type alias.

Aliased Type§

struct EndianBuf<'input, Endian> { /* private fields */ }

Implementations

source §

impl<'input, Endian> EndianSlice<'input, Endian>where Endian: Endianity,

source

pub fn new(slice: &'input [u8], endian: Endian) -> EndianSlice<'input, Endian>

Construct a new EndianSlice with the given slice and endianity.

source

pub fn slice(&self) -> &'input [u8]

Return a reference to the raw slice.

source

pub fn split_at( &self, idx: usize ) -> (EndianSlice<'input, Endian>, EndianSlice<'input, Endian>)

Split the slice in two at the given index, resulting in the tuple where the first item has range [0, idx), and the second has range [idx, len). Panics if the index is out of bounds.

source

pub fn find(&self, byte: u8) -> Option<usize>

Find the first occurrence of a byte in the slice, and return its index.

source

pub fn offset_from(&self, base: EndianSlice<'input, Endian>) -> usize

Return the offset of the start of the slice relative to the start of the given slice.

source

pub fn to_string(&self) -> Result<&'input str>

Converts the slice to a string using str::from_utf8.

Returns an error if the slice contains invalid characters.

source

pub fn to_string_lossy(&self) -> Cow<'input, str>

Converts the slice to a string, including invalid characters, using String::from_utf8_lossy.

source §

impl<'input, Endian> EndianSlice<'input, Endian>where Endian: Endianity,

Range Methods

Unfortunately, std::ops::Index must return a reference, so we can’t implement Index<Range<usize>> to return a new EndianSlice the way we would like to. Instead, we abandon fancy indexing operators and have these plain old methods.

source

pub fn range(&self, idx: Range<usize>) -> EndianSlice<'input, Endian>

Take the given start..end range of the underlying slice and return a new EndianSlice.

use gimli::{EndianSlice, LittleEndian};

let slice = &[0x01, 0x02, 0x03, 0x04];
let endian_slice = EndianSlice::new(slice, LittleEndian);
assert_eq!(endian_slice.range(1..3),
           EndianSlice::new(&slice[1..3], LittleEndian));

source

pub fn range_from(&self, idx: RangeFrom<usize>) -> EndianSlice<'input, Endian>

Take the given start.. range of the underlying slice and return a new EndianSlice.

use gimli::{EndianSlice, LittleEndian};

let slice = &[0x01, 0x02, 0x03, 0x04];
let endian_slice = EndianSlice::new(slice, LittleEndian);
assert_eq!(endian_slice.range_from(2..),
           EndianSlice::new(&slice[2..], LittleEndian));

source

pub fn range_to(&self, idx: RangeTo<usize>) -> EndianSlice<'input, Endian>

Take the given ..end range of the underlying slice and return a new EndianSlice.

use gimli::{EndianSlice, LittleEndian};

let slice = &[0x01, 0x02, 0x03, 0x04];
let endian_slice = EndianSlice::new(slice, LittleEndian);
assert_eq!(endian_slice.range_to(..3),
           EndianSlice::new(&slice[..3], LittleEndian));