ReadOnlySpan<T> Estrutura
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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 |
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 |
| 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 |
| BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer) |
Pesquisa numa ordenação ReadOnlySpan<T> inteira por um valor especificado usando o tipo genérico especificado |
| 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 |
| CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Encontra o comprimento de qualquer prefixo comum partilhado entre |
| Contains<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>) |
Procura o valor especificado e devolve |
| 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 |
| ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Procura uma ocorrência de qualquer um dos especificados |
| ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>) |
Procura uma ocorrência de qualquer um dos especificados |
| 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 |
| ContainsAny<T>(ReadOnlySpan<T>, T, T) |
Procura uma ocorrência de |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>) |
Pesquisa no intervalo especificado qualquer valor que não seja o especificado |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Pesquisa no intervalo especificado qualquer valor que não seja o especificado |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>) |
Pesquisa no intervalo especificado qualquer valor que não seja o especificado |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>) |
Pesquisa no espaço especificado qualquer valor que não |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>) |
Procura por qualquer valor que não |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>) |
Procura qualquer valor que não |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T) |
Procura qualquer valor que não |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T) |
Pesquisa no intervalo especificado qualquer valor que não |
| ContainsAnyExcept<T>(ReadOnlySpan<T>, T) |
Pesquisa no intervalo especificado qualquer valor que não seja o especificado |
| ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T) |
Procura qualquer valor fora do intervalo entre |
| ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T) |
Procura qualquer valor no intervalo entre |
| Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>) |
Conta o número de vezes que o especificado |
| Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Conta o número de vezes |
| Count<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>) |
Conta o número de vezes que o especificado |
| Count<T>(ReadOnlySpan<T>, T) |
Conta o número de vezes que o especificado |
| CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>) |
Conta o número de vezes que qualquer um dos especificados |
| CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Conta o número de vezes que qualquer um dos especificados |
| CountAny<T>(ReadOnlySpan<T>, SearchValues<T>) |
Conta o número de vezes que qualquer um dos especificados |
| 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 |
| IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Procura o primeiro índice de qualquer valor diferente do especificado |
| IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>) |
Procura o primeiro índice de qualquer valor diferente do especificado |
| IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>) |
Procura o primeiro índice de qualquer valor diferente do especificado |
| 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 |
| IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T) |
Procura o primeiro índice de qualquer valor que não |
| 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 |
| IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T) |
Pesquisas pelo primeiro índice de qualquer valor fora do intervalo entre |
| IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T) |
Procura o primeiro índice de qualquer valor no intervalo entre |
| 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 |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, IEqualityComparer<T>) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, IEqualityComparer<T>) |
Procura o último índice de qualquer valor que não seja especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T, IEqualityComparer<T>) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T) |
Procura o último índice de qualquer valor que não seja especificado |
| LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T) |
Procura o último índice de qualquer valor diferente do especificado |
| LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T) |
Pesquisa pelo último índice de qualquer valor fora do intervalo entre |
| LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T) |
Procura o último índice de qualquer valor no intervalo entre |
| 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 |
| Replace<T>(ReadOnlySpan<T>, Span<T>, T, T) |
Cópias |
| ReplaceAny<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T) |
Cópias |
| ReplaceAnyExcept<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T) |
Cópias |
| 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. |