faccess

Rust 的基本跨平台文件可访问性检查。

概要

pub trait PathExt {
    fn access(&self, mode: AccessMode) -> std::io::Result<()>;
    fn readable(&self) -> bool;
    fn writable(&self) -> bool;
    fn executable(&self) -> bool;
}

impl PathExt for std::path::Path;

描述

faccess 为 std::path::Path 提供了一个扩展 trait，该 trait 添加了一个 access 方法，用于检查给定访问权限的路径的可访问性——一个或多个 AccessMode 标志（EXISTS、READ、WRITE、EXECUTE）的按位或。

如果只需检查单个权限，它还提供了便利方法 readable、writable 和 executable。

示例

use std::path::Path;
use faccess::{AccessMode, PathExt};

let path = Path::new("/bin/ls");

assert!(path.access(AccessMode::READ | AccessMode::EXECUTE).is_ok());
assert!(path.readable());
assert!(!path.writable());
assert!(path.executable());

平台特定行为

在 Unix 平台上，access 直接映射到 faccessat(2)，如果可用，使用 AT_EACCESS 标志来测试有效用户和组 ID。