ReadOnlySpan<T> Estrutura

Definição

Namespace:: System

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Origem:: ReadOnlySpan.cs

Origem:: ReadOnlySpan.cs

Origem:: ReadOnlySpan.cs

Origem:: ReadOnlySpan.cs

Origem:: ReadOnlySpan.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma representação somente leitura com segurança de tipo 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

T

O tipo de itens no ReadOnlySpan<T>.

Herança: Object

ValueType
ReadOnlySpan<T>

Atributos: NativeMarshallingAttribute

Comentários

ReadOnlySpan<T> é um struct ref que é alocado na pilha e nunca pode escapar para o heap gerenciado. Os tipos de struct de ref têm uma série de restrições para garantir que eles não possam ser promovidos ao heap gerenciado, incluindo que eles não podem ser boxizados, capturados em expressões lambda, atribuídos a variáveis de tipo Object, atribuídos a dynamic variáveis e que não podem implementar nenhum tipo de interface.

Uma ReadOnlySpan<T> instância geralmente é usada para referenciar os elementos de uma matriz ou uma parte de uma matriz. Ao contrário de uma matriz, no entanto, uma ReadOnlySpan<T> instância pode apontar para memória gerenciada, memória nativa ou memória gerenciada na pilha.

Construtores

Nome	Description
ReadOnlySpan<T>(T)	Cria um novo ReadOnlySpan<T> 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 uma matriz começando em um índice especificado.
ReadOnlySpan<T>(T[])	Cria um novo ReadOnlySpan<T> em toda a matriz especificada.
ReadOnlySpan<T>(Void*, Int32)	Cria um novo ReadOnlySpan<T> de um número especificado de `T` elementos começando em um endereço de memória especificado.

Propriedades

Nome	Description
Empty	Retorna um vazio ReadOnlySpan<T>.
IsEmpty	Retorna um valor que indica que o intervalo somente leitura atual está vazio.
Item[Int32]	Obtém um item do intervalo somente leitura no índice baseado em zero especificado.
Length	O número de itens no intervalo somente leitura.

Métodos

Nome	Description
CastUp<TDerived>(ReadOnlySpan<TDerived>)	Converte um intervalo somente leitura de `TDerived` um intervalo somente leitura de `T`.
CopyTo(Span<T>)	Copia o conteúdo disso ReadOnlySpan<T> em um destino Span<T>.
Equals(Object)	Obsoleto. Obsoleto. Sem suporte. Lança NotSupportedException.
GetEnumerator()	Retorna um enumerador para isso ReadOnlySpan<T>.
GetHashCode()	Obsoleto. Sem suporte. Lança NotSupportedException.
GetPinnableReference()	Retorna uma referência somente leitura a um objeto do tipo T que pode ser usado para fixação. Esse método destina-se a dar suporte a compiladores .NET e não se destina a ser chamado pelo código do usuário.
Slice(Int32, Int32)	Forma uma fatia do intervalo somente leitura atual começando em um índice especificado para um comprimento especificado.
Slice(Int32)	Forma uma fatia do intervalo somente leitura atual que começa em um índice especificado.
ToArray()	Copia o conteúdo desse intervalo somente leitura em uma nova matriz.
ToString()	Retorna a representação de cadeia de caracteres deste ReadOnlySpan<T>.
TryCopyTo(Span<T>)	Tenta copiar o conteúdo disso ReadOnlySpan<T> em um Span<T> e retorna um valor para indicar se a operação foi ou não bem-sucedida.

Operadores

Nome	Description
Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Retorna 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> em um ReadOnlySpan<T>.
Implicit(T[] to ReadOnlySpan<T>)	Define uma conversão implícita de uma matriz em um ReadOnlySpan<T>.
Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Retorna um valor que indica se duas ReadOnlySpan<T> instâncias não são iguais.

Métodos de Extensão

