Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

SplFixedArray::offsetSet — Escrever um valor num índice

Escreve ou substitui um valor num array de tamanho fixo. Compara a chamada direta com a atribuição por parênteses retos e distingue os erros de índice no PHP 8.3.

Versão: PHP 8.3

Sintaxe

$array->offsetSet($index, $value);
$array[$index] = $value;

SplFixedArray::offsetSet escreve numa posição existente de um objeto \SplFixedArray, uma classe da SPL no espaço de nomes global. A SPL faz parte do núcleo do PHP e está sempre ativa nas compilações padrão do PHP 8.3. Com um índice inteiro válido, $array->offsetSet($index, $value) e $array[$index] = $value escrevem na mesma posição. O valor pode ser de qualquer tipo (mixed), incluindo null. O método altera o objeto e não devolve nenhum valor (void).

Um índice válido satisfaz 0 <= $index && $index < $array->getSize(). Com um tamanho de 2, podes escrever nos índices 0 e 1, mas não no 2. A escrita não altera o tamanho, e $array[] = $value não acrescenta um elemento no fim como acontece num array normal do PHP. Para acrescentares posições, chama primeiro setSize() e escreve depois num índice explícito.

No PHP 8.3, um índice inteiro fora dos limites lança RuntimeException, enquanto uma chave inválida como 'label' lança TypeError. A partir do PHP 8.4, a classe de exceção específica para um índice fora dos limites é OutOfBoundsException, uma subclasse de RuntimeException. Se o índice vier de dados externos, verifica is_int($index) e os limites em vez de dependeres da conversão implícita.

Exemplos

<?php
$array = new \SplFixedArray(2);

$array->offsetSet(1, 'draft');
echo $array[1], "\n";

$array[1] = 'ready';
echo $array[1], "\n";

try {
    $array->offsetSet(2, 'extra');
} catch (\RuntimeException $error) {
    echo get_class($error), "\n";
}

try {
    $array['label'] = 'extra';
} catch (\TypeError $error) {
    echo get_class($error), "\n";
}

Resultado

draft
ready
RuntimeException
TypeError

O script usa o método para guardar `draft` no índice 1 e substitui esse valor por `ready` através de uma atribuição com parênteses retos. Por fim, apresenta os nomes das classes de exceção para o índice 2 e para a chave `'label'`, respetivamente.

Lições relacionadas

  • PHP · Lição 66 · Avançado · Versão: 2

Fontes