CKTIS / C#
Acesso a elementos: array[index]
A expressão array[index] lê ou altera um elemento de um array. Os parênteses retos [] também permitem aceder a indexadores; nesse caso, o significado dos argumentos depende do tipo específico.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
array[index]
array[index] = value;
matrix[row, column]
objectWithIndexer[key]array[index] identifica um elemento de um array: array é uma expressão que devolve um array e index especifica a posição. Num array C# unidimensional comum, os índices começam em 0 e terminam em array.Length - 1. A leitura obtém o valor do elemento, enquanto array[index] = value guarda um novo valor sem alterar o comprimento do array.
Um índice fora dos limites do array provoca IndexOutOfRangeException; o acesso através de uma referência igual a null provoca NullReferenceException. Um array vazio não tem índices de elemento válidos. array?[index] ignora o acesso quando o array é null, mas não protege contra um índice inválido se o array existir.
Um array retangular usa um índice por dimensão, como matrix[row, column]. Um array irregular usa operações de acesso sucessivas, como rows[row][column]. A mesma notação [] permite aceder a indexadores de objetos, cujo argumento pode ser, por exemplo, uma chave de texto. As regras de leitura, escrita e exceções dependem do tipo; não se deve presumir que se comportam como arrays. Não é possível sobrecarregar [] diretamente — os tipos personalizados fornecem indexadores em alternativa.
Os parênteses em int[] declaram um tipo de array; não leem um elemento. O exemplo demonstra a leitura e a escrita básicas de elementos, sem funcionalidades que exijam uma versão preview da linguagem.
Exemplos
using System;
class Program
{
static void Main()
{
int[] array = { 10, 20, 30 };
int index = 1;
Console.WriteLine(array[index]);
array[index] = 25;
Console.WriteLine(array[index]);
Console.WriteLine(array[0]);
}
}Resultado
20 25 10
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.