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
>maxdb_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="MaxDB PHP Extension"
HREF="ref.maxdb.html"><LINK
REL="PREVIOUS"
TITLE="maxdb_execute"
HREF="function.maxdb-execute.html"><LINK
REL="NEXT"
TITLE="maxdb_fetch_assoc"
HREF="function.maxdb-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.maxdb-execute.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.maxdb-fetch-assoc.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.maxdb-fetch-array"
></A
>maxdb_fetch_array</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN110497"
></A
><P
>    (PECL)</P
>maxdb_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="AEN110501"
></A
><H2
>Description</H2
><P
>Procedural style:</P
>mixed <B
CLASS="methodname"
>maxdb_fetch_array</B
> ( resource result [, int resulttype] )<BR
></BR
><P
>Object oriented style (method):</P
>class <B
CLASS="classname"
>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"
>maxdb_fetch_array()</B
> is an extended version of the
   <A
HREF="function.maxdb-fetch-row.html"
><B
CLASS="function"
>maxdb_fetch_row()</B
></A
> function. In addition to storing the data in the
   numeric indices of the result array, the <B
CLASS="function"
>maxdb_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
><P
>&#13;   The optional second argument <CODE
CLASS="parameter"
>resulttype</CODE
> 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 MAXDB_ASSOC, MAXDB_ASSOC_UPPER, MAXDB_ASSOC_LOWER, MAXDB_NUM, or MAXDB_BOTH.
   By default the
   <B
CLASS="function"
>maxdb_fetch_array()</B
> function will assume MAXDB_BOTH, which is a combination of
   MAXDB_NUM and MAXDB_ASSOC  for this parameter.
  </P
><P
>&#13;   By using the MAXDB_ASSOC constant this function will behave identically to the
   <A
HREF="function.maxdb-fetch-assoc.html"
><B
CLASS="function"
>maxdb_fetch_assoc()</B
></A
>, while MAXDB_NUM will behave identically to the
   <A
HREF="function.maxdb-fetch-row.html"
><B
CLASS="function"
>maxdb_fetch_row()</B
></A
> function. The final option MAXDB_BOTH will create a single
   array with the attributes of both.
  </P
><P
>&#13;   By using the MAXDB_ASSOC_UPPER constant, the behaviour of this function is identical to the use
   of MAXDB_ASSOC except the array index of a column is the fieldname in upper case.
  </P
><P
>&#13;   By using the MAXDB_ASSOC_LOWER constant, the behaviour of this function is identical to the use
   of MAXDB_ASSOC except the array index of a column is the fieldname in lower case.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN110545"
></A
><H2
>Return values</H2
><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 in resultset.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN110549"
></A
><H2
>See also</H2
><P
>&#13;   <A
HREF="function.maxdb-fetch-assoc.html"
><B
CLASS="function"
>maxdb_fetch_assoc()</B
></A
>,
   <A
HREF="function.maxdb-fetch-row.html"
><B
CLASS="function"
>maxdb_fetch_row()</B
></A
>,
   <B
CLASS="function"
>maxdb_fetch_resource()</B
>.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN110555"
></A
><H2
>Example</H2
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN110557"
></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 />$maxdb </font><font color="#007700">= new </font><font color="#0000BB">maxdb</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"MONA"</font><font color="#007700">, </font><font color="#DD0000">"RED"</font><font color="#007700">, </font><font color="#DD0000">"DEMODB"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */<br /></font><font color="#007700">if (</font><font color="#0000BB">maxdb_connect_errno</font><font color="#007700">()) {<br />&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">maxdb_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">$query </font><font color="#007700">= </font><font color="#DD0000">"SELECT name, state FROM hotel.city ORDER by zip"</font><font color="#007700">;<br /></font><font color="#0000BB">$result </font><font color="#007700">= </font><font color="#0000BB">$maxdb</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">MAXDB_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">MAXDB_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">"STATE"</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">MAXDB_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">"STATE"</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">$maxdb</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="AEN110560"
></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">maxdb_connect</font><font color="#007700">(</font><font color="#DD0000">"localhost"</font><font color="#007700">, </font><font color="#DD0000">"MONA"</font><font color="#007700">, </font><font color="#DD0000">"RED"</font><font color="#007700">, </font><font color="#DD0000">"DEMODB"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* check connection */<br /></font><font color="#007700">if (</font><font color="#0000BB">maxdb_connect_errno</font><font color="#007700">()) {<br />&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">maxdb_connect_error</font><font color="#007700">());<br />&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></font><font color="#0000BB">$query </font><font color="#007700">= </font><font color="#DD0000">"SELECT name, state FROM hotel.city ORDER by zip"</font><font color="#007700">;<br /></font><font color="#0000BB">$result </font><font color="#007700">= </font><font color="#0000BB">maxdb_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">maxdb_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MAXDB_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">maxdb_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MAXDB_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">"STATE"</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">maxdb_fetch_array</font><font color="#007700">(</font><font color="#0000BB">$result</font><font color="#007700">, </font><font color="#0000BB">MAXDB_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">"STATE"</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">/* free result set */<br /></font><font color="#0000BB">maxdb_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">maxdb_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
>&#13;   The above examples would produce the following output:
  </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>New York (NY)
New York (NY)
Long Island (NY)</PRE
></TD
></TR
></TABLE
></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.maxdb-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.maxdb-fetch-assoc.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>maxdb_execute</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.maxdb.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>maxdb_fetch_assoc</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>