Skip to main content

Lanes16Word8

Struct Lanes16Word8 

#[repr(C, align(16))]
pub struct Lanes16Word8(pub [u8; 16]);
Expand description

Sixteen Word8 lanes = one 128-bit register (__m128i) — the BYTE-SHUFFLE carrier for SIMD text codecs (hex encode/decode). Its vocabulary is shuffle (pshufb, a 16-entry byte LUT), byte AND, per-byte shift, and the two byte interleaves — so a hex codec WRITTEN in Logos over it compiles to the pshufb sequence (AOT, when SSSE3 is statically enabled) and runs the byte-identical scalar spec on the interpreter. Lane i is byte i (index 0 low), matching _mm_loadu_si128.

Tuple Fields§

§0: [u8; 16]

Implementations§

§

impl Lanes16Word8

pub const LANES: usize = 16

The number of lanes.

pub const fn splat(x: u8) -> Lanes16Word8

Broadcast one byte into all sixteen lanes.

pub fn from_bytes(s: &[u8]) -> Lanes16Word8

Pack the first sixteen bytes of a slice (shorter slices zero-fill).

pub fn to_bytes(self) -> [u8; 16]

The sixteen lane bytes.

pub fn lane(self, i: usize) -> u8

Lane i (0-based).

pub fn shuffle(self, idx: Lanes16Word8) -> Lanes16Word8

Byte shuffle (pshufb): out[i] = if idx[i] & 0x80 { 0 } else { self[idx[i] & 0x0f] } — a 16-entry byte lookup, the core of SIMD hex codecs (nibble → hex char; hyphen strip).

pub fn bitand(self, o: Lanes16Word8) -> Lanes16Word8

Lane-wise AND (_mm_and_si128) — the low-nibble mask; auto-vectorizes to pand.

pub fn shr_bytes(self, n: u32) -> Lanes16Word8

Per-byte logical shift right by n — the high-nibble extract (v >> 4).

pub fn interleave_lo(self, o: Lanes16Word8) -> Lanes16Word8

Interleave the low eight bytes (_mm_unpacklo_epi8): [a0,b0,a1,b1,…,a7,b7].

pub fn interleave_hi(self, o: Lanes16Word8) -> Lanes16Word8

Interleave the high eight bytes (_mm_unpackhi_epi8): [a8,b8,…,a15,b15].

pub fn byte_add(self, o: Lanes16Word8) -> Lanes16Word8

Per-byte wrapping add (_mm_add_epi8) — the ASCII→nibble decode (lo + 9·hibit).

pub fn maddubs(self, o: Lanes16Word8) -> Lanes16Word8

Multiply-add adjacent byte pairs (pmaddubsw): self unsigned × o signed, summing pairs into eight saturating i16 lanes stored little-endian. Weights [16,1,…] fuse each nibble pair into the decoded byte (hex parse). Result carries 8 u16 in its 16 bytes; narrow with packus.

pub fn packus(self, o: Lanes16Word8) -> Lanes16Word8

Pack two 8×i16 vectors to 16×u8 with unsigned saturation (packuswb): self’s eight 16-bit lanes → bytes 0–7, o’s → bytes 8–15. Narrows the maddubs output back to bytes.

Trait Implementations§

§

impl BitAnd for Lanes16Word8

§

type Output = Lanes16Word8

The resulting type after applying the & operator.
§

fn bitand(self, o: Lanes16Word8) -> Lanes16Word8

Performs the & operation. Read more
§

impl Clone for Lanes16Word8

§

fn clone(&self) -> Lanes16Word8

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
§

impl Debug for Lanes16Word8

§

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

Formats the value using the given formatter. Read more
§

impl Hash for Lanes16Word8

§

fn hash<__H>(&self, state: &mut __H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
§

impl PartialEq for Lanes16Word8

§

fn eq(&self, other: &Lanes16Word8) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
§

impl Copy for Lanes16Word8

§

impl Eq for Lanes16Word8

§

impl StructuralPartialEq for Lanes16Word8

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,