std::filesystem::permissions

在头文件 `<filesystem>` 中定义
void permissions( const std::filesystem::path& p, std::filesystem::perms prms, std::filesystem::perm_options opts = perm_options::replace );	(1)	(自 C++17 起)
void permissions( const std::filesystem::path& p, std::filesystem::perms prms, std::error_code& ec ) noexcept;	(2)	(自 C++17 起)
void permissions( const std::filesystem::path& p, std::filesystem::perms prms, std::filesystem::perm_options opts, std::error_code& ec );	(3)	(自 C++17 起)

更改 p 解析到的文件的访问权限，就像使用 POSIX fchmodat 一样。除非在 opts 中设置了 perm_options::nofollow，否则会跟踪符号链接。

第二个签名表现得好像调用时将 opts 设置为 perm_options::replace 一样。

效果取决于 prms 和 opts，如下所示

如果 opts 是 perm_options::replace，则文件权限将设置为完全 prms & std::filesystem::perms::mask（也就是说， prms 的每个有效位都会被应用）。
如果 opts 是 perm_options::add，则文件权限将设置为完全 status(p).permissions() | (prms & perms::mask)（也就是说，任何在 prms 中设置但在文件的当前权限中未设置的有效位都会被添加到文件的权限中）。
如果 opts 是 perm_options::remove，则文件权限将设置为完全 status(p).permissions() & ~(prms & perms::mask)（也就是说，任何在 prms 中清除但在文件的当前权限中设置的有效位都会从文件的权限中清除）。

opts 要求仅设置 replace、add 或 remove 之一。

非抛出重载在错误时没有特殊操作。

[编辑] 参数

p	-	要检查的路径
prms	-	要设置、添加或删除的权限
opts	-	控制此函数执行的操作的选项
ec	-	非抛出重载中用于错误报告的输出参数

[编辑] 返回值

(无)

[编辑] 异常

任何未标记为 noexcept 的重载可能会在内存分配失败时抛出 std::bad_alloc。

1) 在底层操作系统 API 错误上抛出 std::filesystem::filesystem_error，使用 p 作为第一个路径参数，使用操作系统错误代码作为错误代码参数。

2,3) 如果操作系统 API 调用失败，则将 std::error_code& 参数设置为操作系统 API 错误代码，如果未发生错误，则执行 ec.clear()。

[编辑] 备注

权限不一定必须实现为位，但它们在概念上被视为位。

某些权限位在某些系统上可能会被忽略，更改某些位可能会自动更改其他位（例如，在没有所有者/组/全部区分的平台上，设置三个写位中的任何一个都会设置全部三个位）。

[编辑] 示例

运行此代码

#include <filesystem>
#include <fstream>
#include <iostream>
 
void demo_perms(std::filesystem::perms p)
{
    using std::filesystem::perms;
    auto show = [=](char op, perms perm)
    {
        std::cout << (perms::none == (perm & p) ? '-' : op);
    };
    show('r', perms::owner_read);
    show('w', perms::owner_write);
    show('x', perms::owner_exec);
    show('r', perms::group_read);
    show('w', perms::group_write);
    show('x', perms::group_exec);
    show('r', perms::others_read);
    show('w', perms::others_write);
    show('x', perms::others_exec);
    std::cout << '\n';
}
 
int main()
{
    std::ofstream("test.txt"); // create file
 
    std::cout << "Created file with permissions: ";
    demo_perms(std::filesystem::status("test.txt").permissions());
 
    std::filesystem::permissions(
        "test.txt",
        std::filesystem::perms::owner_all | std::filesystem::perms::group_all,
        std::filesystem::perm_options::add
    );
 
    std::cout << "After adding u+rwx and g+rwx:  ";
    demo_perms(std::filesystem::status("test.txt").permissions());
 
    std::filesystem::remove("test.txt");
}

可能的输出

Created file with permissions: rw-r--r--
After adding u+rwx and g+wrx:  rwxrwxr--

[编辑] 另请参阅

perms (C++17)	识别文件系统权限 (枚举) [编辑]
statussymlink_status (C++17)(C++17)	确定文件属性确定文件属性，检查符号链接目标 (函数) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作