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, RawSocket, and stdio device identifiers. Similar to Rust raw pointers, it is considered safe to construct these, but unsafe to do any I/O with them (effectively dereferencing them).

Implementations

impl UnsafeHandle

pub const unsafe fn as_readable(self) -> UnsafeReadable

Obtain self with a type that implements Read.

Safety

The resulting UnsafeReadable value must not outlive the underlying resource.

Also, callers should avoid mixing uses of UnsafeReadable with the type’s Read or Write implementations if the type uses buffering, as for example async_std::fs::File does.

pub const unsafe fn as_writeable(self) -> UnsafeWriteable

Obtain self with a type that implements Write.

Safety

The resulting UnsafeWriteable value must not outlive the underlying resource.

Also, callers should avoid mixing uses of UnsafeWriteable with the type’s Read or Write implementation if the type uses buffering, as for example async_std::fs::File does.

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.

pub const fn unowned_from_raw_handle(raw_handle: RawHandle) -> Self

Like FromRawHandle::from_raw_handle, but isn’t unsafe because it doesn’t imply a dereference.

pub const fn unowned_from_raw_socket(raw_socket: RawSocket) -> Self

Like FromRawSocket::from_raw_socket, but isn’t unsafe because it doesn’t imply a dereference.

pub const fn unowned_from_raw_handle_or_socket(
    raw_handle_or_socket: RawHandleOrSocket
) -> Self

Like FromRawHandle::from_raw_handle and FromRawSocket::from_raw_socket combined, but isn’t unsafe because it doesn’t imply a dereference.

Trait Implementations

impl AsRawHandleOrSocket for UnsafeHandle

UnsafeHandle doesn’t own its handle; see the comments for impl AsRawFd for UnsafeHandle.

fn as_raw_handle_or_socket(&self) -> RawHandleOrSocket

Like AsRawHandle::as_raw_handle and AsRawSocket::as_raw_socket but can return either type.

impl Clone for UnsafeHandle

fn clone(&self) -> UnsafeHandle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UnsafeHandle

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

Formats the value using the given formatter.

impl FromRawHandleOrSocket for UnsafeHandle

UnsafeHandle doesn’t own its handle; see the comments for impl AsRawFd for UnsafeHandle.

unsafe fn from_raw_handle_or_socket(
    raw_handle_or_socket: RawHandleOrSocket
) -> Self

Like FromRawHandle::from_raw_handle and FromRawSocket::from_raw_socket but can be passed either type.

impl FromUnsafeHandle for UnsafeHandle

UnsafeHandle doesn’t own its handle; see the comments for impl AsRawFd for UnsafeHandle.

unsafe fn from_unsafe_handle(unsafe_handle: UnsafeHandle) -> Self

Constructs a new instance of Self from the given unsafe handle.

impl IntoRawHandleOrSocket for UnsafeHandle

UnsafeHandle doesn’t own its handle; see the comments for impl AsRawFd for UnsafeHandle.

fn into_raw_handle_or_socket(self) -> RawHandleOrSocket

Like IntoRawHandle::into_raw_handle and IntoRawSocket::into_raw_socket but can return either type.

impl Copy for UnsafeHandle