CKTIS / C#
MemoryExtensions.AsSpan e IndexOf: buscar en una vista de texto
Crea una vista de texto sin copiarlo, busca un elemento o una secuencia y escribe el fragmento mediante `Console.Out.Write` sin crear una subcadena.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
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 son aquí métodos de extensión estáticos de System.MemoryExtensions. Con using System;, text.AsSpan() equivale a MemoryExtensions.AsSpan(text), y view.IndexOf('=') a MemoryExtensions.IndexOf<char>(view, '='). No son métodos de instancia de string y ReadOnlySpan<char>, respectivamente. string.IndexOf es un método de instancia distinto que busca en la propia cadena.
AsSpan() devuelve un ReadOnlySpan<char> sobre toda la cadena, AsSpan(start) ofrece una vista desde start hasta el final y AsSpan(start, length) una vista de la longitud indicada desde start. La vista no copia los datos ni permite modificarlos. AsSpan() sin desplazamiento devuelve una vista vacía para null; unos límites no válidos en una cadena no nula provocan ArgumentOutOfRangeException. En cambio, AsSpan<T>(T[]) devuelve un Span<T> que permite modificar el array.
Las sobrecargas genéricas de IndexOf<T> buscan un elemento T o una secuencia contigua ReadOnlySpan<T> y comparan los elementos mediante IEquatable<T>.Equals. También hay sobrecargas con un receptor Span<T>. Para una secuencia de char se puede indicar StringComparison: Ordinal distingue mayúsculas de minúsculas y no depende de la cultura. El resultado es el índice de la primera coincidencia desde cero y relativo a la vista, o -1. Los índices de texto cuentan unidades de código UTF-16, no caracteres percibidos. Comprueba >= 0 antes de usarlo para indexar o recortar la vista.
Slice es un método de instancia que crea una vista más estrecha. Console.Out es un System.IO.TextWriter, así que Console.Out.Write(view) llama a su método de instancia virtual Write(ReadOnlySpan<char>) sin añadir un salto de línea. Quien llama no necesita crear una subcadena; eso no garantiza que el escritor no reserve memoria internamente.
En C# 12, ReadOnlySpan<T> es un ref struct: no se puede guardar en un campo de clase, someter a boxing ni declarar como variable en un método async. El ejemplo es síncrono y está dirigido a .NET 8; versiones posteriores del entorno de ejecución pueden añadir funciones compatibles.
Ejemplos
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
La vista contiene `name=ada`: `=` está en el índice `4`, `ada` empieza en `5` y `:` solo aparece en el prefijo omitido, por lo que esa búsqueda devuelve `-1`. `Slice(separator + 1)` selecciona `ada` para `Console.Out.Write`.
Lecciones relacionadas
- C# · Lección 9 · Avanzado · Versión: 3
Fuentes
- 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>)