PHP Conference Nagoya 2025

    ArrayIterator::offsetUnset

    (PHP 5, PHP 7, PHP 8)

    ArrayIterator::offsetUnset — Remove valor para um deslocamento

    Descrição

    public ArrayIterator::offsetUnset(mixed $key): void

    Remove um valor para um deslocamento.

    Se a iteração estiver em andamento e ArrayIterator::offsetUnset() for usado para remover o índice atual da iteração, a posição da iteração será avançada para o próximo índice. Como a posição da iteração também é avançada no final de um loop foreach, o uso de ArrayIterator::offsetUnset() dentro de um loop foreach pode resultar em índices sendo pulados.

    Parâmetros

    key

    O deslocamento a ser removido.

    Valor Retornado

    Nenhum valor é retornado.

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 3 notes

    up
    3
    olav at fwt dot no
    13 years ago
    When unsetting elements as you go it will not remove the second index of the Array being worked on. Im not sure exactly why but there is some speculations that when calling unsetOffset(); it resets the pointer aswell.

    <?php

    $a     = new ArrayObject( range( 0,9 ) );
    $b = new ArrayIterator( $a );

    for (     $b->rewind(); $b->valid(); $b->next() )
    {
    echo     "#{$b->key()} - {$b->current()} - \r\n";
    $b->offsetUnset( $b->key() );
    }

    ?>

    To avoid this bug you can call offsetUnset in the for loop

    <?php
    /*** ... ***/
    for ( $b->rewind(); $b->valid(); $b->offsetUnset( $b->key() ) )
    {
    /*** ... ***/
    ?>

    Or unset it directly in the ArrayObject
    <?php
    /*** ... ***/
    $a->offsetUnset( $b->key() );
    /*** ... ***/
    ?>

    which will produce correct results
    up
    2
    rkos...
    10 years ago
    This is my solution for problem with offsetUnset
    <?php

    $a     = new ArrayObject( range( 0,9 ) );
    $b = new ArrayIterator( $a );

    for (     $b->rewind(); $b->valid(); )
    {
    echo     "#{$b->key()} - {$b->current()} - <br>\r\n";
    if(    $b->key()==0 || $b->key()==1){
    $b->offsetUnset( $b->key() );
    }else {
    $b->next();
    }
    }

    var_dump($b);
    ?>
    up
    0
    Adil Baig @ AIdezigns
    13 years ago
    Make sure you use this function to unset a value. You can't access this iterator's values as an array. Ex:

    <?php
    $iterator     = new \RecursiveIteratorIterator(new \RecursiveArrayIterator($arr));

    foreach(    $iterator as $key => $value)
    {
    unset(    $iterator[$key]);
    }
    ?>

    Will return :

    PHP Fatal error: Cannot use object of type RecursiveIteratorIterator as array

    offsetUnset works properly even when removing items from nested arrays.
    ＋adicione uma nota
    To Top