PhpDig.net

What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.




mysql_fetch_assoc

Name

mysql_fetch_assoc — Fetches a row of data from a result handle and returns it as an associative array.

Synopsis

array mysql_fetch_assoc(result handle);
mysql result result handle: Result handle returned by mysql_db_query() or mysql_query()

Returns

Associative array containing one row of query data; FALSE when out of data or on error

Description

mysql_fetch_assoc() retrieves a row of data from a result handle returned by mysql_db_query() or mysql_query() . After the data is retrieved, the result handle's internal pointer is advanced one position. The data is returned as an associative array that uses the column names as the array keys. If column names are duplicated, the data in the last column in the query sharing the name overwrites the other values. To access data from these types of queries, either use mysql_fetch_row() or alias the column names in your query.

Note

Despite the added functionality, mysql_fetch_assoc() is not significantly slower than mysql_fetch_row() ; in fact, mysql_fetch_array() , mysql_fetch_assoc() , mysql_fetch_object() , and mysql_fetch_row() all share a common underlying function in the PHP source code.

Version

PHP 4.0.3+

See also

To find the number of rows affected by a query:

mysql_num_rows()

To get a numeric error code from the last MySQL option:

mysql_errno()

To fetch a row of data from a query handle:

mysql_fetch_array()

mysql_fetch_object()

mysql_fetch_row()

To fetch a single field of data from a query handle:

mysql_result()



Example

Example 803. Display all rows of data from a query handle

<pre>
<?php
// Included code that connects to a MySQL server and sets a default database
// See the MySQL Functions chapter introduction for the source code for the file
include ('mysql_connect.inc.php');

// Make a simple SELECT query
$query = "SELECT * FROM user ORDER BY login";
$mysql_result = @ mysql_query ($query)
    or die ("Query '$query' failed with error message: \"" . mysql_error () . '"');

// Ensure that our query returned some data
$num_rows = mysql_num_rows ($mysql_result)
    or die ("Try a different query - this one did not return any rows.");

// Now display all the data from the query
for ($count = 0; $row = mysql_fetch_assoc ($mysql_result); $count++)
{
    echo "\n\nRow #$count\n";
    print_r ($row);
}
?>
</pre>



PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.

Powered by: vBulletin Version 3.0.7
Copyright ©2000 - 2005, Jelsoft Enterprises Ltd.
Copyright © 2001 - 2005, ThinkDing LLC. All Rights Reserved.