->count()

->count() – Effectue une requête count()

Synopsis

int $DB_DataObject->count ( string|boolean $countWhat|$whereAddOnly , boolean $whereAddOnly )

Description

Cette méthode effectue une requête count() sur les clés des colonnes des tables et retourne le nombre de lignes résultantes. La condition par défaut appliquée à count() est une combinaison de variables d'objets et de configurations whereAdd. Si la constante DB_DATAOBJECT_WHEREADD_ONLY est passé en tant que premier argument, alors seules les configurations whereAdd seront utilisées.

Parameter

  • string $countWhat - par défaut, count() se basera sur les clés primaires, si vous avez besoin de compter quelque chose d'autre, si vous indiquez uniquement DISTINCT, la méthode comptera les clés primaires préfixées avec DISTINCT ou ajoute votre propre valeur (n'oubliez pas d'échapper votre valeur si nécessaire).

  • boolean $useWhereAddOnly - n'utiliser que les conditions whereAdd (par défaut, count() utilisera les configurations des objets et les conditions whereAdd).

Return value

int|false - nombre de résultats ou FALSE si une erreur survient

Note

This function can not be called statically.

Example

Divers exemples d'utilisation de count()

<?php

/* Utilisation des valeurs propres */
$person = new DataObjects_Person;
$person->name  "test"
$total $person->count();
echo 
"Il y a {$total} personnes avec un nom comme test";

/* Utilisation de countWhat */
$person = new DataObjects_Person;
$total $person->count('DISTINCT name');
echo 
"Il y a {$total} noms dans la base de données";

/* Utilisation de countWhat valeur = DISTINCT */
$person = new DataObjects_Person;
$total $person->count('DISTINCT');
echo 
"Il y a {$total} noms dans la base de données";

/* Utilisation de whereOnly */
$person = new DataObjects_Person;
$person->name "test";
$person->whereAdd("name like '%test%");
$total $person->count(DB_DATAOBJECT_WHEREADD_ONLY);
echo 
"Il y a {$total} noms dans la base de données";

?>

SQL résultant


SELECT count(person.id) AS DATAOBJECT_NUM
FROM person
WHERE person.name = 'test';

SELECT count(DISTINCT name) AS DATAOBJECT_NUM
FROM person;

SELECT count(DISTINCT person.id) AS DATAOBJECT_NUM
FROM person;

SELECT count(person.id) AS DATAOBJECT_NUM
FROM person
WHERE name like '%test%';
Récupère la ligne suivante (Previous) Insert les variables de l'objet courant dans la base de données (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.