Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::filesystem::file_size: dimensione in byte di un file regolare

std::filesystem::file_size restituisce in uintmax_t la dimensione in byte di un file regolare e segnala errore per un percorso mancante.

Versione: C++23

Sintassi

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) di <filesystem> equivale a leggere st_size per il file regolare risolto da p. Per un oggetto di altro tipo il risultato è definito dall’implementazione, quindi non è una misura portabile di directory o dispositivi.

L’esempio scrive quattro byte, ne legge la dimensione e poi interroga un file mancante con l’overload error_code; stampa 4 1, dove il secondo valore conferma un errore.

Un percorso mancante è un errore. L’overload non lanciante file_size(p, ec) restituisce static_cast<uintmax_t>(-1) in errore e imposta ec; controlla ec, non solo la sentinella. Senza ec può lanciare filesystem_error. L’operazione segue i link simbolici e il risultato può diventare obsoleto subito dopo la misura.

Esempi

#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);
}

Risultato

4 1

std::filesystem::file_size → 4 1

Fonti