std::experimental::filesystem::permissions
来自cppreference.com
< cpp | experimental | fs
| 在标头 <experimental/filesystem> 定义
|
||
| void permissions( const path& p, perms prms ); void permissions( const path& p, perms prms, error_code& ec ); |
(文件系统 TS) | |
改变 p 解析到的文件的访问权限，如同以 POSIX fchmodat。当设置 prms::resolve_symlinks 时跟随符号链接。
其效果取决于 prms 如下：
- 如果 perms::add_perms 或 perms::remove_perms 均未设置，则文件权限被准确设置为 prms & fs::perms::mask（含义为，应用 prms 中的每个有效位）。
- 如果设置了 perms::add_perms，则文件权限被准确设置为 status(p).permissions() | (prms & perms::mask)（含义为，将 prms 中已设置，但未在文件当前权限中的任何有效位添加到文件权限）。
- 如果设置了 perms::remove_perms，则文件权限被准确设置为 status(p).permissions() & ~(prms & perms::mask)（含义为，将 prms 中已清除，但在文件的当前权限中设置的任何位，从文件权限中清除）。
- 如果同时设置了 perms::add_perms 和 perms::remove_perms，则发生错误。
无抛出重载在发生错误时没有特殊动作。
参数
| p | - | 要检查的路径 |
| prms | - | 要设置、添加或移除的权限 |
| ec | - | 用于无抛出重载中错误报告的输出形参 |
返回值
（无）
异常
不接受 error_code& 形参的重载，在发生底层 OS API 错误时抛出 filesystem_error，它以 p 为第一实参并以 OS 错误码为错误码实参构造。如果内存分配失败，则可抛出 std::bad_alloc。接受 error_code& 形参的重载，当 OS API 调用失败时将之设置为 OS API 错误码，而未发生错误时执行 ec.clear()。此重载具有noexcept 规定：
noexcept
注解
权限不必实现为位标记，但概念上以这种方式对待它们。
一些权限位在一些系统上被忽略，而改变一些位会自动改变其他位（例如，在不区分所有者/组/其他的系统上，设置三者任一位就会设置三者全部）。
示例
运行此代码
#include <bitset> #include <experimental/filesystem> #include <fstream> #include <iostream> namespace fs = std::experimental::filesystem; void demo_perms(fs::perms p) { std::cout << ((p & fs::perms::owner_read) != fs::perms::none ? "r" : "-") << ((p & fs::perms::owner_write) != fs::perms::none ? "w" : "-") << ((p & fs::perms::owner_exec) != fs::perms::none ? "x" : "-") << ((p & fs::perms::group_read) != fs::perms::none ? "r" : "-") << ((p & fs::perms::group_write) != fs::perms::none ? "w" : "-") << ((p & fs::perms::group_exec) != fs::perms::none ? "x" : "-") << ((p & fs::perms::others_read) != fs::perms::none ? "r" : "-") << ((p & fs::perms::others_write) != fs::perms::none ? "w" : "-") << ((p & fs::perms::others_exec) != fs::perms::none ? "x" : "-") << '\n'; } int main() { std::ofstream("test.txt"); // 创建文件 std::cout << "创建文件的权限："; demo_perms(fs::status("test.txt").permissions()); fs::permissions("test.txt", fs::perms::add_perms | fs::perms::owner_all | fs::perms::group_all); std::cout << "添加 o+rwx 和 g+rwx 后；"; demo_perms(fs::status("test.txt").permissions()); fs::remove("test.txt"); }
可能的输出：
创建文件的权限：rw-r--r-- 添加 o+rwx 和 g+rwx 后；rwxrwxr--
参阅
| 标识文件系统权限 (枚举) | |
| 确定文件属性 确定文件属性，检查符号链接目标 (函数) |