CKTIS / C++
std::filesystem::file_size: tamanho em bytes de um ficheiro normal
std::filesystem::file_size devolve em uintmax_t o tamanho em bytes de um ficheiro normal e comunica erro quando o caminho falta.
Versão: C++23
Sintaxe
std::uintmax_t std::filesystem::file_size(
const std::filesystem::path& p);
std::uintmax_t std::filesystem::file_size(
const std::filesystem::path& p, std::error_code& ec) noexcept;std::filesystem::file_size(p) de <filesystem> equivale a ler st_size para o ficheiro normal resolvido por p. Para outro tipo de objeto o resultado depende da implementação, portanto não é medida portátil de diretórios ou dispositivos.
O exemplo escreve quatro bytes, lê o tamanho e consulta um ficheiro ausente com a sobrecarga error_code; imprime 4 1, em que o segundo valor confirma o erro.
Um caminho ausente é erro. A sobrecarga que não lança file_size(p, ec) devolve static_cast<uintmax_t>(-1) em erro e define ec; verifica ec, não apenas o sentinela. Sem ec pode lançar filesystem_error. A operação segue links simbólicos e o resultado pode ficar desatualizado logo após a medição.
Exemplos
#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-file-size";
const fs::path file = root / "data.bin";
std::error_code ignored;
fs::remove_all(root, ignored);
fs::create_directory(root);
std::ofstream(file, std::ios::binary) << "data";
const std::uintmax_t size = fs::file_size(file);
std::error_code ec;
const std::uintmax_t missing = fs::file_size(root / "missing.bin", ec);
std::cout << size << ' '
<< (missing == static_cast<std::uintmax_t>(-1) && static_cast<bool>(ec))
<< '\n';
fs::remove_all(root, ignored);
}
Resultado
4 1
std::filesystem::file_size → 4 1