ReadOnlySpan<T> Estrutura

Definição

Fornece uma representação de leitura segura para tipos e memória de uma região contígua de memória arbitrária.

generic <typename T>
public value class ReadOnlySpan
[System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))]
public readonly ref struct ReadOnlySpan<T>
public readonly ref struct ReadOnlySpan<T>
[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))>]
type ReadOnlySpan<'T> = struct
type ReadOnlySpan<'T> = struct
Public Structure ReadOnlySpan(Of T)

Parâmetros de Tipo Genérico

T

O tipo de itens no ReadOnlySpan<T>.

Herança
ReadOnlySpan<T>
Atributos

Observações

ReadOnlySpan<T> é uma struct de referência que é alocada na pilha e nunca pode escapar para o heap gerido. Os tipos de ref struct têm várias restrições para garantir que não podem ser promovidos para o heap gerido, incluindo que não podem ser agrupados, capturados em expressões lambda, atribuídos a variáveis do tipo Object, atribuídos a dynamic variáveis, e não podem implementar qualquer tipo de interface.

Uma ReadOnlySpan<T> instância é frequentemente usada para referenciar os elementos de um array ou uma parte de um array. Ao contrário de uma matriz, no entanto, uma instância ReadOnlySpan<T> pode referir-se a memória gerida, memória nativa ou memória gerida na pilha.

Construtores

Name Description
ReadOnlySpan<T>(T)

Cria um novo ReadOnlySpan<T> de comprimento 1 em torno da referência especificada.

ReadOnlySpan<T>(T[], Int32, Int32)

Cria um novo ReadOnlySpan<T> que inclui um número especificado de elementos de um array a partir de um índice especificado.

ReadOnlySpan<T>(T[])

Cria um novo ReadOnlySpan<T> ao longo de todo um array especificado.

ReadOnlySpan<T>(Void*, Int32)

Cria um novo ReadOnlySpan<T> a partir de um número especificado de T elementos a partir de um endereço de memória especificado.

Propriedades

Name Description
Empty

Devolve um ficheiro ReadOnlySpan<T>.

IsEmpty

Devolve um valor que indica que o intervalo de apenas leitura atual está vazio.

Item[Int32]

Obtém um item do intervalo de apenas leitura no índice zero especificado.

Length

O número de itens no intervalo de apenas leitura.

Métodos

Name Description
CastUp<TDerived>(ReadOnlySpan<TDerived>)

Conjura um intervalo de apenas leitura de TDerived para um intervalo de apenas leitura de T.

CopyTo(Span<T>)

Copia o conteúdo disto ReadOnlySpan<T> para um destino Span<T>.

Equals(Object)
Obsoleto.
Obsoleto.

Não suportado. Lança um NotSupportedException.

GetEnumerator()

Devolve um enumerador para este ReadOnlySpan<T>.

GetHashCode()
Obsoleto.

Não suportado. Lança um NotSupportedException.

GetPinnableReference()

Devolve uma referência somente de leitura a um objeto do tipo T que pode ser usado para fixação.

Este método destina-se a suportar compiladores .NET e não deve ser chamado por código de utilizador.

Slice(Int32, Int32)

Forma uma fatia a partir do vão atual de apenas leitura começando num índice especificado para um comprimento especificado.

Slice(Int32)

Forma uma fatia a partir do intervalo atual de apenas leitura que começa num índice especificado.

ToArray()

Copia o conteúdo deste intervalo de apenas leitura para um novo array.

ToString()

Devolve a representação da cadeia desta ReadOnlySpan<T>.

TryCopyTo(Span<T>)

Tenta copiar o conteúdo disto ReadOnlySpan<T> para um Span<T> e retorna um valor para indicar se a operação teve sucesso ou não.

Operadores

Name Description
Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)

Devolve um valor que indica se duas ReadOnlySpan<T> instâncias são iguais.

Implicit(ArraySegment<T> to ReadOnlySpan<T>)

Define uma conversão implícita de um ArraySegment<T> para um ReadOnlySpan<T>.

Implicit(T[] to ReadOnlySpan<T>)

Define uma conversão implícita de um array para um ReadOnlySpan<T>.

Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)

Devolve um valor que indica se duas ReadOnlySpan<T> instâncias não são iguais.

Métodos da Extensão

Name Description
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)

Pesquisa um valor inteiro ordenado ReadOnlySpan<T> usando o tipo genérico especificado TComparable .

BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)

Pesquisa numa ordenação ReadOnlySpan<T> inteira por um valor especificado usando o tipo genérico especificado TComparer .

BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)

Pesquisa um valor inteiro ordenado ReadOnlySpan<T> usando a interface genérica especificada IComparable<T> .

CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Determina o comprimento de qualquer prefixo comum partilhado entre span e other.

CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Encontra o comprimento de qualquer prefixo comum partilhado entre span e other.

Contains<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Procura o valor especificado e devolve true o valor se for encontrado. Se não for encontrado, devolve false.

Contains<T>(ReadOnlySpan<T>, T)

Indica se um valor especificado é encontrado num intervalo de apenas leitura.

ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Pesquisa por qualquer ocorrência de qualquer um dos especificados values e devolve true os resultados se encontrados. Se não for encontrado, devolve false.

ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura uma ocorrência de qualquer um dos especificados values.

ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>)

Procura uma ocorrência de qualquer um dos especificados values.

ContainsAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura uma ocorrência de qualquer um dos valores especificados.

ContainsAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura qualquer ocorrência dos valores especificados no intervalo especificado.

ContainsAny<T>(ReadOnlySpan<T>, T, T, T)

Procura uma ocorrência de value0, value1, ou value2 no espaço especificado.

ContainsAny<T>(ReadOnlySpan<T>, T, T)

Procura uma ocorrência de value0 ou value1.

ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Pesquisa no intervalo especificado qualquer valor que não seja o especificado values.

ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Pesquisa no intervalo especificado qualquer valor que não seja o especificado values.

ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)

Pesquisa no intervalo especificado qualquer valor que não seja o especificado values.

ContainsAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Pesquisa no espaço especificado qualquer valor que não valueseja .

ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura por qualquer valor que não value0 seja ou value1.

ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura qualquer valor que não value0seja , value1, ou value2.

ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)

Procura qualquer valor que não value0seja , value1, ou value2.

ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)

Pesquisa no intervalo especificado qualquer valor que não value0 seja ou value1.

ContainsAnyExcept<T>(ReadOnlySpan<T>, T)

Pesquisa no intervalo especificado qualquer valor que não seja o especificado value.

ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Procura qualquer valor fora do intervalo entre lowInclusive e highInclusive, inclusive.

ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)

Procura qualquer valor no intervalo entre lowInclusive e highInclusive, inclusive.

Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Conta o número de vezes que o especificado value ocorre no span.

Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Conta o número de vezes value que ocorre em span.

Count<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Conta o número de vezes que o especificado value ocorre no span.

Count<T>(ReadOnlySpan<T>, T)

Conta o número de vezes que o especificado value ocorre no span.

CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Conta o número de vezes que qualquer um dos especificados values ocorre no span.

CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Conta o número de vezes que qualquer um dos especificados values ocorre no span.

CountAny<T>(ReadOnlySpan<T>, SearchValues<T>)

Conta o número de vezes que qualquer um dos especificados values ocorre no span.

EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Determina se a sequência especificada aparece no final do intervalo de apenas leitura.

EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Determina se a sequência especificada aparece no final de um intervalo apenas de leitura.

EndsWith<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Determina se o valor especificado aparece no final do vão.

EndsWith<T>(ReadOnlySpan<T>, T)

Determina se o valor especificado aparece no final do vão.

IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura a sequência especificada e devolve o índice da sua primeira ocorrência.

IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura a sequência especificada e devolve o índice da sua primeira ocorrência.

IndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Procura o valor especificado e devolve o índice da sua primeira ocorrência.

IndexOf<T>(ReadOnlySpan<T>, T)

Procura o valor especificado e devolve o índice da sua primeira ocorrência.

IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAny<T>(ReadOnlySpan<T>, T, T)

Procura o primeiro índice de qualquer um dos valores especificados.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura o primeiro índice de qualquer valor diferente do especificado values.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura o primeiro índice de qualquer valor diferente do especificado values.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)

Procura o primeiro índice de qualquer valor diferente do especificado values.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Procura o primeiro índice de qualquer valor diferente do especificado value.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura o primeiro índice de qualquer valor diferente dos dois valores especificados.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura o primeiro índice de qualquer valor que não value0seja , value1, ou value2.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)

Procura o primeiro índice de qualquer valor que não value0seja , value1, ou value2.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)

Procura o primeiro índice de qualquer valor diferente dos dois valores especificados.

IndexOfAnyExcept<T>(ReadOnlySpan<T>, T)

Procura o primeiro índice de qualquer valor diferente do especificado value.

IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Pesquisas pelo primeiro índice de qualquer valor fora do intervalo entre lowInclusive e highInclusive, inclusive.

IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)

Procura o primeiro índice de qualquer valor no intervalo entre lowInclusive e highInclusive, inclusive.

LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura a sequência especificada e devolve o índice da sua última ocorrência. Se não for encontrado, devolve -1.

LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura a sequência especificada e devolve o índice da sua última ocorrência.

LastIndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Procura o valor especificado e devolve o índice da sua última ocorrência. Se não for encontrado, devolve -1.

LastIndexOf<T>(ReadOnlySpan<T>, T)

Procura o valor especificado e devolve o índice da sua última ocorrência.

LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAny<T>(ReadOnlySpan<T>, T, T)

Procura o último índice de qualquer um dos valores especificados.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Procura o último índice de qualquer valor diferente do especificado values.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Procura o último índice de qualquer valor diferente do especificado values.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)

Procura o último índice de qualquer valor diferente do especificado values.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Procura o último índice de qualquer valor diferente do especificado value.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)

Procura o último índice de qualquer valor que não seja especificado value0 ou value1.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)

Procura o último índice de qualquer valor diferente do especificado value0, value1, ou value2.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)

Procura o último índice de qualquer valor diferente do especificado value0, value1, ou value2.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)

Procura o último índice de qualquer valor que não seja especificado value0 ou value1.

LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)

Procura o último índice de qualquer valor diferente do especificado value.

LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Pesquisa pelo último índice de qualquer valor fora do intervalo entre lowInclusive e highInclusive, inclusive.

LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)

Procura o último índice de qualquer valor no intervalo entre lowInclusive e highInclusive, inclusive.

Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)

Determina se duas sequências de apenas leitura se sobrepõem na memória e gera o deslocamento de elemento.

Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Determina se duas sequências de apenas leitura se sobrepõem na memória.

Replace<T>(ReadOnlySpan<T>, Span<T>, T, T, IEqualityComparer<T>)

Cópias source para destination, substituindo todas as ocorrências de oldValue por newValue.

Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)

Cópias source para destination, substituindo todas as ocorrências de oldValue por newValue.

ReplaceAny<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)

Cópias source para destination, substituindo todas as ocorrências de qualquer um dos elementos em values com newValue.

ReplaceAnyExcept<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)

Cópias source para destination, substituindo todas as ocorrências de qualquer um dos elementos exceto aqueles em values com newValue.

SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IComparer<T>)

Determina a ordem relativa das sequências comparadas comparando os elementos usando IComparable{T}. CompareTo(T).

SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Determina a ordem relativa de duas sequências somente de leitura comparando os seus elementos usando IComparable{T}. CompareTo(T).

SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Determina se duas sequências são iguais comparando os elementos usando um IEqualityComparer<T>.

SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Determina se duas sequências somente de leitura são iguais comparando os elementos usando IEquatable{T}. É igual a T.

Split<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Devolve um tipo que permite enumerar cada elemento dentro de um intervalo dividido usando o intervalo separador fornecido.

Split<T>(ReadOnlySpan<T>, T)

Devolve um tipo que permite enumerar cada elemento dentro de um espaço dividido usando o carácter separador fornecido.

SplitAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Devolve um tipo que permite enumerar cada elemento dentro de um espaço dividido usando qualquer um dos elementos fornecidos.

SplitAny<T>(ReadOnlySpan<T>, SearchValues<T>)

Devolve um tipo que permite a enumeração de cada elemento dentro de um espaço dividido usando os caracteres separadores fornecidos.

StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Determina se uma sequência especificada aparece no início de um intervalo de apenas leitura.

StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Determina se uma sequência especificada aparece no início de um intervalo de apenas leitura.

StartsWith<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)

Determina se o valor especificado aparece no início do intervalo.

StartsWith<T>(ReadOnlySpan<T>, T)

Determina se o valor especificado aparece no início do intervalo.

ToImmutableArray<T>(ReadOnlySpan<T>)

Produzir um conjunto imutável de conteúdos a partir de elementos especificados.

Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Remove todas as ocorrências iniciais e finais de um conjunto de elementos especificados num intervalo de apenas leitura de um intervalo de apenas leitura.

Trim<T>(ReadOnlySpan<T>, T)

Remove todas as ocorrências iniciais e finais de um elemento especificado de um espaço apenas de leitura.

TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Remove todas as ocorrências finais de um conjunto de elementos especificados num intervalo de apenas leitura de um intervalo de apenas leitura.

TrimEnd<T>(ReadOnlySpan<T>, T)

Remove todas as ocorrências finais de um elemento especificado de um intervalo de apenas leitura.

TrimStart<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Remove todas as ocorrências iniciais de um conjunto de elementos especificados num intervalo de apenas leitura do espaço.

TrimStart<T>(ReadOnlySpan<T>, T)

Remove todas as ocorrências principais de um elemento especificado do espaço.

Aplica-se a

Ver também