Trait TypedExternal

Source

pub trait TypedExternal: 'static {
    const TYPE_NAME: &'static str;
    const TYPE_NAME_CSTR: &'static [u8];
    const TYPE_ID_CSTR: &'static [u8];
}

Expand description

Trait for types that can be stored in an ExternalPtr.

This provides the type identification needed for runtime type checking. Type identification uses R’s symbol interning (Rf_install) for fast pointer-based comparison.

§Type ID vs Type Name

TYPE_ID_CSTR: Namespaced identifier used for type checking (stored in prot[0]). Format: "<crate_name>@<crate_version>::<module_path>::<type_name>\0"

The crate name and version ensure:
- Same type from same crate+version → compatible (can share ExternalPtr)
- Same type name from different crates → incompatible
- Same type from different crate versions → incompatible
TYPE_NAME_CSTR: Short display name for the R tag (shown when printing). Just the type identifier for readability.

Required Associated Constants§

Source

const TYPE_NAME: &'static str

The type name as a static string (for debugging and display)

Source

const TYPE_NAME_CSTR: &'static [u8]

The type name as a null-terminated C string (for R tag display)

Source

const TYPE_ID_CSTR: &'static [u8]

Namespaced type ID as a null-terminated C string (for type checking).

This should include the module path to prevent cross-package collisions. Use concat!(module_path!(), "::", stringify!(Type), "\0").as_bytes() when implementing manually, or use #[derive(ExternalPtr)].

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Trait TypedExternal Copy item path

§Type ID vs Type Name

Required Associated Constants§

const TYPE_NAME: &'static str

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

Dyn Compatibility§

Implementations on Foreign Types§

impl TypedExternal for IpAddr

const TYPE_NAME: &'static str = "IpAddr"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for SocketAddr

const TYPE_NAME: &'static str = "SocketAddr"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for bool

const TYPE_NAME: &'static str = "bool"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for char

const TYPE_NAME: &'static str = "char"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for f32

const TYPE_NAME: &'static str = "f32"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for f64

const TYPE_NAME: &'static str = "f64"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for i8

const TYPE_NAME: &'static str = "i8"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for i16

const TYPE_NAME: &'static str = "i16"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for i32

const TYPE_NAME: &'static str = "i32"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for i64

const TYPE_NAME: &'static str = "i64"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for i128

const TYPE_NAME: &'static str = "i128"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for isize

const TYPE_NAME: &'static str = "isize"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for u8

const TYPE_NAME: &'static str = "u8"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for u16

const TYPE_NAME: &'static str = "u16"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for u32

const TYPE_NAME: &'static str = "u32"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for u64

const TYPE_NAME: &'static str = "u64"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for u128

const TYPE_NAME: &'static str = "u128"

const TYPE_NAME_CSTR: &'static [u8]

const TYPE_ID_CSTR: &'static [u8]

impl TypedExternal for ()

const TYPE_NAME: &'static str = "()"

const TYPE_NAME_CSTR: &'static [u8] = b"()\0"

const TYPE_ID_CSTR: &'static [u8] = b"()\0"

Trait TypedExternal