<HTML ><HEAD ><TITLE >current</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Array Functions" HREF="ref.array.html"><LINK REL="PREVIOUS" TITLE="count" HREF="function.count.html"><LINK REL="NEXT" TITLE="each" HREF="function.each.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" 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 Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.count.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.each.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.current" ></A >current</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN8554" ></A ><P > (PHP 3, PHP 4 )</P >current -- Return the current element in an array</DIV ><DIV CLASS="refsect1" ><A NAME="AEN8557" ></A ><H2 >Description</H2 >mixed <B CLASS="methodname" >current</B > ( array array)<BR ></BR ><P > Every array has an internal pointer to its "current" element, which is initialized to the first element inserted into the array. </P ><P > The <B CLASS="function" >current()</B > function simply returns the array element that's currently being pointed by the internal pointer. It does not move the pointer in any way. If the internal pointer points beyond the end of the elements list, <B CLASS="function" >current()</B > returns <TT CLASS="constant" ><B >FALSE</B ></TT >. <DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Warning</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > If the array contains empty elements (0 or "", the empty string) then this function will return <TT CLASS="constant" ><B >FALSE</B ></TT > for these elements as well. This makes it impossible to determine if you are really at the end of the list in such an array using <B CLASS="function" >current()</B >. To properly traverse an array that may contain empty elements, use the <A HREF="function.each.html" ><B CLASS="function" >each()</B ></A > function. </P ></TD ></TR ></TABLE ></DIV > </P ><P > See also <A HREF="function.end.html" ><B CLASS="function" >end()</B ></A >, <A HREF="function.next.html" ><B CLASS="function" >next()</B ></A >, <A HREF="function.prev.html" ><B CLASS="function" >prev()</B ></A >, and <A HREF="function.reset.html" ><B CLASS="function" >reset()</B ></A >. </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="function.count.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.each.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >count</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.array.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >each</TD ></TR ></TABLE ></DIV ></BODY ></HTML >