# db2_num_fields

(PECL ibm_db2 >= 1.0.0)

db2_num_fields — Retourne le nombre de champs contenu du jeu de résultats

### Description

db2_num_fields(resource `$stmt`): int|false

Retourne le nombre de champs contenus dans le jeu de résultats. Cette fonction est très utile lorsque vous gérez des jeux de résultats retourné par des requêtes générées dynamiquement ou pour des jeux de résultats retournés par des procédures d'enregistrement, là où votre application ne peut faire autrement pour obtenir et utiliser ces résultats.

### Liste de paramètres

`stmt`

  Une ressource valide contenant un jeu de résultats.

### Valeurs de retour

Retourne un entier représentant le nombre de champs dans le jeu de résultats associé avec la ressource spécifiée. Retourne `false` si la ressource n'est pas valide.

### Exemples

Exemple #1 Exemple avec db2_num_fields()

L'exemple suivant démontre comment obtenir le nombre de champs retournés dans le jeu de résultats.

`<?php
$sql = "SELECT id, nom, race, poids FROM animaux ORDER BY race";
$stmt = db2_prepare($conn, $sql);
db2_execute($stmt, $sql);
$columns = db2_num_fields($stmt);
echo "Il y a {$columns} colonne dans le jeu de résultats.";
?>`

L'exemple ci-dessus va afficher :

    Il y a 4 colonnes dans le jeu de résultats.

### Voir aussi

- db2_execute() - Exécute une requête SQL préparée
- db2_field_display_size() - Retourne le maximum d'octets requis pour afficher une colonne
- db2_field_name() - Retourne le nom de la colonne du jeu de résultats
- db2_field_num() - Retourne la position du nom de la colonne du jeu de résultats
- db2_field_precision() - Retourne la précision de la colonne indiquée du jeu de résultats
- db2_field_scale() - Retourne l'échelle de la colonne indiquée du jeu de résultats
- db2_field_type() - Retourne le type de donnée de la colonne indiquée du jeu de résultats
- db2_field_width() - Retourne la largeur de la valeur courante de la colonne indiquée du jeu de résultats