cubrid_fetch

(PECL CUBRID >= 8.3.0)

cubrid_fetch — Récupère la prochaine ligne du jeu de résultats

Description

mixed cubrid_fetch ( resource $result [, int $type = CUBRID_BOTH ] )

La fonction cubrid_fetch() est utilisée pour récupérer une seule ligne depuis le résultat de la requête. Le curseur se déplace automatiquement sur la prochaine ligne une fois la récupération effectuée.

Liste de paramètres

result: Le paramètre result provient de l'appel à la fonction cubrid_execute()
type: Type du tableau à retourner : CUBRID_NUM, CUBRID_ASSOC, CUBRID_BOTH, CUBRID_OBJECT. Si vous voulez utiliser un objet LOB, vous pouvez utiliser CUBRID_LOB.

Valeurs de retour

Tableau ou objet de résultat, en cas de succès.

FALSE lorsqu'il n'y a plus de ligne de disponible, NULL si une erreur survient.

Le résultat peut être sous la forme d'un tableau ou d'un objet ; le type de résultat peut être défini grâce au paramètre type. La variable type peut être définie à une des valeurs suivantes :

CUBRID_NUM : Tableau numérique (en commençant à l'indice 0)
CUBRID_ASSOC : Tableau associatif
CUBRID_BOTH : Tableau numérique et associatif (valeur par défaut)
CUBRID_OBJECT : Objet dont les noms des attributs correspondent aux noms des colonnes du résultat de la requête

Lorsque l'argument type est omis, le résultat sera retourné en utilisant l'option CUBRID_BOTH par défaut. Lorsque vous voulez recevoir le résultat de la requête sous la forme d'un objet, le nom de la colonne du résultat doit être conforme aux règles de nommage des identifiants en PHP. Par exemple, les noms de colonnes comme "count(*)" ne peuvent être acceptés dans le type objet.

Exemples

Exemple #1 Exemple avec cubrid_fetch()

<?php
$conn = cubrid_connect("localhost", 33000, "demodb");
$req = cubrid_execute($conn, "SELECT * FROM stadium WHERE nation_code='GRE' AND seats > 10000");

printf("%-40s %-10s %-6s %-20s\n", "name", "area", "seats", "address");
while ($row = cubrid_fetch($req)) {
	printf("%-40s %-10s %-6s %-20s\n",
		$row["name"], $row["area"], $row["seats"], $row["address"]);
}

// Si vous voulez utiliser un objet LOB, vous pouvez utiliser
// cubrid_fetch($req, CUBRID_LOB)

cubrid_close_request($req);

cubrid_disconnect($conn);
?>

L'exemple ci-dessus va afficher :

name                                     area       seats  address             
Panathinaiko Stadium                     86300.00   50000  Athens, Greece      
Olympic Stadium                          54700.00   13000  Athens, Greece      
Olympic Indoor Hall                      34100.00   18800  Athens, Greece      
Olympic Hall                             52400.00   21000  Athens, Greece      
Olympic Aquatic Centre                   42500.00   11500  Athens, Greece      
Markopoulo Olympic Equestrian Centre     64000.00   15000  Markopoulo, Athens, Greece
Faliro Coastal Zone Olympic Complex      34650.00   12171  Faliro, Athens, Greece
Athens Olympic Stadium                   120400.00  71030  Maroussi, Athens, Greece
Ano Liossia                              34000.00   12000  Ano Liosia, Athens, Greece

Voir aussi

cubrid_execute() - Exécute une requête SQL préparée
cubrid_fetch_array() - Récupère une ligne de résultat sous forme de tableau associatif, de tableau numérique, ou les deux
cubrid_fetch_row() - Retourne un tableau numérique avec les valeurs de la ligne courante
cubrid_fetch_assoc() - Retourne un tableau associatif correspondant à la ligne récupérée
cubrid_fetch_object() - Récupère la prochaine ligne et la retourne sous la forme d'un objet