<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/spl.iterators.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'class.arrayiterator.php',
    1 => 'ArrayIterator',
    2 => 'A classe ArrayIterator',
  ),
  'up' => 
  array (
    0 => 'spl.iterators.php',
    1 => 'Iteradores',
  ),
  'prev' => 
  array (
    0 => 'appenditerator.valid.php',
    1 => 'AppendIterator::valid',
  ),
  'next' => 
  array (
    0 => 'arrayiterator.append.php',
    1 => 'ArrayIterator::append',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/spl/arrayiterator.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.arrayiterator.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.arrayiterator" class="reference">
 <h1 class="title">A classe ArrayIterator</h1>
 

 <div class="partintro"><p class="verinfo">(PHP 5, PHP 7, PHP 8)</p>


  <div class="section" id="arrayiterator.intro">
   <h2 class="title">Introdução</h2>
   <p class="para">
    Permite a remoção de elementos e a modificação de
    chaves e valores ao iterar sobre <span class="type"><a href="language.types.array.php" class="type array">array</a></span>s ou <span class="type"><a href="language.types.object.php" class="type object">object</a></span>s.
   </p>
   <p class="para">
    Para iterar o mesmo array mais de uma vez, é recomendado
    instanciar <span class="classname"><a href="class.arrayobject.php" class="classname">ArrayObject</a></span> e usar a
    instância de <span class="classname"><strong class="classname">ArrayIterator</strong></span> criada implicitamente ao
    usar <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a> para iterar sobre o array armazenado, ou criar uma
    chamando o método <span class="methodname"><a href="arrayobject.getiterator.php" class="methodname">ArrayObject::getIterator()</a></span> manualmente.
   </p>
  </div>


  <div class="section" id="arrayiterator.synopsis">
   <h2 class="title">Resumo da classe</h2>


   <div class="classsynopsis"><div class="classsynopsisinfo">
    
     <span class="modifier">class</span> <strong class="classname"><strong class="classname">ArrayIterator</strong></strong>
    

    
     <span class="modifier">implements</span>
      <a href="class.seekableiterator.php" class="interfacename">SeekableIterator</a>,

     <a href="class.arrayaccess.php" class="interfacename">ArrayAccess</a>,

     <a href="class.serializable.php" class="interfacename">Serializable</a>,

     <a href="class.countable.php" class="interfacename">Countable</a> {</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Constantes */</div>
    <div class="fieldsynopsis">
     <span class="modifier">public</span>
     <span class="modifier">const</span>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
      <var class="fieldsynopsis_varname"><a href="class.arrayiterator.php#arrayiterator.constants.std-prop-list"><var class="varname">STD_PROP_LIST</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">public</span>
     <span class="modifier">const</span>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
      <var class="fieldsynopsis_varname"><a href="class.arrayiterator.php#arrayiterator.constants.array-as-props"><var class="varname">ARRAY_AS_PROPS</var></a></var>;</div>


    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Métodos */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.construct.php" class="methodname">__construct</a></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.object.php" class="type object">object</a></span></span> <code class="parameter">$array</code><span class="initializer"> = []</span></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code><span class="initializer"> = 0</span></span>)</div>

    <div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.append.php" class="methodname">append</a></span>(<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.asort.php" class="methodname">asort</a></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code><span class="initializer"> = <strong><code><a href="array.constants.php#constant.sort-regular">SORT_REGULAR</a></code></strong></span></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.count.php" class="methodname">count</a></span>(): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.current.php" class="methodname">current</a></span>(): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.getarraycopy.php" class="methodname">getArrayCopy</a></span>(): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.getflags.php" class="methodname">getFlags</a></span>(): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.key.php" class="methodname">key</a></span>(): <span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>|<span class="type"><a href="language.types.null.php" class="type null">null</a></span></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.ksort.php" class="methodname">ksort</a></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code><span class="initializer"> = <strong><code><a href="array.constants.php#constant.sort-regular">SORT_REGULAR</a></code></strong></span></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.natcasesort.php" class="methodname">natcasesort</a></span>(): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.natsort.php" class="methodname">natsort</a></span>(): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.next.php" class="methodname">next</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.offsetexists.php" class="methodname">offsetExists</a></span>(<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$key</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.offsetget.php" class="methodname">offsetGet</a></span>(<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$key</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.offsetset.php" class="methodname">offsetSet</a></span>(<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$key</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.offsetunset.php" class="methodname">offsetUnset</a></span>(<span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$key</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.rewind.php" class="methodname">rewind</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.seek.php" class="methodname">seek</a></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$offset</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.serialize.php" class="methodname">serialize</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.setflags.php" class="methodname">setFlags</a></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$flags</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.uasort.php" class="methodname">uasort</a></span>(<span class="methodparam"><span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.uksort.php" class="methodname">uksort</a></span>(<span class="methodparam"><span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code></span>): <span class="type"><a href="language.types.singleton.php" class="type true">true</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.unserialize.php" class="methodname">unserialize</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$data</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="arrayiterator.valid.php" class="methodname">valid</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

   }</div>

  </div>

  <div class="section" id="arrayiterator.constants">
   <h2 class="title">Constantes predefinidas</h2>
   <div class="section" id="arrayiterator.constants.flags">
    <h2 class="title">ArrayIterator Flags</h2>
    <dl>

     
      <dt id="arrayiterator.constants.std-prop-list"><strong><code><a href="class.arrayiterator.php#arrayiterator.constants.std-prop-list">ArrayIterator::STD_PROP_LIST</a></code></strong></dt>
      <dd>
       <p class="para">
        As propriedades de objeto têm sua funcionalidade normal
        quando acessados como listas (<span class="function"><a href="function.var-dump.php" class="function">var_dump()</a></span>, <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a> etc.).
       </p>
      </dd>
     

     
      <dt id="arrayiterator.constants.array-as-props"><strong><code><a href="class.arrayiterator.php#arrayiterator.constants.array-as-props">ArrayIterator::ARRAY_AS_PROPS</a></code></strong></dt>
      <dd>
       <p class="para">Itens podem ser acessados como propriedades (leitura e escrita).</p>
      </dd>
     
    </dl>
   </div>
  </div>



 </div>

 
























































































































<h2>Índice</h2><ul class="chunklist chunklist_reference"><li><a href="arrayiterator.append.php">ArrayIterator::append</a> — Anexa um elemento</li><li><a href="arrayiterator.asort.php">ArrayIterator::asort</a> — Ordena entradas pelos valores</li><li><a href="arrayiterator.construct.php">ArrayIterator::__construct</a> — Constr&oacute;i um ArrayIterator</li><li><a href="arrayiterator.count.php">ArrayIterator::count</a> — Conta os elementos</li><li><a href="arrayiterator.current.php">ArrayIterator::current</a> — Retorna o valor do elemento atual do array</li><li><a href="arrayiterator.getarraycopy.php">ArrayIterator::getArrayCopy</a> — Obt&eacute;m c&oacute;pia do array</li><li><a href="arrayiterator.getflags.php">ArrayIterator::getFlags</a> — Retorna as flags de comportamento</li><li><a href="arrayiterator.key.php">ArrayIterator::key</a> — Retorna a chave do elemento atual do array</li><li><a href="arrayiterator.ksort.php">ArrayIterator::ksort</a> — Ordena entradas por chaves</li><li><a href="arrayiterator.natcasesort.php">ArrayIterator::natcasesort</a> — Ordena entradas naturalmente, sem diferenciar mai&uacute;sculas de min&uacute;sculas</li><li><a href="arrayiterator.natsort.php">ArrayIterator::natsort</a> — Ordena entradas naturalmente</li><li><a href="arrayiterator.next.php">ArrayIterator::next</a> — Avan&ccedil;a para o pr&oacute;ximo elemento</li><li><a href="arrayiterator.offsetexists.php">ArrayIterator::offsetExists</a> — Verificar se o deslocamento existe</li><li><a href="arrayiterator.offsetget.php">ArrayIterator::offsetGet</a> — Obt&eacute;m valor para um deslocamento</li><li><a href="arrayiterator.offsetset.php">ArrayIterator::offsetSet</a> — Define valor para um deslocamento</li><li><a href="arrayiterator.offsetunset.php">ArrayIterator::offsetUnset</a> — Remove valor para um deslocamento</li><li><a href="arrayiterator.rewind.php">ArrayIterator::rewind</a> — Retrocede o array</li><li><a href="arrayiterator.seek.php">ArrayIterator::seek</a> — Aponta para uma posi&ccedil;&atilde;o</li><li><a href="arrayiterator.serialize.php">ArrayIterator::serialize</a> — Serializa</li><li><a href="arrayiterator.setflags.php">ArrayIterator::setFlags</a> — Define as flags que ir&atilde;o alterar o comportamento</li><li><a href="arrayiterator.uasort.php">ArrayIterator::uasort</a> — Ordena com uma fun&ccedil;&atilde;o de compara&ccedil;&atilde;o definida pelo usu&aacute;rio e manter a associa&ccedil;&atilde;o de &iacute;ndices</li><li><a href="arrayiterator.uksort.php">ArrayIterator::uksort</a> — Ordena por chaves usando uma fun&ccedil;&atilde;o de compara&ccedil;&atilde;o definida pelo usu&aacute;rio</li><li><a href="arrayiterator.unserialize.php">ArrayIterator::unserialize</a> — Desserializa</li><li><a href="arrayiterator.valid.php">ArrayIterator::valid</a> — Verifica se o array possui mais elementos</li></ul>
</div>
<?php manual_footer($setup); ?>