Sophie: php-manual-zh-5.2.4-1mdv2008.1 noarch

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>mysqli_fetch_array</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="MySQLi 扩展库"
HREF="ref.mysqli.html"><LINK
REL="PREVIOUS"
TITLE="mysqli_execute"
HREF="function.mysqli-execute.html"><LINK
REL="NEXT"
TITLE="mysqli_fetch_assoc"
HREF="function.mysqli-fetch-assoc.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></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 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.mysqli-execute.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.mysqli-fetch-assoc.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.mysqli-fetch-array"
></A
>mysqli_fetch_array</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN138463"
></A
><P
>    (PHP 5)</P
>mysqli_fetch_array<P
>    (no version information, might be only in CVS)</P
>result-&#62;fetch_array()&nbsp;--&nbsp;Fetch a result row as an associative, a numeric array, or both</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN138467"
></A
><H2
>说明</H2
><P
>Procedural style:</P
>mixed <B
CLASS="methodname"
>mysqli_fetch_array</B
> ( mysqli_result result [, int resulttype] )<BR
></BR
><P
>Object oriented style (method):</P
>class <B
CLASS="classname"
>mysqli_result</B
> { <BR
></BR
>mixed <B
CLASS="methodname"
>fetch_array</B
> ( [int resulttype] )<BR
></BR
>}<P
>&#13;   Returns an array that corresponds to the fetched row or <TT
CLASS="constant"
><B
>NULL</B
></TT
> if there
   are no more rows for the resultset represented by the
   <CODE
CLASS="parameter"
>result</CODE
> parameter.
  </P
><P
>&#13;   <B
CLASS="function"
>mysqli_fetch_array()</B
> is an extended version of the
   <A
HREF="function.mysqli-fetch-row.html"
><B
CLASS="function"
>mysqli_fetch_row()</B
></A
> function. In addition to storing the
   data in the numeric indices of the result array, the 
   <B
CLASS="function"
>mysqli_fetch_array()</B
> function can also store the data
   in associative indices, using the field names of the result set as keys.
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>本函数返回的字段名是<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>区分大小写</I
></SPAN
>的。</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>本函数对
PHP <TT
CLASS="constant"
><B
>NULL</B
></TT
> 值设定 NULL 字段。</P
></BLOCKQUOTE
></DIV
><P
>&#13;   If two or more columns of the result have the same field names, the last
   column will take precedence and overwrite the earlier data. In order to
   access multiple columns with the same name, the numerically indexed
   version of the row must be used.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN138503"
></A
><H2
>参数</H2
><P
>&#13;   <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>&#13;result</CODE
></DT
><DD
><P
>Procedural style only: A result set
identifier returned by <A
HREF="function.mysqli-query.html"
><B
CLASS="function"
>mysqli_query()</B
></A
>, <A
HREF="function.mysqli-store-result.html"
><B
CLASS="function"
>mysqli_store_result()</B
></A
>
or <A
HREF="function.mysqli-use-result.html"
><B
CLASS="function"
>mysqli_use_result()</B
></A
>.</P
></DD
><DT
><CODE
CLASS="parameter"
>resulttype</CODE
></DT
><DD
><P
>&#13;       This optional parameter is a constant indicating what type of array
       should be produced from the current row data. The possible values for
       this parameter are the constants <TT
CLASS="constant"
><B
>MYSQLI_ASSOC</B
></TT
>,
       <TT
CLASS="constant"
><B
>MYSQLI_NUM</B
></TT
>, or <TT
CLASS="constant"
><B
>MYSQLI_BOTH</B
></TT
>.
       Defaults to <TT
CLASS="constant"
><B
>MYSQLI_BOTH</B
></TT
>.
      </P
><P
>&#13;       By using the <TT
CLASS="constant"
><B
>MYSQLI_ASSOC</B
></TT
> constant this function
       will behave identically to the <A
HREF="function.mysqli-fetch-assoc.html"
><B
CLASS="function"
>mysqli_fetch_assoc()</B
></A
>,
       while <TT
CLASS="constant"
><B
>MYSQLI_NUM</B
></TT
> will behave identically to the
       <A
HREF="function.mysqli-fetch-row.html"
><B
CLASS="function"
>mysqli_fetch_row()</B
></A
> function. The final option 
       <TT
CLASS="constant"
><B
>MYSQLI_BOTH</B
></TT
> will create a single array with the
       attributes of both.
      </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN138530"
></A
><H2
>返回值</H2
><P
>&#13;   Returns an array of strings that corresponds to the fetched row or <TT
CLASS="constant"
><B
>NULL</B
></TT
> if there
   are no more rows in resultset.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN138534"
