Span<T> Estrutura

Definição

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

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

Parâmetros de Tipo Genérico

T

O tipo de itens no Span<T>.

Herança
Span<T>
Atributos

Observações

Para mais informações sobre esta API, consulte Observações Suplementares da API para o Span<T>.

Construtores

Name Description
Span<T>(T)

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

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

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

Span<T>(T[])

Cria um novo Span<T> objeto sobre a totalidade de um array especificado.

Span<T>(Void*, Int32)

Cria um novo Span<T> objeto a partir de um número especificado de T elementos, começando num endereço de memória especificado.

Propriedades

Name Description
Empty

Devolve um objeto vazio Span<T> .

IsEmpty

Devolve um valor que indica se a corrente Span<T> está vazia.

Item[Int32]

Obtém o elemento no índice zero especificado.

Length

Devolve o comprimento do vão atual.

Métodos

Name Description
Clear()

Limpa o conteúdo deste Span<T> objeto.

CopyTo(Span<T>)

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

Equals(Object)
Obsoleto.
Obsoleto.

Chamadas a este método não são suportadas.

Fill(T)

Preenche os elementos deste intervalo com um valor especificado.

GetEnumerator()

Devolve um enumerador para este Span<T>.

GetHashCode()
Obsoleto.

Lança um NotSupportedException.

GetPinnableReference()

Devolve uma referência 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 começando num índice especificado para um comprimento especificado.

Slice(Int32)

Forma uma fatia do vão atual que começa num índice especificado.

ToArray()

Copia o conteúdo deste intervalo numa nova matriz.

ToString()

Devolve a representação da cadeia deste Span<T> objeto.

TryCopyTo(Span<T>)

Tenta copiar a corrente Span<T> para um destino Span<T> e devolve um valor que indica se a operação de cópia foi bem-sucedida.

Operadores

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

Devolve um valor que indica se dois Span<T> objetos são iguais.

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

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

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

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

Implicit(T[] to Span<T>)

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

Inequality(Span<T>, Span<T>)

Devolve um valor que indica se dois Span<T> objetos não são iguais.

Métodos da Extensão

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

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

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

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

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

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

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

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

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

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

Contains<T>(Span<T>, T)

Indica se um valor especificado é encontrado num intervalo.

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

Procura uma ocorrência de qualquer um dos especificados values e retorna true se encontrar. Se não for encontrado, devolve false.

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

Procura uma ocorrência de qualquer um dos especificados values e retorna true se encontrar. Se não for encontrado, devolve false.

ContainsAny<T>(Span<T>, T, T, T)

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

ContainsAny<T>(Span<T>, T, T)

Procura uma ocorrência de value0 ou value1, e devolve true se for encontrado. Se não for encontrado, devolve false.

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

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

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

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

ContainsAnyExcept<T>(Span<T>, T, T, T)

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

ContainsAnyExcept<T>(Span<T>, T, T)

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

ContainsAnyExcept<T>(Span<T>, T)

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

ContainsAnyExceptInRange<T>(Span<T>, T, T)

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

ContainsAnyInRange<T>(Span<T>, T, T)

Procura qualquer valor no intervalo entre lowInclusive e highInclusive, inclusive, e retorna true se encontrado. Se não for encontrado, devolve false.

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

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

Count<T>(Span<T>, T)

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

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

Determina se a sequência especificada aparece no final de um vão.

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

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

IndexOf<T>(Span<T>, T)

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

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

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

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

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

IndexOfAny<T>(Span<T>, T, T, T)

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

IndexOfAny<T>(Span<T>, T, T)

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

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

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

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

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

IndexOfAnyExcept<T>(Span<T>, T, T, T)

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

IndexOfAnyExcept<T>(Span<T>, T, T)

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

IndexOfAnyExcept<T>(Span<T>, T)

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

IndexOfAnyExceptInRange<T>(Span<T>, T, T)

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

IndexOfAnyInRange<T>(Span<T>, T, T)

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

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

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

LastIndexOf<T>(Span<T>, T)

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

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

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

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

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

LastIndexOfAny<T>(Span<T>, T, T, T)

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

LastIndexOfAny<T>(Span<T>, T, T)

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

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

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

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

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

LastIndexOfAnyExcept<T>(Span<T>, T, T, T)

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

LastIndexOfAnyExcept<T>(Span<T>, T, T)

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

LastIndexOfAnyExcept<T>(Span<T>, T)

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

LastIndexOfAnyExceptInRange<T>(Span<T>, T, T)

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

LastIndexOfAnyInRange<T>(Span<T>, T, T)

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

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

Determina se um span e um span só de leitura se sobrepõem na memória e gera o deslocamento do elemento.

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

Determina se um span e um span só de leitura se sobrepõem na memória.

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

Substitui todas as ocorrências de oldValue por newValue.

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

Substitui todas as ocorrências de oldValue por newValue.

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

Substitui em span todas as ocorrências de qualquer elemento em values por newValue.

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

Substitui em span todos os elementos, exceto aqueles em values, por newValue.

Reverse<T>(Span<T>)

Inverte a sequência dos elementos em todo o intervalo.

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

Determina a ordem relativa de um intervalo e de um intervalo de apenas leitura comparando os elementos usando IComparable{T}. CompareTo(T).

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

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

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

Determina se um span e um span só de leitura são iguais comparando os elementos usando IEquatable{T}. É igual a T.

Sort<T,TComparer>(Span<T>, TComparer)

Ordena os elementos no todo Span<T> usando o TComparer.

Sort<T>(Span<T>, Comparison<T>)

Ordena os elementos no todo Span<T> usando o especificado Comparison<T>.

Sort<T>(Span<T>)

Ordena os elementos do todo Span<T> usando a IComparable<T> implementação de cada elemento do Span<T>.

Sort<TKey,TValue,TComparer>(Span<TKey>, Span<TValue>, TComparer)

Ordena um par de intervalos (um contendo as chaves e o outro com os itens correspondentes) com base nas chaves do primeiro Span<T> usando o comparador especificado.

Sort<TKey,TValue>(Span<TKey>, Span<TValue>, Comparison<TKey>)

Ordena um par de intervalos (um contendo as chaves e o outro contendo os itens correspondentes) com base nas chaves do primeiro Span<T> usando a comparação especificada.

Sort<TKey,TValue>(Span<TKey>, Span<TValue>)

Ordena um par de esferas (uma contendo as chaves e a outra contendo os itens correspondentes) com base nas chaves da primeira Span<T> usando a IComparable<T> implementação de cada chave.

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

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

ToImmutableArray<T>(Span<T>)

Converte o vão numa matriz imutável.

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

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

Trim<T>(Span<T>, T)

Remove todas as ocorrências dianteiras e posteriores de um elemento especificado de um vão.

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

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

TrimEnd<T>(Span<T>, T)

Remove todas as ocorrências finais de um elemento especificado de um vão.

TrimStart<T>(Span<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>(Span<T>, T)

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

Aplica-se a

Ver também