Struct nix::dir::Dir

pub struct 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 to fstat, openat, etc. The file descriptor continues to be owned by the Dir, so callers must not keep a RawFd after the Dir 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).

Methods

impl Dir

pub fn open<P: ?Sized + NixPath>(
    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>

Opens the given path as with fcntl::openat.

pub fn from<F: IntoRawFd>(fd: F) -> Result<Self>

Converts from a descriptor-based object, closing the descriptor on success or failure.

pub fn from_fd(fd: RawFd) -> Result<Self>

Converts from a file descriptor, closing it on success or failure.

Important traits for Iter<'d>

impl<'d> Iterator for Iter<'d> type Item = Result<Entry>;

pub fn iter(&mut self) -> Iter

Returns an iterator of Result<Entry> which rewinds when finished.

Trait Implementations

impl Send for Dir

impl Drop for Dir

fn drop(&mut self)

Executes the destructor for this type.

impl Clone for Dir

fn clone(&self) -> Dir

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for Dir

impl PartialEq<Dir> for Dir

fn eq(&self, other: &Dir) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Dir) -> bool

This method tests for !=.

impl Debug for Dir

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

Formats the value using the given formatter.

impl Hash for Dir

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl StructuralPartialEq for Dir

impl StructuralEq for Dir

impl AsRawFd for Dir

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.