Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::filesystem::perms — máscara de bits de permissões

std::filesystem::perms representa os bits de permissões de um ficheiro. Combine sinalizadores com |, verifique-os com & e distinga um conjunto de permissões vazio de permissões desconhecidas.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <filesystem>
using P = std::filesystem::perms;
P bits = P::owner_read | P::owner_write;
bool readable = (bits & P::owner_read) != P::none;

std::filesystem::perms de <filesystem> é um tipo enum class usado como máscara de bits. Os prefixos owner_, group_ e others_ identificam o proprietário, o grupo e os outros; os sufixos read, write, exec significam leitura, escrita e execução/pesquisa. owner_all, group_all e others_all combinam as três permissões de cada categoria.

perms::none é zero; perms::unknown significa permissões desconhecidas, não ausência de permissões. perms::all (0777) abrange as permissões normais; perms::mask (07777) abrange também set_uid, set_gid e sticky_bit, que depende do sistema operativo.

Combine os sinalizadores com |; teste (bits & flag) != perms::none. Para um sinalizador composto, este teste verifica se existe algum bit correspondente; para exigir todos, use (bits & flag) == flag. Exclua perms::unknown antes de interpretar uma máscara obtida.

Uma máscara, por si só, não altera qualquer ficheiro. std::filesystem::permissions aceita-a com std::filesystem::perm_options: exatamente uma das opções replace (predefinida), add e remove, opcionalmente combinada com nofollow, que seleciona a ligação simbólica em si em vez do destino. O suporte da operação depende da plataforma. O exemplo manipula apenas valores, sem aceder ao sistema de ficheiros.

Exemplos

#include <filesystem>
#include <iostream>

int main() {
    using P = std::filesystem::perms;
    constexpr P bits = P::owner_read | P::owner_write | P::group_read;
    static_assert((bits & P::owner_write) != P::none);
    static_assert((bits & P::others_read) == P::none);

    std::cout << std::boolalpha
              << ((bits & P::owner_write) != P::none) << '\n'
              << ((bits & P::others_read) != P::none) << '\n';
}

Resultado

true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes