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

CKTIS / C#

Pesquisar, comparar e converter dados em vistas span

Pesquise e compare vistas de texto sem copiar os dados e converta campos em `int` ou `decimal` com regras de formato explícitas.

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

Sintaxe

using System;
using System.Globalization;

// Selected call forms for C# 12 / .NET 8:
ReadOnlySpan<char> text = sourceString.AsSpan();
ReadOnlySpan<char> part = sourceString.AsSpan(start, length);
Span<int> elements = sourceArray.AsSpan(); // sourceArray is int[]
int elementIndex = text.IndexOf(':');
int sequenceIndex = text.IndexOf(needle); // needle is ReadOnlySpan<char>
int textIndex = text.IndexOf(needle, StringComparison.OrdinalIgnoreCase);
bool same = text.SequenceEqual(needle);
bool sameIgnoringCase = MemoryExtensions.Equals(text, needle, StringComparison.OrdinalIgnoreCase);
bool intOk = int.TryParse(part, NumberStyles.None, CultureInfo.InvariantCulture, out int count);
bool decimalOk = decimal.TryParse(part, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out decimal price);

Em C# 12 e .NET 8, using System; dá acesso aos métodos de extensão de System.MemoryExtensions. AsSpan() cria uma vista sem copiar: de uma string obtém um ReadOnlySpan<char> e de uma matriz T[], um Span<T> que permite escrita. A sobrecarga AsSpan<T> para matrizes lança ArrayTypeMismatchException se a matriz for passada por covariância, por exemplo, se uma string[] for passada como object[]. AsSpan(start, length) seleciona um segmento; limites inválidos numa origem diferente de null provocam ArgumentOutOfRangeException. A forma sem argumentos devolve uma vista vazia para uma cadeia null. Ambos os tipos span são ref struct: a vista não pode sobreviver à memória subjacente e, em C# 12, não são permitidas variáveis locais span em métodos assíncronos ou iteradores.

IndexOf procura um elemento ou uma sequência contígua. Devolve o primeiro índice, contado a partir de zero na vista pesquisada, ou -1 se não encontrar; uma sequência vazia dá 0. Verifique o índice antes de extrair um segmento. As sobrecargas genéricas apresentadas usam IEquatable<T>; para char, comparam unidades de código UTF-16. Não é o mesmo que String.IndexOf: a sobrecarga com string usa a cultura atual por predefinição, enquanto a de char é ordinal. Para pesquisar numa vista de texto sem distinguir maiúsculas de minúsculas, use a sobrecarga com StringComparison.OrdinalIgnoreCase.

SequenceEqual exige o mesmo comprimento e elementos iguais nas posições correspondentes. Para spans de char, a chamada apresentada distingue maiúsculas de minúsculas e não normaliza Unicode; para ignorar essa distinção, use MemoryExtensions.Equals com StringComparison.OrdinalIgnoreCase. Nos spans, == verifica a posição inicial na memória e o comprimento, não o conteúdo. O método LINQ System.Linq.Enumerable.SequenceEqual trabalha com IEnumerable<T>, não com spans. Não presuma que SequenceEqual tem tempo de execução constante; para comparar dados secretos em bytes com o mesmo comprimento, use CryptographicOperations.FixedTimeEquals.

int.TryParse e decimal.TryParse aceitam ReadOnlySpan<char> sem criar uma subcadeia. Escolha NumberStyles e uma cultura de acordo com o formato: aqui NumberStyles.None não ativa elementos de formato opcionais, enquanto NumberStyles.AllowDecimalPoint aceita o separador decimal, que é . com CultureInfo.InvariantCulture. No .NET 8, ambos os métodos ignoram os carateres U+0000 no fim do campo, mesmo com estas definições. Se o formato os proibir, rejeite-os explicitamente antes da conversão. Use o valor out apenas se o resultado for true. Um campo vazio ou um valor que exceda o intervalo de int ao converter um inteiro devolve false, mas um valor inválido de NumberStyles pode lançar uma exceção.

Exemplos

using System;
using System.Globalization;

ReadOnlySpan<char> record = "item:42;19.95".AsSpan();
int colon = record.IndexOf(":".AsSpan());
if (colon < 0 || !record[..colon].SequenceEqual("item".AsSpan()))
{
    Console.WriteLine("Invalid record.");
    return;
}

ReadOnlySpan<char> fields = record[(colon + 1)..];
int separator = fields.IndexOf(';');
var culture = CultureInfo.InvariantCulture;
if (separator < 0 ||
    !int.TryParse(fields[..separator], NumberStyles.None, culture, out int count) ||
    !decimal.TryParse(fields[(separator + 1)..], NumberStyles.AllowDecimalPoint, culture, out decimal price))
{
    Console.WriteLine("Invalid record.");
    return;
}

Console.WriteLine(FormattableString.Invariant($"count={count}; price={price:0.00}"));

Resultado

count=42; price=19.95

O programa verifica a etiqueta `item`, encontra os dois separadores e converte dois campos sem criar subcadeias. O índice do ponto e vírgula é relativo a `fields`, não a `record`.

Lições relacionadas

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

Fontes