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