- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.3 Description des fonctions de l'API C
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_change_user()
- 24.2.3.3 mysql_character_set_name()
- 24.2.3.4 mysql_close()
- 24.2.3.5 mysql_connect()
- 24.2.3.6 mysql_create_db()
- 24.2.3.7 mysql_data_seek()
- 24.2.3.8 mysql_debug()
- 24.2.3.9 mysql_drop_db()
- 24.2.3.10 mysql_dump_debug_info()
- 24.2.3.11 mysql_eof()
- 24.2.3.12 mysql_errno()
- 24.2.3.13 mysql_error()
- 24.2.3.14 mysql_escape_string()
- 24.2.3.15 mysql_fetch_field()
- 24.2.3.16 mysql_fetch_fields()
- 24.2.3.17 mysql_fetch_field_direct()
- 24.2.3.18 mysql_fetch_lengths()
- 24.2.3.19 mysql_fetch_row()
- 24.2.3.20 mysql_field_count()
- 24.2.3.21 mysql_field_seek()
- 24.2.3.22 mysql_field_tell()
- 24.2.3.23 mysql_free_result()
- 24.2.3.24 mysql_get_client_info()
- 24.2.3.25 mysql_get_client_version()
- 24.2.3.26 mysql_get_host_info()
- 24.2.3.27 mysql_get_proto_info()
- 24.2.3.28 mysql_get_server_info()
- 24.2.3.29 mysql_get_server_version()
- 24.2.3.30 mysql_hex_string()
- 24.2.3.31 mysql_info()
- 24.2.3.32 mysql_init()
- 24.2.3.33 mysql_insert_id()
- 24.2.3.34 mysql_kill()
- 24.2.3.35 mysql_library_end()
- 24.2.3.36 mysql_library_end()
- 24.2.3.37 mysql_list_dbs()
- 24.2.3.38 mysql_list_fields()
- 24.2.3.39 mysql_list_processes()
- 24.2.3.40 mysql_list_tables()
- 24.2.3.41 mysql_num_fields()
- 24.2.3.42 mysql_num_rows()
- 24.2.3.43 mysql_options()
- 24.2.3.44 mysql_ping()
- 24.2.3.45 mysql_query()
- 24.2.3.46 mysql_real_connect()
- 24.2.3.47 mysql_real_escape_string()
- 24.2.3.48 mysql_real_query()
- 24.2.3.49 mysql_reload()
- 24.2.3.50 mysql_row_seek()
- 24.2.3.51 mysql_row_tell()
- 24.2.3.52 mysql_select_db()
- 24.2.3.53 mysql_set_server_option()
- 24.2.3.54 mysql_shutdown()
- 24.2.3.55 mysql_sqlstate()
- 24.2.3.56 mysql_ssl_set()
- 24.2.3.57 mysql_stat()
- 24.2.3.58 mysql_store_result()
- 24.2.3.59 mysql_thread_id()
- 24.2.3.60 mysql_use_result()
- 24.2.3.61 mysql_warning_count()
- 24.2.3.62 mysql_commit()
- 24.2.3.63 mysql_rollback()
- 24.2.3.64 mysql_autocommit()
- 24.2.3.65 mysql_more_results()
- 24.2.3.66 mysql_next_result()
unsigned int mysql_num_fields(MYSQL_RES
*result)
ou
unsigned int mysql_num_fields(MYSQL *mysql)
La seconde forme ne fonctionne plus à partir de la version
3.22.24 de MySQL. Pour passer un argument
MYSQL*, vous devez utiliser la fonction
unsigned int mysql_field_count(MYSQL
*mysql) à la place.
Description
Retourne le nombre de colonnes dans un jeu de résultats.
Notez que vous pouvez obtenir le nombre de colonnes soit à
partir d'un pointeur sur résultat, soit d'un pointeur de
connexion. Vous utiliserez le pointeur de connexion si
mysql_store_result() ou
mysql_use_result() ont retournés
NULL (et que donc, vous n'avez pas de
pointeur sur résultat). Dans ce cas, vous pouvez appeler
mysql_field_count() pour déterminer si
mysql_store_result() aurait du retourner un
résultat non-vide. Cela permet au client d'effectuer les
bonnes actions sans savoir si la requête était un
SELECT (ou équivalent). L'exemple
ci-dessous montre comment cela doit être utilisé.
Valeur de retour
Un entier non-signé représentant le nombre de champs dans un jeu de résultats.
Erreurs
Aucune.
Exemple
MYSQL_RES *result;
unsigned int num_fields;
unsigned int num_rows;
if (mysql_query(&mysql,query_string))
{
// erreur
}
else // la requête fonctionne, on s'occupe des données
{
result = mysql_store_result(&mysql);
if (result) // il y a des lignes
{
num_fields = mysql_num_fields(result);
// recupérer les lignes, puis appeler mysql_free_result(result)
}
else // mysql_store_result() n'a rien retourné ! pourquoi ?
{
if (mysql_errno(&mysql))
{
fprintf(stderr, "Erreur : %s\n", mysql_error(&mysql));
}
else if (mysql_field_count(&mysql) == 0)
{
// la requête ne retourne pas de données
// (ce n'etait pas un SELECT)
num_rows = mysql_affected_rows(&mysql);
}
}
}
Une alternative (si vous savez que votre requête aurait du
retourner des résultats) est de remplacer l'appel à
mysql_errno(&mysql) par un test sur la
nullité de mysql_field_count(&mysql).
Cela n'arrive que si un problème a été rencontré.
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
