====== std.fs ======

Datei-I/O direkt über POSIX-Systemaufrufe (sys_open, read, write, unlink, rename, lseek). Bietet Lesen (''ReadFile''), Schreiben (''WriteFile''), Anhängen (''AppendFile''), Löschen (''DeleteFile'') und Dateigröße (''FileSize''). Stdout/Stderr-Ausgabe (''StdoutWrite'', ''StderrWrite''), Zeichenausgabe (''PutChar'') und Pfad-Operationen: Normalisieren, Verzeichnis, Dateiname, Erweiterung und relative Pfadauflösung.

Einsatzbereiche: Konfigurationsdateien, Log-Dateien, Binärdaten-Speicherung, Systemdienste. Für komfortablere formatierte Ausgabe bietet ''std.io'' Print-Hilfsfunktionen.

**Autor:** Andreas Röne\\
**Copyright:** 2024-2025 Andreas Röne

----

===== Typen =====

==== fd = int64 ====

Dateideskriptor-Konventionen:
----

===== Konstanten =====

^ Name ^ Typ ^ Wert ^ Sichtbarkeit ^
| ''O_RDONLY'' | ''int64'' | ''0'' | pub |
| ''O_WRONLY'' | ''int64'' | ''1'' | pub |
| ''O_RDWR'' | ''int64'' | ''2'' | pub |
| ''O_CREAT'' | ''int64'' | ''64'' | pub |
| ''O_TRUNC'' | ''int64'' | ''512'' | pub |
| ''O_APPEND'' | ''int64'' | ''1024'' | pub |
| ''O_EXCL'' | ''int64'' | ''128'' | pub |
| ''S_IRUSR'' | ''int64'' | ''256'' | pub |
| ''S_IWUSR'' | ''int64'' | ''128'' | pub |
| ''S_IRGRP'' | ''int64'' | ''32'' | pub |
| ''S_IWGRP'' | ''int64'' | ''16'' | pub |
| ''S_IROTH'' | ''int64'' | ''4'' | pub |
| ''S_IWOTH'' | ''int64'' | ''2'' | pub |
| ''DEFAULT_MODE'' | ''int64'' | ''420'' | pub |
| ''STDIN_FILENO'' | ''int64'' | ''0'' | pub |
| ''STDOUT_FILENO'' | ''int64'' | ''1'' | pub |
| ''STDERR_FILENO'' | ''int64'' | ''2'' | pub |
| ''SEEK_SET'' | ''int64'' | ''0'' | pub |
| ''SEEK_CUR'' | ''int64'' | ''1'' | pub |
| ''SEEK_END'' | ''int64'' | ''2'' | pub |

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''IsValidFd(f: fd): bool'' | pub | Prüft ob Dateideskriptor gültig ist |
| ''ReadFile(path: pchar, buf: pchar, max_len: int64): int64'' | pub | Liest Dateiinhalt in Puffer ein |
| ''WriteFile(path: pchar, buf: pchar, len: int64): int64'' | pub | Schreibt Puffer vollständig in Datei |
| ''AppendFile(path: pchar, buf: pchar, len: int64): int64'' | pub | Hängt Puffer an bestehende Datei an |
| ''DeleteFile(path: pchar): bool'' | pub | Löscht Datei über sys_unlink |
| ''FileSize(path: pchar): int64'' | pub | Gibt Dateigröße in Bytes zurück |
| ''StdoutWrite(buf: pchar, len: int64): int64'' | pub | Schreibt Puffer auf Standardausgabe |
| ''StderrWrite(buf: pchar, len: int64): int64'' | pub | Schreibt Puffer auf Fehlerausgabe |
| ''PutChar(c: int64): int64'' | pub | Gibt einzelnes Zeichen auf stdout aus |
| ''PathNormalize(dest: pchar, src: pchar): pchar'' | pub | Normalisiert Pfad (entfernt ./ und ../) |
| ''PathDir(dest: pchar, path: pchar): pchar'' | pub | Extrahiert Verzeichnisteil aus Pfad |
| ''PathExt(dest: pchar, path: pchar): pchar'' | pub | Extrahiert Dateiendung aus Pfad |
| ''PathBase(dest: pchar, path: pchar): pchar'' | pub | Extrahiert Dateiname ohne Verzeichnis |
| ''PathResolve(dest: pchar, base: pchar, relative: pchar): pchar'' | pub | Löst relativen Pfad gegen Basispfad auf |
| ''FileExists(path: pchar): bool'' | pub | Prüft ob Datei oder Verzeichnis existiert |
| ''Rename(oldPath: pchar, newPath: pchar): bool'' | pub | Benennt Datei/Verzeichnis um |
| ''FileCopy(src: pchar, dest: pchar): bool'' | pub | Kopiert Datei |
| ''FileMove(src: pchar, dest: pchar): bool'' | pub | Verschiebt Datei (Copy + Delete) |
| ''FileStat(path: pchar, statBuf: int64): bool'' | pub | Füllt stat-Struktur (128 Bytes) |
| ''FileSizeFast(path: pchar): int64'' | pub | Dateigröße via stat (kein open) |
| ''FileModTime(path: pchar): int64'' | pub | Letzte Änderungszeit als Unix-Timestamp |
| ''FileAccessTime(path: pchar): int64'' | pub | Letzter Zugriffszeitpunkt als Unix-Timestamp |
| ''FilePerm(path: pchar): int64'' | pub | Dateiberechtigungen (untere 12 Bits der st_mode) |
| ''TmpFile(): pchar'' | pub | Erzeugt eindeutige Temp-Datei unter ''/tmp''; gibt heap-alloc'd Pfad (32 Bytes) zurück — Aufrufer muss ''free(ptr, 32)'' aufrufen |
| ''DirList(path: pchar): int64'' | pub | Liest Verzeichnisinhalt; gibt Handle zurück (0 = Fehler) |
| ''DirEntryCount(dirlist: int64): int64'' | pub | Anzahl Einträge im dirlist-Handle |
| ''DirEntryType(dirlist: int64, name: pchar, nameLen: int64): int64'' | pub | DT_*-Typ nach Name (lineare Suche) |
| ''DirEntryName(dirlist: int64, idx: int64): pchar'' | pub | Name des idx-ten Eintrags (0-basiert); gibt Zeiger in den Handle-Puffer zurück — nicht freigeben |
| ''DirEntryTypeAt(dirlist: int64, idx: int64): int64'' | pub | DT_*-Typ des idx-ten Eintrags; ''DT_UNKNOWN'' wenn außerhalb |
| ''DirFree(dirlist: int64): void'' | pub | Gibt dirlist-Handle frei |
| ''DirWalk(root: pchar): int64'' | pub | Rekursive Verzeichnis-Traversierung; gibt Walk-Handle zurück |
| ''DirWalkCount(result: int64): int64'' | pub | Anzahl gefundener Pfade im Walk-Handle |
| ''DirWalkPath(result: int64, index: int64, outBuf: pchar): int64'' | pub | Kopiert idx-ten Pfad in outBuf; gibt Länge zurück |
| ''DirWalkType(result: int64, index: int64): int64'' | pub | DT_*-Typ des idx-ten Walk-Eintrags |
| ''DirWalkFree(result: int64): void'' | pub | Gibt Walk-Handle frei |
| ''GlobMatch(pattern: pchar, name: pchar): bool'' | pub | Prüft ob Name auf Wildcard-Pattern passt (''*'', ''?'') |
| ''FileGlob(pattern: pchar): int64'' | pub | Sucht Dateien nach Muster; gibt Glob-Handle zurück |
| ''GlobCount(result: int64): int64'' | pub | Anzahl Treffer im Glob-Handle |
| ''GlobGet(result: int64, index: int64, outBuf: pchar): int64'' | pub | Kopiert idx-ten Treffer-Pfad in outBuf |
| ''GlobFree(result: int64): void'' | pub | Gibt Glob-Handle frei |