Nome	Description
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	Pesquisa um valor inteiro classificado ReadOnlySpan<T> usando o tipo genérico especificado `TComparable` .
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	Pesquisa uma classificação ReadOnlySpan<T> inteira para um valor especificado usando o tipo genérico especificado `TComparer` .
BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)	Pesquisa um valor inteiro classificado 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 compartilhado entre `span` e `other`.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Localiza o comprimento de qualquer prefixo comum compartilhado entre `span` e `other`.
Contains<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o valor especificado e retorna `true` se encontrado. Se não for encontrado, retornará `false`.
Contains<T>(ReadOnlySpan<T>, T)	Indica se um valor especificado é encontrado em um intervalo somente leitura.
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa qualquer ocorrência de qualquer um dos especificados `values` e retorna `true` se encontrado. Se não for encontrado, retornará `false`.
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa uma ocorrência de qualquer um dos especificados `values`.
ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa uma ocorrência de qualquer um dos especificados `values`.
ContainsAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa uma ocorrência de qualquer um dos valores especificados.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa qualquer ocorrência dos valores especificados no intervalo especificado.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa uma ocorrência de `value0`, `value1`ou `value2` no intervalo especificado.
ContainsAny<T>(ReadOnlySpan<T>, T, T)	Pesquisa uma ocorrência de `value0` ou `value1`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa o intervalo especificado para qualquer valor diferente do especificado `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa o intervalo especificado para qualquer valor diferente do especificado `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa o intervalo especificado para qualquer valor diferente do especificado `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o intervalo especificado para qualquer valor diferente de `value`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa qualquer valor diferente `value0` ou `value1`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa qualquer valor diferente `value0`de , `value1`ou `value2`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa qualquer valor diferente `value0`de , `value1`ou `value2`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)	Pesquisa o intervalo especificado para qualquer valor diferente `value0` ou `value1`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T)	Pesquisa o intervalo especificado para qualquer valor diferente do especificado `value`.
ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa qualquer valor fora do intervalo entre `lowInclusive` e `highInclusive`, inclusive.
ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa 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` 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 somente leitura.
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se a sequência especificada aparece no final de um intervalo somente leitura.
EndsWith<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Determina se o valor especificado aparece no final do intervalo.
EndsWith<T>(ReadOnlySpan<T>, T)	Determina se o valor especificado aparece no final do intervalo.
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa a sequência especificada e retorna o índice de sua primeira ocorrência.
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa a sequência especificada e retorna o índice de sua primeira ocorrência.
IndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o valor especificado e retorna o índice de sua primeira ocorrência.
IndexOf<T>(ReadOnlySpan<T>, T)	Pesquisa o valor especificado e retorna o índice de sua primeira ocorrência.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAny<T>(ReadOnlySpan<T>, T, T)	Pesquisa o primeiro índice de qualquer um dos valores especificados.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer valor diferente do especificado `values`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa o primeiro índice de qualquer valor diferente do especificado `values`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa o primeiro índice de qualquer valor diferente do especificado `values`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer valor diferente do especificado `value`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer valor diferente dos dois valores especificados.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa o primeiro índice de qualquer valor diferente `value0`de , `value1`ou `value2`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa o primeiro índice de qualquer valor diferente `value0`de , `value1`ou `value2`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Pesquisa o primeiro índice de qualquer valor diferente dos dois valores especificados.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Pesquisa o primeiro índice de qualquer valor diferente do especificado `value`.
IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa o primeiro índice de qualquer valor fora do intervalo entre `lowInclusive` e `highInclusive`, inclusive.
IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa o primeiro índice de qualquer valor no intervalo entre `lowInclusive` e `highInclusive`, inclusive.
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa a sequência especificada e retorna o índice de sua última ocorrência. Se não for encontrado, retornará -1.
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa a sequência especificada e retorna o índice de sua última ocorrência.
LastIndexOf<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o valor especificado e retorna o índice de sua última ocorrência. Se não for encontrado, retornará -1.
LastIndexOf<T>(ReadOnlySpan<T>, T)	Pesquisa o valor especificado e retorna o índice de sua última ocorrência.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T)	Pesquisa o último índice de qualquer um dos valores especificados.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `values`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `values`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `values`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `value`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `value0` ou `value1`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>)	Pesquisa o último índice de qualquer valor diferente do especificado `value0`, `value1`ou `value2`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Pesquisa o último índice de qualquer valor diferente do especificado `value0`, `value1`ou `value2`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Pesquisa o último índice de qualquer valor diferente do especificado `value0` ou `value1`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Pesquisa o último índice de qualquer valor diferente do especificado `value`.
LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa o último índice de qualquer valor fora do intervalo entre `lowInclusive` e `highInclusive`, inclusive.
LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Pesquisa 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 somente leitura se sobrepõem na memória e geram o deslocamento do elemento.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se duas sequências somente leitura se sobrepõem na memória.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T, IEqualityComparer<T>)	`source` Copia para `destination`, substituindo todas as ocorrências de `newValueoldValue` .
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)	`source` Copia para `destination`, substituindo todas as ocorrências de `newValueoldValue` .
ReplaceAny<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)	`source` Copia para `destination`, substituindo todas as ocorrências de qualquer um dos elementos `values` por `newValue`.
ReplaceAnyExcept<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)	`source` Copia para `destination`, substituindo todas as ocorrências de qualquer um dos elementos que não sejam aqueles `values` com `newValue`.
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IComparer<T>)	Determina a ordem relativa das sequências que estão sendo comparadas comparando os elementos usando IComparable{T}. CompareTo(T).
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina a ordem relativa de duas sequências somente leitura comparando 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 leitura são iguais comparando os elementos usando IEquatable{T}. Equals(T).
Split<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Retorna um tipo que permite a enumeração de cada elemento em um intervalo de divisão usando o intervalo separador fornecido.
Split<T>(ReadOnlySpan<T>, T)	Retorna um tipo que permite a enumeração de cada elemento em um intervalo dividido usando o caractere separador fornecido.
SplitAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Retorna um tipo que permite a enumeração de cada elemento em um intervalo de divisão usando qualquer um dos elementos fornecidos.
SplitAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Retorna um tipo que permite a enumeração de cada elemento em um intervalo 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 somente leitura.
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Determina se uma sequência especificada aparece no início de um intervalo somente 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>)	Produza uma matriz imutável de conteúdo de elementos especificados.
Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Remove todas as ocorrências à esquerda e à direita de um conjunto de elementos especificado em um intervalo somente leitura de um intervalo somente leitura.
Trim<T>(ReadOnlySpan<T>, T)	Remove todas as ocorrências à esquerda e à direita de um elemento especificado de um intervalo somente leitura.
TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Remove todas as ocorrências à direita de um conjunto de elementos especificado em um intervalo somente leitura de um intervalo somente leitura.
TrimEnd<T>(ReadOnlySpan<T>, T)	Remove todas as ocorrências à direita de um elemento especificado de um intervalo somente leitura.
TrimStart<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Remove todas as ocorrências principais de um conjunto de elementos especificado em um intervalo somente leitura do intervalo.
TrimStart<T>(ReadOnlySpan<T>, T)	Remove todas as ocorrências principais de um elemento especificado do intervalo.

Aplica-se a

Confira também

Comentários

Esta página foi útil?