Skip to content

Classe C++ : FileAccess

Index · English

Description

Interface abstraite du système de fichiers de bureau.

Nom complet : gaspardos::desktop::FileAccess.

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

Dans quel cas l’utiliser

Injecter un backend natif ou un faux système de fichiers pour les tests.

Exemple de programme simple

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

int main()
{
    gaspardos::desktop::NativeFileAccess       native;
    gaspardos::desktop::FileAccess&            access = native;
    std::vector<gaspardos::desktop::FileEntry> roots  = access.roots();
    std::printf("%lu volumes\n", static_cast<unsigned long>(roots.size()));
    return 0;
}

Compilation depuis Windows

Enregistrer le programme ci-dessus dans build/api-examples/FileAccess.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/FileAccess.cpp build/api-examples/syscall.o bindings/cpp/file_explorer.cpp bindings/cpp/desktop_native.cpp -o build/api-examples/FileAccess-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

virtual ~FileAccess()

Destructeur virtuel pour les adaptateurs.

virtual std::vector<FileEntry> roots() = 0

Renvoie les volumes découverts, sans monter ni formater.

virtual int64_t stat(const std::string& path, FileEntry& entry) = 0

Remplit FileEntry ; résultat natif signé.

virtual int64_t openDirectory(const std::string& path) = 0

Ouvre un dossier ; renvoie handle ou erreur négative.

virtual int64_t next(int64_t handle, FileEntry& entry) = 0

Entrée suivante ; 1 entrée, 0 fin, erreur négative, -11 reprise.

virtual int64_t close(int64_t handle) = 0

Ferme le handle ; une erreur doit être traitée par l’appelant.

virtual int64_t mkdir(const std::string& path) = 0

Crée le dossier indiqué.

virtual int64_t read(const std::string& path, std::string& data, std::size_t limit) = 0

Lit avec une limite explicite en octets ; résultat d’opération, données dans data.

virtual int64_t create(const std::string& path, const std::string& data) = 0

Création exclusive ; ne modifie jamais un fichier préexistant.

virtual int64_t rename(const std::string& from, const std::string& to) = 0

Renomme le chemin ; erreur brute négative sur échec.

virtual int64_t remove(const std::string& path) = 0

Supprime le fichier indiqué.

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.