Struct Hash

Fetch the trit at the given index of this trit slice without first checking whether the index is in bounds. Providing an index that is not less than the length of this slice is undefined behaviour.

This is perhaps the ‘least bad’ unsafe function in this crate: not because any form of undefined behaviour is better or worse than another (after all, the point of undefined behaviour is that it is undefined) but because it’s the easiest to use correctly.

§Safety

An index with a value less then the result of Trits::len must be used. Any other value is undefined behaviour.

Source

pub unsafe fn set_unchecked(&mut self, index: usize, trit: T::Trit)

Available on crate feature ternary_encoding only.

Set the trit at the given index of this trit slice without first checking whether the index is in bounds. Providing an index that is not less than the length of this slice is undefined behaviour.

This is perhaps the ‘least bad’ unsafe function in this crate: not because any form of undefined behaviour is better or worse than another (after all, the point of undefined behaviour is that it is undefined) but because it’s the easiest to use correctly.

§Safety

An index with a value less then the result of Trits::len must be used. Any other value is undefined behaviour.

Source

pub fn get(&self, index: usize) -> Option<T::Trit>

Available on crate feature ternary_encoding only.

Fetch the trit at the given index of this trit slice, if the index is valid.

Source

pub fn set(&mut self, index: usize, trit: T::Trit)

Available on crate feature ternary_encoding only.

Set the trit at the given index of this mutable trit slice, if the index is valid.

§Panics

This function will panic if the index is not less than the length of this slice.

Source

pub fn iter( &self, ) -> impl DoubleEndedIterator<Item = T::Trit> + ExactSizeIterator<Item = T::Trit> + '_

Available on crate feature ternary_encoding only.

Returns an iterator over the trits in this slice.

Using this function is significantly faster than calling Trits::get in a loop and should be used where possible.

Source

pub fn subslice(&self, range: Range<usize>) -> &Self

Available on crate feature ternary_encoding only.

Returns a subslice of this slice with the given range of trits.

§Panics

This function will panic if called with a range that contains indices outside this slice, or the start of the range is greater than its end.

Source

pub fn subslice_mut(&mut self, range: Range<usize>) -> &mut Self

Available on crate feature ternary_encoding only.

Returns a mutable subslice of this mutable slice with the given range of trits.

§Panics

This function will panic if called with a range that contains indices outside this slice, or the start of the range is greater than its end.

Source

pub fn copy_from<U: RawEncoding<Trit = T::Trit> + ?Sized>( &mut self, trits: &Trits, )

Available on crate feature ternary_encoding only.

Copy the trits from a trit slice into this mutable trit slice (the encoding need not be equivalent).

§Panics

This function will panic if the length of the slices are different.

Source

pub fn fill(&mut self, trit: T::Trit)

Available on crate feature ternary_encoding only.

Fill this mutable trit slice with copied of the given trit.

Source

pub fn to_buf<U: RawEncodingBuf<Slice = T>>(&self) -> TritBuf

Available on crate feature ternary_encoding only.

Copy the contents of this trit slice into a new TritBuf with the same encoding. This function is analogous to to_vec method implemented on ordinary slices.

Source

pub fn chunks( &self, chunk_len: usize, ) -> impl DoubleEndedIterator<Item = &Self> + ExactSizeIterator<Item = &Self> + '_

Available on crate feature ternary_encoding only.

Return an iterator over distinct, non-overlapping subslices of this trit slice, each with the given chunk length. If the length of the trit slice is not a multiple of the given chunk length, the last slice provided by the iterator will be smaller to compensate.

§Panics

This function will panic if the given chunk length is 0.

Source

pub fn encode(&self) -> TritBuf
where U: RawEncodingBuf, U::Slice: RawEncoding<Trit = T::Trit>,

Available on crate feature ternary_encoding only.

Encode the contents of this trit slice into a TritBuf with a different encoding.

Source

pub fn iter_trytes( &self, ) -> impl DoubleEndedIterator<Item = Tryte> + ExactSizeIterator<Item = Tryte> + '_

Available on crate feature ternary_encoding only.

Returns an iterator over the trytes represented within this slice.

For encodings that are representation-compatible with trytes, such as T3B1, use Trits::as_trytes instead since it is faster and more capable.

Source

pub fn negate(&mut self)

Available on crate feature ternary_encoding only.

Negate each trit in this buffer.

This has the effect of making the trit buffer negative when expressed in numeric form.

Source

pub fn as_raw_slice(&self) -> &[T]

Available on crate feature ternary_encoding only.

View this trit slice as an ordinary slice of trits.

Source

pub fn as_raw_slice_mut(&mut self) -> &mut [T]

Available on crate feature ternary_encoding only.

View this mutable trit slice as an ordinary slice of mutable trits.

Source

pub fn chunks_mut( &mut self, chunk_len: usize, ) -> impl Iterator<Item = &mut Self> + '_

Available on crate feature ternary_encoding only.

Return an iterator over distinct, non-overlapping mutable subslices of this mutable trit slice, each with the given chunk length. If the length of the trit slice is not a multiple of the given chunk length, the last slice provided by the iterator will be smaller to compensate.