MDB_Common::limitQuery()

MDB_Common::limitQuery() -- Envoie une requête limitée à la base de données

Synopsis

require_once 'MDB.php';

mixed &limitQuery (string $query, array [$types], integer $from, integer $count)

Description

Exécute une requête SQL mais ne récupère que un nombre spécifique de lignes. C'est une émulation de l'option LIMIT de MySQL.

Paramètres

chaîne de caractères $query

la requête SQL

array $types

si fourni, les types des colonnes du jeu de résultats seront définis pour la récupération

entier $from

la ligne à partir de laquelle on commence à récupérer

entier $count

le nombre de lignes à récupérer

Valeur retournée

mixed - une nouvelle ressource id/MDB_OK ou une MDB_Error si une erreur survient

Valeurs renvoyées

Tableau 34-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
MDB_ERROR_NO_DB_SELECTED NULL Aucune base de données n'a été choisie. Vérifiez le DSN dans la fonction connect() .
n'importe quel code erreur  Erreur spécifique à la base de données Vérifiez la section relative à la base de données dans le manuel PHP afin de détecter la raison de cette erreur. Dans la plupart des cas, une requête SQL incorrecte, i.e. utilisation d'une clause LIMIT dans une requête destinée à une base de données Oracle.

Note

Cette fonction ne peut pas être appelée de façon statique.

Avertissement

Ce module est EXPéRIMENTAL. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur prochain, et ce, SANS PRéAVIS! Soyez-en conscient, et utilisez ce module à vos propres risques.

Suivant la base de données, vous ne devriez pas avoir plus de vitesse que d'utilser la fonction query() . L'avantage de limitQuery() est l'effacement des lignes non désirées du jeu de résultats, aussi vite que possible. Ceci permet de réduire la consommation mémoire.

Voir aussi

query()