====== std.string ======

String-Operationen auf ''pchar''-Basis: Suchen (''StrFind'', ''StrIndexOf'', ''StrLastIndexOfChar''), Ersetzen (''StrReplace''), Teilstring (''StrSubstring''), Umkehren (''StrReverse''), Groß-/Kleinschreibung (''CharToLower''/''CharToUpper'', ''StrToLower''/''StrToUpper'', ''StrFirstCharToUpper''), Whitespace-Trim (''StrTrimWhitespace'', ''StrTrim''), Aufteilen (''StrSplit'') und Zählen (''StrCount''). ''StringBuilder'' als dynamischer String-Builder mit ''Append'', ''AppendChar'', ''AppendInt'' und ''FreeBuffer''.

Einsatzbereiche: Textverarbeitung, Protokoll-Parsing, Template-Ausgabe, URL-Verarbeitung — die meistgenutzte Unit der gesamten Standardbibliothek.

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

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''StrFind(haystack: pchar, needle: pchar): int64'' | pub | Sucht Teilstring, gibt Position zurück |
| ''StrSafeCharAt(s: pchar, index: int64): int64'' | pub | Liest Zeichen an Index sicher aus |
| ''CharToLower(c: int64): int64'' | pub | Wandelt Zeichen in Kleinbuchstaben |
| ''CharToUpper(c: int64): int64'' | pub | Wandelt Zeichen in Großbuchstaben |
| ''StrToLower(dest: pchar, src: pchar): pchar'' | pub | Wandelt String in Kleinschreibung |
| ''StrToUpper(dest: pchar, src: pchar): pchar'' | pub | Wandelt String in Großschreibung |
| ''IsWhitespace(c: int64): bool'' | pub | Prüft ob Zeichen Whitespace ist |
| ''StrReverse(s: pchar): pchar'' | pub | Kehrt String-Reihenfolge um |
| ''StrIndexOfChar(s: pchar, c: int64, startIndex: int64): int64'' | pub | Findet Zeichen ab Startposition |
| ''StrLastIndexOfChar(s: pchar, c: int64): int64'' | pub | Findet letztes Vorkommen eines Zeichens |
| ''StrAllIndicesOfCharCount(s: pchar, c: int64): int64'' | pub | Zählt alle Vorkommen eines Zeichens |
| ''StrTrimWhitespace(dest: pchar, src: pchar): pchar'' | pub | Entfernt Whitespace an beiden Enden |
| ''StrSubstring(dest: pchar, src: pchar, start: int64, len: int64): pchar'' | pub | Extrahiert Teilstring aus String |
| ''StrContains(s: pchar, needle: pchar): bool'' | pub | Prüft ob Teilstring enthalten ist |
| ''StrIndexOf(s: pchar, needle: pchar, startIndex: int64): int64'' | pub | Findet Teilstring ab Startposition |
| ''StrReplace(dest: pchar, src: pchar, old: pchar, replacement: pchar): pchar'' | pub | Ersetzt Teilstring durch Ersatztext |
| ''StrFirstCharToUpper(s: pchar): pchar'' | pub | Erstes Zeichen in Großbuchstaben |
| ''StrFirstCharToLower(s: pchar): pchar'' | pub | Erstes Zeichen in Kleinbuchstaben |
| ''StrLastCharToUpper(s: pchar): pchar'' | pub | Letztes Zeichen in Großbuchstaben |
| ''StrLastCharToLower(s: pchar): pchar'' | pub | Letztes Zeichen in Kleinbuchstaben |
| ''StrCount(s: pchar, needle: pchar): int64'' | pub | Zählt Vorkommen eines Teilstrings |
| ''StrFormat(fmt: pchar, a0: int64, a1: int64, a2: int64, a3: int64, a4: int64): pchar'' | pub | Formatiert String mit bis zu 5 Argumenten; Spezifizierer: ''%s'', ''%d'', ''%x'', ''%08x'', ''%%''; gibt heap-alloc'd pchar zurück |

----

===== Typen =====

==== StringBuilder (class) ====

**Felder:**

^ Feld ^ Typ ^
| ''buf'' | ''pchar'' |

**Methoden:**

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''StrTrim(s: pchar): pchar'' | pub | Entfernt führende und folgende Leerzeichen |
| ''StrSplit(s: pchar, delim: pchar, out: int64, maxParts: int64): int64'' | pub | Teilt String an Trennzeichen auf |