mysql_fetch_lengths()
<<<		 mysql_fetch_row() mysql_field_count()
>>>
21.2.3 Description des fonctions de l'API C
21.2 API MySQL C
21 API MySQL
 Manuel de Référence MySQL 4.1 : Version Française
. mysql_affected_rows()
. mysql_change_user()
. mysql_character_set_name()
. mysql_close()
. mysql_connect()
. mysql_create_db()
. mysql_data_seek()
. mysql_debug()
. mysql_drop_db()
. mysql_dump_debug_info()
. mysql_eof()
. mysql_errno()
. mysql_error()
. mysql_escape_string()
. mysql_fetch_field()
. mysql_fetch_fields()
. mysql_fetch_field_direct()
. mysql_fetch_lengths()
->mysql_fetch_row()
. mysql_field_count()
. mysql_field_seek()
. mysql_field_tell()
. mysql_free_result()
. mysql_get_client_info()
. mysql_get_client_version()
. mysql_get_host_info()
. mysql_get_proto_info()
. mysql_get_server_info()
. mysql_get_server_version()
. mysql_info()
. mysql_init()
. mysql_insert_id()
. mysql_kill()
. mysql_list_dbs()
. mysql_list_fields()
. mysql_list_processes()
. mysql_list_tables()
. mysql_num_fields()
. mysql_num_rows()
. mysql_options()
. mysql_ping()
. mysql_query()
. mysql_real_connect()
. mysql_real_escape_string()
. mysql_real_query()
. mysql_reload()
. mysql_row_seek()
. mysql_row_tell()
. mysql_select_db()
. mysql_set_server_option()
. mysql_shutdown()
. mysql_sqlstate()
. mysql_ssl_set()
. mysql_stat()
. mysql_store_result()
. mysql_thread_id()
. mysql_use_result()
. mysql_warning_count()
. mysql_commit()
. mysql_rollback()
. mysql_autocommit()
. mysql_more_results()
. mysql_next_result()

21.2.3.19 mysql_fetch_row()

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

Description Récupère la ligne suivante d'un jeu de résultats. Lorsqu'elle est utilisée après mysql_store_result() , mysql_fetch_row() retourne NULL quand il n'y a plus de lignes a récupérer. Lorsqu'elle est utilisée après mysql_use_result() , mysql_fetch_row() retourne NULL quand il n'y a plus de lignes a récupérer ou qu'une erreur est rencontrée.

Le nombre de valeurs dans la ligne est donné par mysql_num_fields(result) . Si row contient la valeur de retour d'un appel à mysql_fetch_row() , les pointeurs sur les valeurs sont accédées de row[0] à row[mysql_num_fields(result)-1] . Les valeurs NULL de la ligne sont indiquées par des pointeurs NULL .

La longueur de la valeur du champ dans la ligne peut être obtenue en appelant mysql_fetch_lengths() . Les champs vides et les champs contenant NULL ont tous deux une longueur égale à zéro; vous pouvez les distinguer en vérifiant le pointeur sur la valeur du champ. Si le pointeur est NULL , le champ est NULL ; sinon, le champ est vide.

Valeur de retour Une structure MYSQL_ROW pour la prochaine ligne. NULL s'il n'y a plus de lignes a récupérer ou qu'une erreur survient.

Erreurs
    CR_SERVER_LOST
    La connexion au serveur a été perdue durant la requête.
    CR_UNKNOWN_ERROR
    Une erreur inconnue est survenue.
Exemple 

MYSQL_ROW row;
unsigned int num_fields;
unsigned int i;
 
num_fields = mysql_num_fields(result);
while ((row = mysql_fetch_row(result)))
{
   unsigned long *lengths;
   lengths = mysql_fetch_lengths(result);
   for(i = 0; i < num_fields; i++)
   {
       printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL");
   }
   printf("\n");
}

<< mysql_fetch_row() >>
mysql_fetch_lengths() Description des fonctions de l'API C mysql_field_count()