====== std.buffer ======

Grundlegende Byte-Buffer-Operationen auf rohen Speicherbereichen ohne eigene Allokation. Enthält Funktionen zum Kopieren (''BufferCopy''), Füllen (''BufferFill''), Umkehren (''BufferReverse''), Suchen (''BufferFind'') und Vergleichen (''BufferEquals'') von Byte-Arrays sowie Hex-Kodierung (''BufferToHex'', ''HexToBuffer'') und String-Konvertierung.

Einsatzbereiche: interne Hilfsbibliothek für Netzwerk-, Krypto- und I/O-Units; Protokoll-Frame-Verarbeitung; Binärdatenmanipulation auf niedrigster Ebene.

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

----

===== Konstanten =====

^ Name ^ Typ ^ Wert ^ Sichtbarkeit ^
| ''DEFAULT_BUFFER_CAPACITY'' | ''int64'' | ''256'' | pub |
| ''MIN_BUFFER_CAPACITY'' | ''int64'' | ''16'' | pub |
| ''GROWTH_FACTOR'' | ''int64'' | ''2'' | pub |

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''BufferCalculateCapacity(current: int64, needed: int64): int64'' | pub | Berechnet neue Kapazität mit Wachstumsfaktor |
| ''BufferEquals(buf1: pchar, len1: int64, buf2: pchar, len2: int64): bool'' | pub | Vergleicht zwei Byte-Puffer auf Gleichheit |
| ''BufferFind(haystack: pchar, hlen: int64, needle: pchar, nlen: int64): int64'' | pub | Sucht Teilpuffer im Byte-Puffer |
| ''BufferCopy(dest: pchar, src: pchar, len: int64): int64'' | pub | Kopiert Bytes von Quelle nach Ziel |
| ''BufferFill(buf: pchar, len: int64, byte: int64): void'' | pub | Füllt Puffer mit einem Byte-Wert |
| ''BufferReverse(buf: pchar, len: int64): void'' | pub | Kehrt Byte-Reihenfolge im Puffer um |
| ''ByteToHex(byte: int64, output: pchar): int64'' | pub | Kodiert ein Byte als Hex-String |
| ''BufferToHex(input: pchar, len: int64, output: pchar): int64'' | pub | Kodiert Byte-Puffer als Hex-String |
| ''HexToBuffer(input: pchar, output: pchar): int64'' | pub | Dekodiert Hex-String in Byte-Puffer |
| ''Base64EncodedLen(input_len: int64): int64'' | pub | Berechnet Base64-Ausgabelänge |
| ''Base64DecodedLen(input_len: int64): int64'' | pub | Berechnet Base64-Dekodier-Byte-Länge |
| ''BufferAppendString(buf: pchar, buf_len: int64, str: pchar, max_out: int64): int64'' | pub | Hängt C-String an Byte-Puffer an |
| ''BufferToString(buf: pchar, len: int64, output: pchar): int64'' | pub | Kopiert Puffer als nullterminierten String |