></A
><H2
>范例</H2
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN138536"
></A
><P
><B
>例 1. Object oriented style</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$mysqli </font><font color="#007700">= new </font><font color="#0000BB">mysqli</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"my_user"</font><font color="#007700">, </font><font color="#DD0000">"my_password"</font><font color="#007700">, </font><font color="#DD0000">"world"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */<br /></font><font color="#007700">if (</font><font color="#0000BB">mysqli_connect_errno</font><font color="#007700">()) {<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Connect failed: %s\n"</font><font color="#007700">, </font><font color="#0000BB">mysqli_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">$query </font><font color="#007700">= </font><font color="#DD0000">"SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"</font><font color="#007700">;<br /></font><font color="#0000BB">$result </font><font color="#007700">= </font><font color="#0000BB">$mysqli</font><font color="#007700">-&gt;</font><font color="#0000BB">query</font><font color="#007700">(</font><font color="#0000BB">$query</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* numeric array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">$result</font><font color="#007700">-&gt;</font><font color="#0000BB">fetch_array</font><font color="#007700">(</font><font color="#0000BB">MYSQLI_NUM</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* associative array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">$result</font><font color="#007700">-&gt;</font><font color="#0000BB">fetch_array</font><font color="#007700">(</font><font color="#0000BB">MYSQLI_ASSOC</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"Name"</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"CountryCode"</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* associative and numeric array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">$result</font><font color="#007700">-&gt;</font><font color="#0000BB">fetch_array</font><font color="#007700">(</font><font color="#0000BB">MYSQLI_BOTH</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"CountryCode"</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* free result set */<br /></font><font color="#0000BB">$result</font><font color="#007700">-&gt;</font><font color="#0000BB">close</font><font color="#007700">();<br /><br /></font><font color="#FF8000">/* close connection */<br /></font><font color="#0000BB">$mysqli</font><font color="#007700">-&gt;</font><font color="#0000BB">close</font><font color="#007700">();<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN138539"
></A
><P
><B
>例 2. Procedural style</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$link </font><font color="#007700">= </font><font color="#0000BB">mysqli_connect</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"my_user"</font><font color="#007700">, </font><font color="#DD0000">"my_password"</font><font color="#007700">, </font><font color="#DD0000">"world"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */<br /></font><font color="#007700">if (</font><font color="#0000BB">mysqli_connect_errno</font><font color="#007700">()) {<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">printf</font><font color="#007700">(</font><font color="#DD0000">"Connect failed: %s\n"</font><font color="#007700">, </font><font color="#0000BB">mysqli_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">$query </font><font color="#007700">= </font><font color="#DD0000">"SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"</font><font color="#007700">;<br /></font><font color="#0000BB">$result </font><font color="#007700">= </font><font color="#0000BB">mysqli_query</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">, </font><font color="#0000BB">$query</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* numeric array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">mysqli_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MYSQLI_NUM</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">1</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* associative array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">mysqli_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MYSQLI_ASSOC</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"Name"</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"CountryCode"</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* associative and numeric array */<br /></font><font color="#0000BB">$row </font><font color="#007700">= </font><font color="#0000BB">mysqli_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MYSQLI_BOTH</font><font color="#007700">);<br /></font><font color="#0000BB">printf </font><font color="#007700">(</font><font color="#DD0000">"%s (%s)\n"</font><font color="#007700">, </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#0000BB">0</font><font color="#007700">], </font><font color="#0000BB">$row</font><font color="#007700">[</font><font color="#DD0000">"CountryCode"</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* free result set */<br /></font><font color="#0000BB">mysqli_free_result</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* close connection */<br /></font><font color="#0000BB">mysqli_close</font><font color="#007700">(</font><font color="#0000BB">$link</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>上例将输出：</P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>Kabul (AFG)
Qandahar (AFG)
Herat (AFG)</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN138544"
></A
><H2
>参见</H2
><P
>&#13;   <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><A
HREF="function.mysqli-fetch-assoc.html"
><B
CLASS="function"
>mysqli_fetch_assoc()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.mysqli-fetch-row.html"
><B
CLASS="function"
>mysqli_fetch_row()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.mysqli-fetch-object.html"
><B
CLASS="function"
>mysqli_fetch_object()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.mysqli-query.html"
><B
CLASS="function"
>mysqli_query()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.mysqli-data-seek.html"
><B
CLASS="function"
>mysqli_data_seek()</B
></A
></TD
></TR
></TBODY
></TABLE
><P
></P
>
  </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.mysqli-execute.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="function.mysqli-fetch-assoc.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mysqli_execute</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.mysqli.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mysqli_fetch_assoc</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>