#[repr(transparent)]pub struct BorrowedFd<'fd> {
fd: i32,
_phantom: PhantomData<&'fd OwnedFd>,
}
Expand description
A borrowed file descriptor.
This has a lifetime parameter to tie it to the lifetime of something that owns the file descriptor. For the duration of that lifetime, it is guaranteed that nobody will close the file descriptor.
This uses repr(transparent)
and has the representation of a host file
descriptor, so it can be used in FFI in places where a file descriptor is
passed as an argument, it is not captured or consumed, and it never has the
value -1
.
This type does not have a ToOwned
implementation. Calling .to_owned()
on a variable of this type will call
it on &BorrowedFd
and use Clone::clone()
like ToOwned
does for all
types implementing Clone
. The result will be descriptor borrowed under
the same lifetime.
To obtain an OwnedFd
, you can use BorrowedFd::try_clone_to_owned
instead, but this is not supported on all platforms.
Fields§
§fd: i32
§_phantom: PhantomData<&'fd OwnedFd>
Implementations§
source§impl BorrowedFd<'_>
impl BorrowedFd<'_>
1.63.0 (const: 1.63.0) · sourcepub const unsafe fn borrow_raw(fd: i32) -> BorrowedFd<'_>
pub const unsafe fn borrow_raw(fd: i32) -> BorrowedFd<'_>
Returns a BorrowedFd
holding the given raw file descriptor.
§Safety
The resource pointed to by fd
must remain open for the duration of
the returned BorrowedFd
, and it must not have the value -1
.
source§impl BorrowedFd<'_>
impl BorrowedFd<'_>
1.63.0 · sourcepub fn try_clone_to_owned(&self) -> Result<OwnedFd, Error>
pub fn try_clone_to_owned(&self) -> Result<OwnedFd, Error>
Creates a new OwnedFd
instance that shares the same underlying file
description as the existing BorrowedFd
instance.
Trait Implementations§
1.63.0 · source§impl AsFd for BorrowedFd<'_>
impl AsFd for BorrowedFd<'_>
source§fn as_fd(&self) -> BorrowedFd<'_>
fn as_fd(&self) -> BorrowedFd<'_>
1.63.0 · source§impl AsRawFd for BorrowedFd<'_>
impl AsRawFd for BorrowedFd<'_>
1.63.0 · source§impl<'fd> Clone for BorrowedFd<'fd>
impl<'fd> Clone for BorrowedFd<'fd>
source§fn clone(&self) -> BorrowedFd<'fd>
fn clone(&self) -> BorrowedFd<'fd>
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more1.63.0 · source§impl Debug for BorrowedFd<'_>
impl Debug for BorrowedFd<'_>
1.70.0 · source§impl IsTerminal for BorrowedFd<'_>
impl IsTerminal for BorrowedFd<'_>
source§fn is_terminal(&self) -> bool
fn is_terminal(&self) -> bool
true
if the descriptor/handle refers to a terminal/tty. Read moreimpl<'fd> Copy for BorrowedFd<'fd>
Auto Trait Implementations§
impl<'fd> Freeze for BorrowedFd<'fd>
impl<'fd> RefUnwindSafe for BorrowedFd<'fd>
impl<'fd> Send for BorrowedFd<'fd>
impl<'fd> Sync for BorrowedFd<'fd>
impl<'fd> Unpin for BorrowedFd<'fd>
impl<'fd> UnwindSafe for BorrowedFd<'fd>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)