Trait rfc::core::convert::cast::CastFrom

pub trait CastFrom<Src: ?Sized, Neglect = ()> where
    Neglect: CastOptions, {
    unsafe fn unsafe_cast_from(src: Src) -> Self
    where
        Src: Sized,
        Self: Sized,
        Neglect: CastOptions;

    fn cast_from(src: Src) -> Self
    where
        Src: Sized,
        Self: Sized,
        Neglect: SafeCastOptions,
    { ... }
}

🔬 This is a nightly-only experimental API. (cast)

Instantiate Self from a value of type Src.

The reciprocal of CastInto.

Required methods

unsafe fn unsafe_cast_from(src: Src) -> Self where
    Src: Sized,
    Self: Sized,
    Neglect: CastOptions, 

🔬 This is a nightly-only experimental API. (cast)

Instantiate Self by casting a value of type Src, potentially safely.

Loading content...

Provided methods

fn cast_from(src: Src) -> Self where
    Src: Sized,
    Self: Sized,
    Neglect: SafeCastOptions, 

🔬 This is a nightly-only experimental API. (cast)

Instantiate Self by casting a value of type Src, safely.

Loading content...

Implementations on Foreign Types

impl<'i, 'o, Src, Dst, Neglect> CastFrom<&'i [Src], Neglect> for &'o [Dst] where
    Neglect: SliceCastOptions,
    &'o [Dst; 1]: TransmuteFrom<&'i [Src; usize::MAX], Neglect>, 

&[Src] 🠮 &[Dst]

If the sizes of Src and Dst differ, the length of the output slice is adjusted as-needed.

Static Options

See SliceCastOptions and SafeSliceCastOptions.

Example

let src : &[i8] = &[-1, -2, -3, -4][..];
let dst : &[[u8; 2]] = src.cast_into();
assert_eq!(dst, &[[-255, -254], [-253, -252]][..]);

impl<'i, 'o, Src, Dst, Neglect> CastFrom<&'i mut [Src], Neglect> for &'o mut [Dst] where
    Neglect: SliceCastOptions,
    &'o mut [Dst; 1]: TransmuteFrom<&'i mut [Src; usize::MAX], Neglect>, 

&mut [Src] 🠮 &mut [Dst]

If the sizes of Src and Dst differ, the length of the output slice is adjusted as-needed.

Static Options

See SliceCastOptions and SafeSliceCastOptions.

Example

let src : &mut [i8] = &mut [-1, -2, -3, -4][..];
let dst : &mut [[u8; 2]] = src.cast_into();
assert_eq!(dst, &mut [[-255, -254], [-253, -252]][..]);

impl<'i, 'o, Src, Dst, Neglect> CastFrom<&'i mut [Src], Neglect> for &'o [Dst] where
    Neglect: SliceCastOptions,
    &'o [Dst; 1]: TransmuteFrom<&'i mut [Src; usize::MAX], Neglect>, 

&mut [Src] 🠮 &[Dst]

If the sizes of Src and Dst differ, the length of the output slice is adjusted as-needed.

Static Options

See SliceCastOptions and SafeSliceCastOptions.

Example

let src : &mut [i8] = &mut [-1, -2, -3, -4][..];
let dst : &[[u8; 2]] = src.cast_into();
assert_eq!(dst, &[[-255, -254], [-253, -252]][..]);

impl<Src, Dst, Neglect> CastFrom<Vec<Src>, Neglect> for Vec<Dst> where
    Neglect: VecCastOptions,
    Dst: TransmuteFrom<Src, Neglect> + AlignEq<Src, Neglect> + SizeEq<Src, Neglect>, 

Vec<Src> 🠮 Vec<Dst>

Vec::from_raw_parts requires that the size and static alignment of Src and Dst be equal. NeglectAlignment is therefore ignored. We use the AlignEq and SizeEq traits to enforce these invariants statically.

Static Options

See VecCastOptions and SafeVecCastOptions.

Example

let src : Vec<i8> = vec![-1, -2, -3, -4];
let dst : Vec<u8> = src.cast_into();
assert_eq!(dst, vec![255, 254, 253, 252]);

Loading content...

Implementors

Loading content...