mysql.h


Función mysql_eof()

my_bool mysql_eof(MYSQL_RES *result)

Esta función está desaconsejada. mysql_errno() o mysql_error() pueden usarse en su lugar.

mysql_eof() determina si la última fila de un conjunto de resultados ha sido leída.

Si se obtiene un conjunto de resultados a partir de una llamada exitosa a mysql_store_result(), el cliente recibe el conjunto completo en una operación. En ese caso, un valor NULL de una llamada a mysql_fetch_row() siempre significa que el final del conjunto de resultados ha sido alcanzado y es innecesario llamar a mysql_eof(). Cuando se usa con mysql_store_result(), mysql_eof() siempre devuelve verdadero.

Por otra parte, si se usa mysql_use_result() para iniciar una recuperación de un conjunto de resultados, las filas del conjunto se obtienen del servidor una a una como si se hubiese llamado a mysql_fetch_row() repetidamente. Debido a que se puede producir un error en la conexión durante este proceso, un valor de retorno NULL desde mysql_fetch_row() no significa necesariamente que en final del conjunto de resultados ha sido alcanzado con normalidad. En ese caso, se puede usar mysql_eof() para determinar qué ha sucedido. mysql_eof() devuelve un valor distinto de cero si se ha alcanzado el final del conjunto de resultados y cero si ha ocurrido un error.

Historicamente, mysql_eof() precede a las funciones de error estándar de MySQL mysql_errno() y mysql_error(). Ya que estas funciones de error proporcionan la misma información, su uso es preferible sobre mysql_eof(), que actualmente está desaconsejada. (De hecho, esas funciones proporcionan más información, ya que mysql_eof() devuelve sólo un valor booleano mientras que las funciones de error indican un motivo para el error cuando uno ocurre.)

Valores de retorno

Cero si no ha ocurrido un error. Distinto de cero si se ha alcanzado el final del conjunto de resultados.

Errores

Ninguno

Ejemplo

El siguiente ejemplo muestra cómo se debe usar mysql_eof():

mysql_query(&mysql,"SELECT * FROM some_table");
result = mysql_use_result(&mysql);
while((row = mysql_fetch_row(result)))
{
    // hacer algo con los datos
}
if(!mysql_eof(result))  // mysql_fetch_row() fallo debido a un error
{
    fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
}

Sin embargo, se puede conseguir el mismo efecto con las funciones de error estándar de MySQL:

mysql_query(&mysql,"SELECT * FROM some_table");
result = mysql_use_result(&mysql);
while((row = mysql_fetch_row(result)))
{
    // hacer algo con los datos
}
if(mysql_errno(&mysql))  // mysql_fetch_row() fallo debido a un error
{
    fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
}