pub trait TypeName {
    // Required method
    fn build_type_name<F: FnMut(&str)>(f: F);
}
Expand description

Builds a name for a type.

An implementation can be derived automatically with #[derive(TypeName)]. See TypeName for more details.

Names cannot be guaranteed to be unique and although they are usually suitable to use as keys, precautions should be taken to ensure that if name collisions happen that they are detected and fixable.

§Examples

Most of the time, #[derive(TypeName)] will suit your needs. However, if you need more control, you can always implement it manually:

use rkyv_typename::TypeName;

struct Example;

impl TypeName for Example {
    fn build_type_name<F: FnMut(&str)>(mut f: F) {
        f("CoolStruct");
    }
}

struct GenericExample<T, U, V>(T, U, V);

impl<
    T: TypeName,
    U: TypeName,
    V: TypeName
> TypeName for GenericExample<T, U, V> {
    fn build_type_name<F: FnMut(&str)>(mut f: F) {
        f("CoolGeneric<");
        T::build_type_name(&mut f);
        f(", ");
        U::build_type_name(&mut f);
        f(", ");
        V::build_type_name(&mut f);
        f(">");
    }
}

fn type_name<T: TypeName>() -> String {
    let mut result = String::new();
    T::build_type_name(|piece| result += piece);
    result
}

assert_eq!(type_name::<Example>(), "CoolStruct");
assert_eq!(
    type_name::<GenericExample<i32, Option<String>, Example>>(),
    "CoolGeneric<i32, core::option::Option<alloc::string::String>, CoolStruct>"
);

Required Methods§

source

fn build_type_name<F: FnMut(&str)>(f: F)

Submits the pieces of the type name to the given function.

Object Safety§

This trait is not object safe.

Implementations on Foreign Types§

source§

impl TypeName for bool

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for char

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for f32

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for f64

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for i8

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for i16

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for i32

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for i64

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for i128

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for str

source§

impl TypeName for u8

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for u16

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for u32

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for u64

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for u128

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for ()

source§

fn build_type_name<F: FnMut(&'static str)>(f: F)

source§

impl TypeName for String

source§

impl<T0: TypeName> TypeName for (T0,)

source§

impl<T1: TypeName, T0: TypeName> TypeName for (T1, T0)

source§

impl<T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T2, T1, T0)

source§

impl<T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T3, T2, T1, T0)

source§

impl<T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T4, T3, T2, T1, T0)

source§

impl<T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T5, T4, T3, T2, T1, T0)

source§

impl<T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T6, T5, T4, T3, T2, T1, T0)

source§

impl<T7: TypeName, T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T7, T6, T5, T4, T3, T2, T1, T0)

source§

impl<T8: TypeName, T7: TypeName, T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T8, T7, T6, T5, T4, T3, T2, T1, T0)

source§

impl<T9: TypeName, T8: TypeName, T7: TypeName, T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T9, T8, T7, T6, T5, T4, T3, T2, T1, T0)

source§

impl<T10: TypeName, T9: TypeName, T8: TypeName, T7: TypeName, T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T10, T9, T8, T7, T6, T5, T4, T3, T2, T1, T0)

source§

impl<T11: TypeName, T10: TypeName, T9: TypeName, T8: TypeName, T7: TypeName, T6: TypeName, T5: TypeName, T4: TypeName, T3: TypeName, T2: TypeName, T1: TypeName, T0: TypeName> TypeName for (T11, T10, T9, T8, T7, T6, T5, T4, T3, T2, T1, T0)

source§

impl<T> TypeName for &T
where T: ?Sized + TypeName,

source§

impl<T: TypeName> TypeName for Option<T>

source§

impl<T: TypeName> TypeName for [T]

source§

impl<T: TypeName> TypeName for Box<T>

source§

impl<T: TypeName> TypeName for Vec<T>

source§

impl<T: TypeName, const N: usize> TypeName for [T; N]

Implementors§