<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >foreach</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="PHP 手册" HREF="index.html"><LINK REL="UP" TITLE="控制结构" HREF="language.control-structures.html"><LINK REL="PREVIOUS" TITLE="for" HREF="control-structures.for.html"><LINK REL="NEXT" TITLE="break" HREF="control-structures.break.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="sect1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP 手册</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="control-structures.for.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >章 16. 控制结构</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="control-structures.break.html" ACCESSKEY="N" >下一页</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="sect1" ><H1 CLASS="sect1" ><A NAME="control-structures.foreach" ><TT CLASS="literal" >foreach</TT ></A ></H1 ><P > PHP 4 引入了 <TT CLASS="literal" >foreach</TT > 结构,和 Perl 以及其他语言很像。这只是一种遍历数组简便方法。<TT CLASS="literal" >foreach</TT > 仅能用于数组,当试图将其用于其它数据类型或者一个未初始化的变量时会产生错误。有两种语法,第二种比较次要但却是第一种的有用的扩展。 <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN4836" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="programlisting" >foreach (array_expression as $value) statement foreach (array_expression as $key => $value) statement</PRE ></TD ></TR ></TABLE ><P ></P ></DIV > </P ><P > 第一种格式遍历给定的 <TT CLASS="literal" >array_expression</TT > 数组。每次循环中,当前单元的值被赋给 <TT CLASS="literal" >$value</TT > 并且数组内部的指针向前移一步(因此下一次循环中将会得到下一个单元)。 </P ><P > 第二种格式做同样的事,只除了当前单元的键名也会在每次循环中被赋给变量 <TT CLASS="literal" >$key</TT >。 </P ><P > 自PHP 5 起,还可能<A HREF="language.oop5.iterations.html" >遍历对象</A >。 </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >注意: </B > 当 <TT CLASS="literal" >foreach</TT > 开始执行时,数组内部的指针会自动指向第一个单元。这意味着不需要在 <TT CLASS="literal" >foreach</TT > 循环之前调用 <A HREF="function.reset.html" ><B CLASS="function" >reset()</B ></A >。 </P ></BLOCKQUOTE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >注意: </B > 除非数组是被<A HREF="language.references.html" >引用</A >,<TT CLASS="literal" >foreach</TT > 所操作的是指定数组的一个拷贝,而不是该数组本身。因此数组指针不会被 <A HREF="function.each.html" ><B CLASS="function" >each()</B ></A > 结构改变,对返回的数组单元的修改也不会影响原数组。不过原数组的内部指针<SPAN CLASS="emphasis" ><I CLASS="emphasis" >的确</I ></SPAN >在处理数组的过程中向前移动了。假定 foreach 循环运行到结束,原数组的内部指针将指向数组的结尾。 </P ><P > 自 PHP 5 起,可以很容易地通过在 <TT CLASS="literal" >$value</TT > 之前加上 & 来修改数组的单元。此方法将以<A HREF="language.references.html" >引用</A >赋值而不是拷贝一个值。 <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN4859" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">4</font><font color="#007700">);<br />foreach (</font><font color="#0000BB">$arr </font><font color="#007700">as &</font><font color="#0000BB">$value</font><font color="#007700">) {<br /> </font><font color="#0000BB">$value </font><font color="#007700">= </font><font color="#0000BB">$value </font><font color="#007700">* </font><font color="#0000BB">2</font><font color="#007700">;<br />}<br /></font><font color="#FF8000">// $arr is now array(2, 4, 6, 8)<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > 此方法仅在被遍历的数组可以被引用时才可用(例如是个变量)。 </P ></BLOCKQUOTE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >注意: </B > <TT CLASS="literal" >foreach</TT > 不支持用“@”来抑制错误信息的能力。 </P ></BLOCKQUOTE ></DIV ><P > 用户可能注意到了以下的代码功能完全相同: <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN4865" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#DD0000">"one"</font><font color="#007700">, </font><font color="#DD0000">"two"</font><font color="#007700">, </font><font color="#DD0000">"three"</font><font color="#007700">);<br /></font><font color="#0000BB">reset</font><font color="#007700">(</font><font color="#0000BB">$arr</font><font color="#007700">);<br />while (list(, </font><font color="#0000BB">$value</font><font color="#007700">) = </font><font color="#0000BB">each</font><font color="#007700">(</font><font color="#0000BB">$arr</font><font color="#007700">)) {<br /> echo </font><font color="#DD0000">"Value: $value<br></font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br />foreach (</font><font color="#0000BB">$arr </font><font color="#007700">as </font><font color="#0000BB">$value</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Value: $value<br /></font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > 以下代码功能也完全相同: <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN4867" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$arr </font><font color="#007700">= array(</font><font color="#DD0000">"one"</font><font color="#007700">, </font><font color="#DD0000">"two"</font><font color="#007700">, </font><font color="#DD0000">"three"</font><font color="#007700">);<br /></font><font color="#0000BB">reset</font><font color="#007700">(</font><font color="#0000BB">$arr</font><font color="#007700">);<br />while (list(</font><font color="#0000BB">$key</font><font color="#007700">, </font><font color="#0000BB">$value</font><font color="#007700">) = </font><font color="#0000BB">each</font><font color="#007700">(</font><font color="#0000BB">$arr</font><font color="#007700">)) {<br /> echo </font><font color="#DD0000">"Key: $key; Value: $value<br /></font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br />foreach (</font><font color="#0000BB">$arr </font><font color="#007700">as </font><font color="#0000BB">$key </font><font color="#007700">=> </font><font color="#0000BB">$value</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Key: $key; Value: $value<br /></font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > </P ><P > 示范用法的更多例子: <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN4870" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">/* foreach example 1: value only */<br /><br /></font><font color="#0000BB">$a </font><font color="#007700">= array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">17</font><font color="#007700">);<br /><br />foreach (</font><font color="#0000BB">$a </font><font color="#007700">as </font><font color="#0000BB">$v</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"Current value of </font><font color="#007700">\$</font><font color="#DD0000">a: $v.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br /></font><font color="#FF8000">/* foreach example 2: value (with key printed for illustration) */<br /><br /></font><font color="#0000BB">$a </font><font color="#007700">= array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">17</font><font color="#007700">);<br /><br /></font><font color="#0000BB">$i </font><font color="#007700">= </font><font color="#0000BB">0</font><font color="#007700">; </font><font color="#FF8000">/* for illustrative purposes only */<br /><br /></font><font color="#007700">foreach (</font><font color="#0000BB">$a </font><font color="#007700">as </font><font color="#0000BB">$v</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"</font><font color="#007700">\$</font><font color="#DD0000">a</font><font color="#007700">[</font><font color="#DD0000">$i</font><font color="#007700">]</font><font color="#DD0000"> => $v.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /> </font><font color="#0000BB">$i</font><font color="#007700">++;<br />}<br /><br /></font><font color="#FF8000">/* foreach example 3: key and value */<br /><br /></font><font color="#0000BB">$a </font><font color="#007700">= array(<br /> </font><font color="#DD0000">"one" </font><font color="#007700">=> </font><font color="#0000BB">1</font><font color="#007700">,<br /> </font><font color="#DD0000">"two" </font><font color="#007700">=> </font><font color="#0000BB">2</font><font color="#007700">,<br /> </font><font color="#DD0000">"three" </font><font color="#007700">=> </font><font color="#0000BB">3</font><font color="#007700">,<br /> </font><font color="#DD0000">"seventeen" </font><font color="#007700">=> </font><font color="#0000BB">17<br /></font><font color="#007700">);<br /><br />foreach (</font><font color="#0000BB">$a </font><font color="#007700">as </font><font color="#0000BB">$k </font><font color="#007700">=> </font><font color="#0000BB">$v</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"</font><font color="#007700">\$</font><font color="#DD0000">a</font><font color="#007700">[</font><font color="#DD0000">$k</font><font color="#007700">]</font><font color="#DD0000"> => $v.</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /><br /></font><font color="#FF8000">/* foreach example 4: multi-dimensional arrays */<br /></font><font color="#0000BB">$a </font><font color="#007700">= array();<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">][</font><font color="#0000BB">0</font><font color="#007700">] = </font><font color="#DD0000">"a"</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">][</font><font color="#0000BB">1</font><font color="#007700">] = </font><font color="#DD0000">"b"</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">][</font><font color="#0000BB">0</font><font color="#007700">] = </font><font color="#DD0000">"y"</font><font color="#007700">;<br /></font><font color="#0000BB">$a</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">][</font><font color="#0000BB">1</font><font color="#007700">] = </font><font color="#DD0000">"z"</font><font color="#007700">;<br /><br />foreach (</font><font color="#0000BB">$a </font><font color="#007700">as </font><font color="#0000BB">$v1</font><font color="#007700">) {<br /> foreach (</font><font color="#0000BB">$v1 </font><font color="#007700">as </font><font color="#0000BB">$v2</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"$v2</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br /> }<br />}<br /><br /></font><font color="#FF8000">/* foreach example 5: dynamic arrays */<br /><br /></font><font color="#007700">foreach (array(</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2</font><font color="#007700">, </font><font color="#0000BB">3</font><font color="#007700">, </font><font color="#0000BB">4</font><font color="#007700">, </font><font color="#0000BB">5</font><font color="#007700">) as </font><font color="#0000BB">$v</font><font color="#007700">) {<br /> echo </font><font color="#DD0000">"$v</font><font color="#007700">\n</font><font color="#DD0000">"</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="control-structures.for.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >起始页</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="control-structures.break.html" ACCESSKEY="N" >下一页</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><TT CLASS="literal" >for</TT ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="language.control-structures.html" ACCESSKEY="U" >上一级</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><TT CLASS="literal" >break</TT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >