class UncasedNeedleFills a gap: no .NET caseless UTF-8 search. Dispose to free the native copy.
Case folding fills a gap: .NET has no public Unicode case-folding API.
byte[] folded = Sz.CaseFold("Straße"u8); // -> "strasse"
long position = Sz.UncasedIndexOf(haystack, "WÖRLD"u8, out long matched); // caseless search
using UncasedNeedle needle = new("fox"u8); // prepared once, reusable across haystacks and threads
needle.IndexIn(document, out long matchedLength);
byte[] composed = Sz.Normalize(text, Sz.NormalForm.Nfc); // cf. string.Normalize
int written = Sz.Normalize(text, Sz.NormalForm.Nfc, destination); // allocation-free variant
Sz.Normalize("é"u8, Sz.NormalForm.Nfc); // "e" + U+0301 -> precomposed "é"
Sz.Normalize("fi"u8, Sz.NormalForm.Nfkc); // ligature "fi" -> "fi"
Sz.Normalize("Straße"u8, Sz.NormalForm.NfkcCasefold); // NFKC with case folding -> "strasse", for caseless keysAPI
ClassUncasedNeedleA case-folding search needle, prepared once to search many haystacks from any thread.3
UncasedNeedleCopies needle into native memory and prepares it for caseless search.
UncasedNeedle(ReadOnlySpan<byte> needle);IndexInFirst byte offset of this needle in haystack (caseless), or -1.
long IndexIn(ReadOnlySpan<byte> haystack, out long matchedLength);DisposeFrees the native copy of the needle; calling it again does nothing.
void Dispose();