Struct unsafe_io::UnsafeHandle

#[repr(transparent)]pub struct UnsafeHandle(_);

A non-owning unsafe I/O handle.

On Posix-ish platforms this is just a RawFd. On Windows it is a minimal abstraction over RawHandle and RawSocket. Similar to Rust raw pointers, it is considered safe to construct these, but unsafe to do any I/O with them (effectively dereferencing them).

Note that this doesn't implement Into* or From* traits, as those imply ownership transfers, and this type is non-owning.

Implementations

impl UnsafeHandle

#[must_use]pub const unsafe fn as_readable(self) -> UnsafeReadable

Obtain self with a type that implements Read.

Safety

The resulting value must not outlive the underlying resource.

#[must_use]pub const unsafe fn as_writeable(self) -> UnsafeWriteable

Obtain self with a type that implements Write.

Safety

The resulting value must not outlive the underlying resource.

#[must_use]pub unsafe fn eq(self, other: Self) -> bool

UnsafeHandle doesn't implement Eq or PartialEq because comparison is undefined for dangling handles.

Safety

Both self and other must outlive their underlying resources.

#[must_use]pub const fn from_raw_fd(raw_fd: RawFd) -> Self

Like FromRawFd::from_raw_fd, but isn't unsafe because it doesn't imply a dereference.

Trait Implementations

impl AsRawFd for UnsafeHandle

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Clone for UnsafeHandle

fn clone(&self) -> UnsafeHandle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for UnsafeHandle

impl Debug for UnsafeHandle

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

Formats the value using the given formatter.