Skip to content

Classe C++ : File

Index · English

Description

Propriétaire RAII d’un flux stdio newlib, non copiable.

Nom complet : gaspardos::File.

En-tête : bindings/cpp/gaspardos.hpp. C++98.

Dans quel cas l’utiliser

Lire ou écrire un fichier avec les conventions stdio et errno.

Exemple de programme simple

#include "gaspardos.hpp"
#include <cstdio>
#include <cstring>

int main()
{
    gaspardos::File file;
    if (!file.open("/AHCIDISK0/readme.txt", "rb"))
        return 1;
    char        data[128];
    std::size_t count  = file.read(data, sizeof(data));
    int         failed = file.error();
    std::printf("%lu bytes\n", static_cast<unsigned long>(count));
    return file.close() == 0 && !failed ? 0 : 1;
}

Compilation depuis Windows

Enregistrer le programme ci-dessus dans build/api-examples/File.cpp, depuis la racine du dépôt. Créer le dossier si nécessaire.

PowerShell — depuis la racine du dépôt :

New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-gcc.exe -std=gnu1x -O2 -mno-red-zone -c bindings/native/gaspardos_x64_syscall.c -o build/api-examples/syscall.o
if ($LASTEXITCODE -ne 0) { throw "C compilation failed" }
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/File.cpp build/api-examples/syscall.o -o build/api-examples/File-x64.elf
if ($LASTEXITCODE -ne 0) { throw "C++ compilation/link failed" }

Le binaire ELF s’exécute sous GaspardOS, pas sous Windows. Le pilote fournit CRT et bibliothèques. Préparer les volumes/services requis ; les exemples bornent leurs attentes et peuvent sortir sur saturation au lieu de réessayer. Une compilation réussie ne valide pas l’exécution noyau.

Les fichiers nécessaires à cet exemple sont disponibles dans la section Source files (en anglais).

Méthodes de la classe

File()

Initialise un flux fermé.

~File()

Tente close une fois.

bool open(const char* path, const char* mode)

Ouvre path selon mode ; false et errno sur échec, EBUSY si déjà ouvert.

int close()

0 ou EOF ; abandonne le pointeur même si fclose échoue. Un second appel ne réessaie pas.

std::size_t read(void* p, std::size_t n)

Renvoie les octets lus ; 0 peut être EOF ou erreur. Consulter error().

std::size_t write(const void* p, std::size_t n)

Renvoie les octets écrits ; gérer les écritures partielles et le résultat de close.

int seek(long offset, int origin)

Déplace la position selon SEEK_SET/CUR/END ; résultat de fseek.

int error() const

Indicateur ferror du flux, ou EBADF si fermé ; ce n’est pas la valeur errno.

Contrat natif

ABI LP64, wchar_t 32 bits, aucun packing. Les résultats négatifs natifs ne sont pas errno. Traiter -11 avec yield et une limite applicative. Les objets référencés doivent survivre à leurs utilisateurs ; ne pas copier les propriétaires de handles. File utilise stdio/errno et invalide son flux sur close, même sur erreur.