Skip to content

Classe C++ : NativeFile

Index · English

Description

Propriétaire non copiable d’un handle fichier ou dossier x64.

Nom complet : gaspardos::NativeFile.

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

Dans quel cas l’utiliser

Accéder aux services natifs hors stdio.

Exemple de programme simple

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

int main()
{
    gaspardos::NativeFile file;
    if (file.open(L"\\AHCIDISK0\\readme.txt", GO64_RDONLY) < 0)
        return 1;
    char    data[128];
    int64_t count  = file.read(data, sizeof(data));
    int64_t closed = file.close();
    return count >= 0 && closed == 0 ? 0 : 1;
}

Compilation depuis Windows

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

NativeFile()

Handle initial -1.

~NativeFile()

Tente close une fois.

int64_t handle() const

Handle brut, -1 si fermé.

int64_t close()

0 si fermé ; conserve le handle sur erreur, notamment -11.

int64_t open(const wchar_t* path, uint64_t flags)

Chemin wchar_t 32 bits ; flags GO64 ; -16 si occupé ; renvoie le handle ou une erreur négative.

int64_t read(void* p, uint64_t n)

Nombre d’octets ou erreur négative ; lecture partielle possible.

int64_t write(const void* p, uint64_t n)

Nombre d’octets ou erreur négative ; avancer le buffer après un transfert partiel.

int64_t seek(int64_t offset, uint64_t origin)

Offset signé et origine native ; résultat brut du noyau.

int64_t stat(GO64_FSInfo& info)

Remplit GO64_FSInfo pour le handle.

int64_t truncate(uint64_t size)

Modifie la taille du fichier.

int64_t next(GO64_FSInfo& info)

Lit une entrée du dossier ; conserve le résultat brut de readdir.

int64_t flags(uint64_t command, uint64_t value = 0)

Commande fcntl native ; value vaut 0 par défaut.

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.