Skip to content

Classe C++ : DirectoryListing

Index · English

Description

Chargement progressif d’un dossier, non copiable.

Nom complet : gaspardos::desktop::DirectoryListing.

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

Dans quel cas l’utiliser

Garder la boucle UI réactive pendant une lecture de dossier.

Exemple de programme simple

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

int main()
{
    gaspardos::desktop::NativeFileAccess access;
    gaspardos::desktop::DirectoryListing listing(access);
    if (!listing.begin("/AHCIDISK0"))
        return 1;
    for (unsigned i = 0; i < 10000 && listing.loading; ++i)
    {
        listing.tick();
        GO64_yield();
    }
    return !listing.loading && listing.error == 0 ? 0 : 1;
}

Compilation depuis Windows

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

explicit DirectoryListing(FileAccess& access)

Conserve une référence au backend, qui doit vivre plus longtemps.

~DirectoryListing()

Annule et tente la fermeture.

bool begin(const std::string& path)

Commence la lecture de path ; bool de succès d’amorçage.

bool tick()

Avance le travail avec un budget de 16 entrées ; consulter loading et error pour l’état.

void cancel()

Interrompt la lecture et tente de fermer le handle.

Données publiques

entries : vector ; loading : bool ; error : int64_t. Limites / limits: 4096 entries, ~1 MiB names/paths.

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.