Struct filedescriptor::OwnedHandle

pub struct OwnedHandle { /* fields omitted */ }

OwnedHandle allows managing the lifetime of the platform RawFileDescriptor type. It is exposed in the interface of this crate primarily for convenience on Windows where the system handle type is used for a variety of objects that don't support reading and writing.

Methods

impl OwnedHandle

pub fn new<F: IntoRawFileDescriptor>(f: F) -> Self

Create a new handle from some object that is convertible into the system RawFileDescriptor type. This consumes the parameter and replaces it with an OwnedHandle instance.

pub fn try_clone(&self) -> Fallible<Self>

Attempt to duplicate the underlying handle and return an OwnedHandle wrapped around the duplicate. Since the duplication requires kernel resources that may not be available, this is a potentially fallible operation. The returned handle has a separate lifetime from the source, but references the same object at the kernel level.

pub fn dup<F: AsRawFileDescriptor>(f: &F) -> Fallible<Self>

Attempt to duplicate the underlying handle from an object that is representable as the systemm RawFileDescriptor type and return an OwnedHandle wrapped around the duplicate. Since the duplication requires kernel resources that may not be available, this is a potentially fallible operation. The returned handle has a separate lifetime from the source, but references the same object at the kernel level.

Trait Implementations

impl Drop for OwnedHandle

fn drop(&mut self)

Executes the destructor for this type.

impl Send for OwnedHandle

impl Debug for OwnedHandle

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

Formats the value using the given formatter.

impl IntoRawHandle for OwnedHandle

fn into_raw_handle(self) -> RawHandle

Consumes this object, returning the raw underlying handle.

impl AsRawHandle for OwnedHandle

fn as_raw_handle(&self) -> RawHandle

Extracts the raw handle, without taking any ownership.

impl FromRawHandle for OwnedHandle

unsafe fn from_raw_handle(handle: RawHandle) -> Self

Constructs a new I/O object from the specified raw handle.