Trait rustix::fd::AsRawFd

1.0.0 · source · []
pub trait AsRawFd {
    fn as_raw_fd(&self) -> i32;
}
Expand description

A trait to extract the raw file descriptor from an underlying object.

This is only available on unix and WASI platforms and must be imported in order to call the method. Windows platforms have a corresponding AsRawHandle and AsRawSocket set of traits.

Required methods

Extracts the raw file descriptor.

This function is typically used to borrow an owned file descriptor. When used in this way, this method does not pass ownership of the raw file descriptor to the caller, and the file descriptor is only guaranteed to be valid while the original object has not yet been destroyed.

However, borrowing is not strictly required. See [AsFd::as_fd] for an API which strictly borrows a file descriptor.

Example
use std::fs::File;
#[cfg(unix)]
use std::os::unix::io::{AsRawFd, RawFd};
#[cfg(target_os = "wasi")]
use std::os::wasi::io::{AsRawFd, RawFd};

let mut f = File::open("foo.txt")?;
// Note that `raw_fd` is only valid as long as `f` exists.
#[cfg(any(unix, target_os = "wasi"))]
let raw_fd: RawFd = f.as_raw_fd();

Implementations on Foreign Types

Implementors

impl AsRawFd for File

impl<T: AsRawFd> AsRawFd for Async<T>

impl AsRawFd for Dir

impl AsRawFd for File

impl AsRawFd for BorrowedFd<'_>

impl AsRawFd for OwnedFd

impl AsRawFd for Memfd

impl AsRawFd for Dir

impl AsRawFd for Handle

impl AsRawFd for Socket

impl<S> AsRawFd for TlsStream<S> where
    S: AsRawFd

impl<IO> AsRawFd for TlsStream<IO> where
    IO: AsRawFd

impl<S> AsRawFd for TlsStream<S> where
    S: AsRawFd