std::filesystem:: permissions

Изменяет права доступа к файлу, на который указывает p , как если бы с помощью POSIX-функции fchmodat . Символические ссылки обрабатываются, если только perm_options::nofollow не установлен в opts .

Вторая сигнатура ведет себя так, как если бы была вызвана с 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 .

Нет выбрасывающий перегрузка не имеет специального действия при ошибке.

Параметры

Возвращаемое значение

(нет)

Исключения

Любая перегрузка, не помеченная noexcept , может выбрасывать std::bad_alloc при неудачном выделении памяти.

Примечания

Разрешения могут быть реализованы не обязательно в виде битов, но концептуально они рассматриваются именно так.

Некоторые биты разрешений могут игнорироваться в некоторых системах, и изменение некоторых битов может автоматически изменять другие (например, на платформах без разграничения владелец/группа/все, установка любого из трех битов записи устанавливает все три).

Пример

#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--

Смотрите также