cubrid_num_rows

(PECL CUBRID >= 8.3.0)

cubrid_num_rows — Récupère le nombre de lignes d'un jeu de résultats

Description

cubrid_num_rows(resource $result): int

La fonction cubrid_num_rows() est utilisée pour récupérer le nombre de lignes depuis le jeu de résultats. L'on ne peut l'utiliser que lorsque la requête est de type SELECT. Lorsque l'on veut savoir ce type de valeur pour une requête de type INSERT, UPDATE ou DELETE, il faut utiliser la fonction cubrid_affected_rows().

Note : La fonction cubrid_num_rows() ne peut être utilisée que sur les requêtes synchrones ; elle retourne 0 sur des requêtes asynchrones.

Liste de paramètres

result: Le paramètre result provient d'un appel à la fonction cubrid_execute(), la fonction cubrid_query() ou la fonction cubrid_prepare().

Valeurs de retour

Nombre de lignes en cas de succès.

0 lorsque la requête a été effectuée en mode asynchrone.

-1, si la requête SQL n'est pas de type SELECT.

false si une erreur survient.

Exemples

Exemple #1 Exemple avec cubrid_num_rows()

<?php
$conn = cubrid_connect("localhost", 33000, "demodb", "dba");

$req = cubrid_execute($conn, "SELECT * FROM code");

$row_num = cubrid_num_rows($req);
$col_num = cubrid_num_cols($req);

printf("Row Num: %d\nColumn Num: %d\n", $row_num, $col_num);

cubrid_disconnect($conn);
?>

L'exemple ci-dessus va afficher :

Row Num: 6
Column Num: 2

Voir aussi

cubrid_execute() - Exécute une requête SQL préparée
cubrid_num_cols() - Récupère le nombre de colonnes du jeu de résultats
cubrid_affected_rows() - Récupère le nombre de lignes affectées par la dernière requête SQL