Function.mysqli-use-result

Aus PHP-Wiki

Wechseln zu: Navigation, Suche
Rechtsschutzversicherung Vergleichen Online - Schadensabwicklung und Schadensfreiheitsklassen - Fahranfänger, Unfallversicherung Vergleich . Risiko-Lebensversicherung Vergleichen Online

mysqli_use_result

(PHP 5)

mysqli_use_result

(no version information, might be only in CVS)

mysqli->use_result -- Initiate a result set retrieval

Inhaltsverzeichnis

Description

Procedural style:

mixed mysqli_use_result ( object link)
</BR >

Object oriented style (method):

class mysqli {
</BR >mixed use_result ( void )
</BR >}

mysqli_use_result() is used to initiate the retrieval of a result set from the last query executed using the function.mysqli-real-query function on the database connection specified by the link parameter. Either this or the function.mysqli-store-result function must be called before the results of a query can be retrieved, and one or the other must be called to prevent the next query on that database connection from failing.

Anmerkung: The mysqli_use_result() function does not transfer the entire result set from the database and hence cannot be used functions such as function.mysqli-data-seek to move to a particular row within the set. To use this functionality, the result set must be stored using function.mysqli-store-result. One should not use mysqli_use_result() if a lot of processing on the client side is performed, since this will tie up the server and prevent other threads from updating any tables from which the data is being fetched.


Return values

Returns an unbuffered result object or FALSE if an error occured.


See also

function.mysqli-real-query, function.mysqli-store-result.


Example


Beispiel 1. Object oriented style

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$query  = "SELECT CURRENT_USER();";
$query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5";

/* execute multi query */
if ($mysqli->multi_query($query)) {
    do {
        /* store first result set */
        if ($result = $mysqli->use_result()) {
            while ($row = $result->fetch_row()) {
                printf("%s\n", $row[0]);
            }
            $result->close();
        }
        /* print divider */
        if ($mysqli->more_results()) {
            printf("-----------------\n");
        }
    } while ($mysqli->next_result());
}

/* close connection */
$mysqli->close();
?>

Beispiel 2. Procedural style

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$query  = "SELECT CURRENT_USER();";
$query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5";

/* execute multi query */
if (mysqli_multi_query($link, $query)) {
    do {
        /* store first result set */
        if ($result = mysqli_use_result($link)) {
            while ($row = mysqli_fetch_row($result)) {
                printf("%s\n", $row[0]);
            }
            mysqli_free_result($result);
        }
        /* print divider */
        if (mysqli_more_results($link)) {
            printf("-----------------\n");
        }
    } while (mysqli_next_result($link));
}

/* close connection */
mysqli_close($link);
?>

The above examples would produce the following output: 

my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer
Von „http://php-wiki.de/index.php/Function.mysqli-use-result“
Persönliche Werkzeuge