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
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- Extension members (C# Programming Guide)
- String.IndexOf Method (System)
- ReadOnlySpan<T>.Slice Method (System)
- ref structure types (C# reference)
- Introduction to character encoding in .NET
- Best practices for comparing strings in .NET
- Console.Out Property (System)
- TextWriter.Write Method (System.IO) — Write(ReadOnlySpan<Char>)