<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: yannick Status: ready -->

<!-- Reviewed: no -->

<!-- CREDITS: DavidA. -->

<refentry xml:id="function.next" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>next</refname>

<refpurpose>Avance le pointeur interne d'un tableau</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>mixed</type><methodname>next</methodname>

<methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>

</methodsynopsis>

<para>

<function>next</function> se comporte comme

<function>current</function>, avec une différence. Il avance

le pointeur interne du tableau d'un élément, avant de retourner

la valeur de l'élément. Cela signifie qu'il retourne la prochaine

valeur du tableau et avance le pointeur interne d'un élément.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>array</parameter></term>

<listitem>

<para>

Le tableau à traiter.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Retourne la prochaine valeur du tableau suivant le pointeur interne,

ou &false; s'il n'y a plus d'élément.

</para>

&return.falseproblem;

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&standard.changelog.calling-on-objects;

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Exemple avec <function>next</function></title>

<programlisting role="php">

<![CDATA[

<?php

$transport = array('foot', 'bike', 'car', 'plane');

echo $mode = current($transport), PHP_EOL; // $mode = 'foot';

echo $mode = next($transport), PHP_EOL; // $mode = 'bike';

echo $mode = next($transport), PHP_EOL; // $mode = 'car';

echo $mode = prev($transport), PHP_EOL; // $mode = 'bike';

echo $mode = end($transport), PHP_EOL; // $mode = 'plane';

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<simpara>

Il n'est pas possible de distinguer la fin d'un tableau

de l'élément <type>bool</type> &false;.

Pour traverser correctement un tableau qui

peut contenir l'élément &false;, voyez la fonction

<link linkend="control-structures.foreach"><literal>foreach</literal></link>.

</simpara>

<simpara>

Pour continuer d'utiliser <function>next</function> et détecter proprement

si la fin du tableau a été atteinte, la <function>key</function> est &null;.

</simpara>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>current</function></member>

<member><function>end</function></member>

<member><function>prev</function></member>

<member><function>reset</function></member>

<member><function>each</function></member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->