Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::file_size : taille en octets d’un fichier ordinaire

std::filesystem::file_size renvoie dans un uintmax_t la taille en octets d’un fichier ordinaire et signale une erreur si le chemin manque.

Version : C++23

Syntaxe

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> agit comme la lecture de st_size pour le fichier ordinaire résolu par p. Pour un autre type d’objet, le résultat dépend de l’implémentation ; ce n’est donc pas une mesure portable d’un répertoire ou périphérique.

L’exemple écrit quatre octets, lit leur taille puis interroge un fichier absent avec la surcharge error_code ; il affiche 4 1, la seconde valeur confirmant une erreur.

Un chemin absent est une erreur. La surcharge file_size(p, ec), qui ne lève pas d’exception, renvoie static_cast<uintmax_t>(-1) en cas d’erreur et fixe ec ; examinez ec, pas seulement la sentinelle. Sans ec, filesystem_error peut être levée. L’opération suit les liens et son résultat peut être périmé immédiatement après la mesure.

Exemples

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

Résultat

4 1

std::filesystem::file_size → 4 1

Sources