Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

MemoryExtensions.AsSpan e IndexOf: pesquisar numa vista de texto

Cria uma vista de texto sem o copiar, procura um elemento ou uma sequência e escreve o segmento com `Console.Out.Write` sem criar uma subcadeia.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

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 e IndexOf são aqui métodos de extensão estáticos de System.MemoryExtensions. Com using System;, text.AsSpan() equivale a MemoryExtensions.AsSpan(text) e view.IndexOf('=') a MemoryExtensions.IndexOf<char>(view, '='). Não são métodos de instância de string e de ReadOnlySpan<char>, respetivamente. string.IndexOf é um método de instância distinto que pesquisa na própria cadeia.

AsSpan() devolve um ReadOnlySpan<char> sobre a cadeia inteira, AsSpan(start) uma vista de start até ao fim e AsSpan(start, length) uma vista com o comprimento indicado a partir de start. A vista não copia os dados nem permite alterá-los. AsSpan() sem deslocamento devolve uma vista vazia para null; limites inválidos numa cadeia não nula provocam ArgumentOutOfRangeException. Em contraste, AsSpan<T>(T[]) devolve um Span<T> que permite escrever no array.

As sobrecargas genéricas de IndexOf<T> procuram um elemento T ou uma sequência contígua ReadOnlySpan<T>, comparando os elementos com IEquatable<T>.Equals. Também existem sobrecargas com um recetor Span<T>. Para uma sequência de char, pode indicar-se StringComparison: Ordinal distingue maiúsculas de minúsculas e não depende da cultura. O resultado é o índice da primeira ocorrência, com base zero e relativo à vista, ou -1. Os índices de texto contam unidades de código UTF-16, não os caracteres percecionados. Verifica >= 0 antes de usar o resultado para indexar ou extrair um segmento.

Slice é um método de instância que devolve uma vista mais restrita. Console.Out é um System.IO.TextWriter, pelo que Console.Out.Write(view) chama o seu método de instância virtual Write(ReadOnlySpan<char>) sem acrescentar uma mudança de linha. O código que chama o método não precisa de criar uma subcadeia; isso não garante que o objeto de escrita nunca aloque memória internamente.

Em C# 12, ReadOnlySpan<T> é um ref struct: não é possível guardá-lo num campo de classe, aplicar-lhe boxing ou declarar uma variável desse tipo num método async. O exemplo é síncrono e destina-se a .NET 8; versões posteriores do ambiente de execução podem acrescentar funcionalidades compatíveis.

Exemplos

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();
}

Resultado

4 5 -1
ada

A vista contém `name=ada`: `=` está no índice `4`, `ada` começa em `5` e `:` só aparece no prefixo ignorado, pelo que essa pesquisa devolve `-1`. `Slice(separator + 1)` seleciona `ada` para `Console.Out.Write`.

Lições relacionadas

  • C# · Lição 9 · Avançado · Versão: 3

Fontes