KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

MemoryExtensions.AsSpan en IndexOf: zoeken in een tekstweergave

Maak een weergave van tekst zonder die te kopiëren, zoek een element of reeks en schrijf het fragment met `Console.Out.Write` zonder een deelstring te maken.

Versie: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

using System;

// Selected .NET 8 signatures, declared in System.MemoryExtensions:
public static ReadOnlySpan<char> AsSpan(this string? text);
public static ReadOnlySpan<char> AsSpan(this string? text, int start);
public static ReadOnlySpan<char> AsSpan(this string? text, int start, int length);
public static Span<T> AsSpan<T>(this T[]? array);
public static int IndexOf<T>(this ReadOnlySpan<T> span, T value) where T : IEquatable<T>?;
public static int IndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value) where T : IEquatable<T>?;
public static int IndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType);

// Equivalent calls when the extension methods are in scope:
ReadOnlySpan<char> view = text.AsSpan(start, length);
ReadOnlySpan<char> sameView = System.MemoryExtensions.AsSpan(text, start, length);
int index = view.IndexOf('=');
int sameIndex = System.MemoryExtensions.IndexOf<char>(view, '=');

// Output uses a virtual instance method on System.IO.TextWriter:
Console.Out.Write(view);

AsSpan en IndexOf zijn hier statische extensiemethoden van System.MemoryExtensions. Met using System; is text.AsSpan() gelijkwaardig aan MemoryExtensions.AsSpan(text) en view.IndexOf('=') aan MemoryExtensions.IndexOf<char>(view, '='). Het zijn geen instantiemethoden van respectievelijk string en ReadOnlySpan<char>. string.IndexOf is een aparte instantiemethode die in de string zelf zoekt.

AsSpan() geeft een ReadOnlySpan<char> over de hele string, AsSpan(start) een weergave vanaf start tot het einde en AsSpan(start, length) een weergave met de opgegeven lengte vanaf start. De weergave kopieert geen gegevens en laat je ze niet wijzigen. AsSpan() zonder startindex geeft voor null een lege weergave; ongeldige grenzen bij een niet-null string leiden tot ArgumentOutOfRangeException. AsSpan<T>(T[]) geeft daarentegen een schrijfbare Span<T> over de array.

De generieke overloads van IndexOf<T> zoeken één element T of een aaneengesloten reeks ReadOnlySpan<T> en vergelijken de elementen met IEquatable<T>.Equals. Er zijn ook overloads voor een Span<T> als ontvanger. Voor een reeks char kun je StringComparison opgeven: Ordinal is hoofdlettergevoelig en cultuuronafhankelijk. De uitkomst is de index van de eerste overeenkomst, geteld vanaf nul binnen de weergave, of -1. Tekstindexen tellen UTF-16-code-eenheden, niet de tekens zoals een lezer die waarneemt. Controleer >= 0 voordat je de uitkomst gebruikt om te indexeren of een deelweergave te maken.

Slice is een instantiemethode die een kleinere weergave geeft. Console.Out is een System.IO.TextWriter, dus Console.Out.Write(view) roept de virtuele instantiemethode Write(ReadOnlySpan<char>) aan zonder een regeleinde toe te voegen. De aanroeper hoeft geen deelstring te maken; dat garandeert niet dat de writer intern geen geheugen alloceert.

In C# 12 is ReadOnlySpan<T> een ref struct: je kunt die niet opslaan in een klasseveld, boxen of als variabele declareren in een async-methode. Het voorbeeld is synchroon en gericht op .NET 8; latere runtimes kunnen compatibele functies toevoegen.

Voorbeelden

using System;

const string input = "log:name=ada";
ReadOnlySpan<char> field = input.AsSpan(4, 8);

int separator = field.IndexOf('=');
int name = MemoryExtensions.IndexOf(field, "ada".AsSpan(), StringComparison.Ordinal);
int missing = field.IndexOf(':');

Console.WriteLine(FormattableString.Invariant($"{separator} {name} {missing}"));
if (separator >= 0)
{
    ReadOnlySpan<char> value = field.Slice(separator + 1);
    Console.Out.Write(value);
    Console.Out.WriteLine();
}

Resultaat

4 5 -1
ada

De weergave bevat `name=ada`: `=` staat op index `4`, `ada` begint op `5` en `:` staat alleen in het overgeslagen voorvoegsel, dus die zoekopdracht levert `-1` op. `Slice(separator + 1)` selecteert `ada` voor `Console.Out.Write`.

Gerelateerde lessen

  • C# · Les 9 · Gevorderd · Versie: 3

Bronnen