====== 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 |

----

===== Typen =====

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

**Felder:**

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

**Methoden:**

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''Init(initialCap: int64)'' | priv | Initialisiert Builder mit Kapazität |
| ''Append(s: pchar)'' | priv | Hängt String an Buffer an |
| ''AppendChar(c: int64)'' | priv | Hängt einzelnes Zeichen an |
| ''AppendInt(n: int64)'' | priv | Hängt Integer als Text an |
| ''ToString(): pchar'' | priv | Gibt fertigen String zurück |
| ''Clear()'' | priv | Leert den Buffer-Inhalt |
| ''FreeBuffer()'' | priv | Gibt Buffer-Speicher frei |


^ 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 |