db2_num_fields

(PECL ibm_db2 >= 1.0.0)

db2_num_fields — Retourne le nombre de champs contenus dans un jeu de résultats

Description

function 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 lorsqu'on gère des jeux de résultats retournés 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ù l'application ne peut faire autrement pour obtenir et utiliser ces résultats.

Liste de paramètres

stmt
Une ressource d'instruction 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 d'instruction spécifiée. Retourne false si la ressource d'instruction n'est pas une valeur d'entrée valide.

Exemples

Exemple #1 Récupération du nombre de champs dans un jeu de résultats

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} colonnes 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