[−][src]Struct nix::dir::Dir
An open directory.
This is a lower-level interface than std::fs::ReadDir
. Notable differences:
- can be opened from a file descriptor (as returned by
openat
, perhaps before knowing if the path represents a file or directory). - implements
AsRawFd
, so it can be passed tofstat
,openat
, etc. The file descriptor continues to be owned by theDir
, so callers must not keep aRawFd
after theDir
is dropped. - can be iterated through multiple times without closing and reopening the file descriptor. Each iteration rewinds when finished.
- returns entries for
.
(current directory) and..
(parent directory). - returns entries' names as a
CStr
(no allocation or conversion beyond whatever libc does).
Implementations
impl Dir
[src]
pub fn open<P: ?Sized + NixPath>(
path: &P,
oflag: OFlag,
mode: Mode
) -> Result<Self>
[src]
path: &P,
oflag: OFlag,
mode: Mode
) -> Result<Self>
Opens the given path as with fcntl::open
.
pub fn openat<P: ?Sized + NixPath>(
dirfd: RawFd,
path: &P,
oflag: OFlag,
mode: Mode
) -> Result<Self>
[src]
dirfd: RawFd,
path: &P,
oflag: OFlag,
mode: Mode
) -> Result<Self>
Opens the given path as with fcntl::openat
.
pub fn from<F: IntoRawFd>(fd: F) -> Result<Self>
[src]
Converts from a descriptor-based object, closing the descriptor on success or failure.
pub fn from_fd(fd: RawFd) -> Result<Self>
[src]
Converts from a file descriptor, closing it on success or failure.
pub fn iter(&mut self) -> Iter
[src]
Returns an iterator of Result<Entry>
which rewinds when finished.
Trait Implementations
Auto Trait Implementations
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,