Trait PrintfArgument

pub trait PrintfArgument: PrintfArgumentPrivate + Copy {
    type CPrintfType;

    const IS_CHAR: bool = false;
    const IS_SHORT: bool = false;
    const IS_INT: bool = false;
    const IS_LONG: bool = false;
    const IS_LONG_LONG: bool = false;
    const IS_SIZE: bool = false;
    const IS_MAX: bool = false;
    const IS_PTRDIFF: bool = false;
    const IS_SIGNED: bool = false;
    const IS_FLOAT: bool = false;
    const IS_C_STRING: bool = false;
    const IS_POINTER: bool = false;

    // Required method
    fn as_c_val(self) -> Self::CPrintfType;
}

A Rust-side argument to a safe wrapper around a printf(3)-like function.

This is a sealed trait; consumers of this crate are not allowed to create their own impls in order to unconditionally preserve safety.

Provided Associated Constants

const IS_CHAR: bool = false

Whether the type is consistent with C’s char.

const IS_SHORT: bool = false

Whether the type is consistent with C’s short int.

const IS_INT: bool = false

Whether the type is consistent with C’s int.

const IS_LONG: bool = false

Whether the type is consistent with C’s long int.

const IS_LONG_LONG: bool = false

Whether the type is consistent with C’s long long int.

const IS_SIZE: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s size_t.

const IS_MAX: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s intmax_t.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s ptrdiff_t.

const IS_SIGNED: bool = false

Whether the type is a signed integer type, as opposed to unsigned.

const IS_FLOAT: bool = false

Whether the type is floating-point.

const IS_C_STRING: bool = false

Whether the type is a null-terminated string.

const IS_POINTER: bool = false

Whether the type is a pointer.

Required Associated Types

type CPrintfType

The C type corresponding to Self that we should really send as an argument to a printf(3)-like function.

Required Methods

fn as_c_val(self) -> Self::CPrintfType

Converts self to a value suitable for sending to printf(3).

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.

Implementations on Foreign Types

impl PrintfArgument for f32

const IS_FLOAT: bool = true

type CPrintfType = f64

fn as_c_val(self) -> c_double

impl PrintfArgument for f64

const IS_FLOAT: bool = true

type CPrintfType = f64

fn as_c_val(self) -> c_double

impl PrintfArgument for i8

const IS_SIGNED: bool = true

const IS_CHAR: bool = true

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <i8 as LargerOfOp<i32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for i16

const IS_SIGNED: bool = true

const IS_CHAR: bool = false

const IS_SHORT: bool = true

const IS_INT: bool = false

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <i16 as LargerOfOp<i32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for i32

const IS_SIGNED: bool = true

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = true

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <i32 as LargerOfOp<i32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for i64

const IS_SIGNED: bool = true

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = true

const IS_LONG_LONG: bool = true

const IS_SIZE: bool = true

Available on crate feature libc only.

const IS_MAX: bool = true

Available on crate feature libc only.

const IS_PTRDIFF: bool = true

Available on crate feature libc only.

type CPrintfType = <i64 as LargerOfOp<i32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for isize

const IS_SIGNED: bool = true

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = true

const IS_LONG_LONG: bool = true

const IS_SIZE: bool = true

Available on crate feature libc only.

const IS_MAX: bool = true

Available on crate feature libc only.

const IS_PTRDIFF: bool = true

Available on crate feature libc only.

type CPrintfType = <isize as LargerOfOp<i32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for u8

const IS_SIGNED: bool = false

const IS_CHAR: bool = true

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <u8 as LargerOfOp<u32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for u16

const IS_SIGNED: bool = false

const IS_CHAR: bool = false

const IS_SHORT: bool = true

const IS_INT: bool = false

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <u16 as LargerOfOp<u32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for u32

const IS_SIGNED: bool = false

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = true

const IS_LONG: bool = false

const IS_LONG_LONG: bool = false

const IS_SIZE: bool = false

Available on crate feature libc only.

const IS_MAX: bool = false

Available on crate feature libc only.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

type CPrintfType = <u32 as LargerOfOp<u32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for u64

const IS_SIGNED: bool = false

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = true

const IS_LONG_LONG: bool = true

const IS_SIZE: bool = true

Available on crate feature libc only.

const IS_MAX: bool = true

Available on crate feature libc only.

const IS_PTRDIFF: bool = true

Available on crate feature libc only.

type CPrintfType = <u64 as LargerOfOp<u32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl PrintfArgument for usize

const IS_SIGNED: bool = false

const IS_CHAR: bool = false

const IS_SHORT: bool = false

const IS_INT: bool = false

const IS_LONG: bool = true

const IS_LONG_LONG: bool = true

const IS_SIZE: bool = true

Available on crate feature libc only.

const IS_MAX: bool = true

Available on crate feature libc only.

const IS_PTRDIFF: bool = true

Available on crate feature libc only.

type CPrintfType = <usize as LargerOfOp<u32>>::Output

fn as_c_val(self) -> Self::CPrintfType

impl<T: AsRef<CStr> + ?Sized> PrintfArgument for &T

const IS_C_STRING: bool = true

type CPrintfType = *const i8

fn as_c_val(self) -> *const c_char

impl<T: Sized> PrintfArgument for *const T

const IS_POINTER: bool = true

type CPrintfType = *const c_void

fn as_c_val(self) -> *const c_void

impl<T: Sized> PrintfArgument for *mut T

const IS_POINTER: bool = true

type CPrintfType = *const c_void

fn as_c_val(self) -> *const c_void

Implementors

impl PrintfArgument for NullString

const IS_C_STRING: bool = true

type CPrintfType = *const i8