Function:cs_sql_count
cs_sql_count (var Datei, var SQL-Tabelle(n), [var Bedingungen ], [var Eindeutig ])
Mit dieser Funktion werden Zahlen als Integer abgeholt, z.B. um eine Anzahl oder Existenz von Datensätzen festzustellen.
Als Datei wird im Regelfall nur __FILE__ übergeben, ein in PHP vordefinierter Wert, der den Dateinamen weiterreicht, um im Fehlerfall den Ursprung zu finden.
Die SQL-Tabelle ist ohne Präfix anzugeben, sofern weitere SQL-Tabellen per JOIN folgen, sind die folgenden mit dem Präfix anzugeben und zudem für alle SQL-Tabellen Abkürzungen zu definieren, z.B. sqd für _squads.
Bedingungen sind die Entsprechung für die WHERE-Klausel bei normalen SQL-Querys und sind ohne das WHERE anzugeben. Beachten Sie bei vorhandenen JOINS bei den SQL-Tabellen, hier die Spalten, der Identifikation wegen, mit ihrer Abkürzung anzusprechen, z.B. _squads.squads_id als sqd.squads_id anzugeben.
Das Mitgeben der Option Eindeutig legt fest, welche Spalten bei der Abfrage jeweils nur einmal je aufgefundenem Wert berücksichtigt, bzw. darüber zusammengefasst werden. Dies erfordert oft ausgiebiges Testen, um das Ziel zu erreichen.
Beispiel:
$number_of_squads = cs_sql_count(__FILE__, 'squads');
Liest die Anzahl der in der SQL-Tabelle _squads eingetragenen Squads aus und liefert das Resultat als Integer.
Um Datensätze mit einer eindeutigen Identifikation (z.B. einer ID) nur einfach zu zählen, wird der oben erklärte Parameter var Eindeutig benutzt. Im folgenden dazu ein Beispiel:
$members_count = cs_sql_count(__FILE__,'members',0,'users_id');Als Resultat wird jeder Benutzer (egal wie oft er als Member eingetragen ist) nur ein Mal gezählt.
| Function:cs_sql_connect« | Function:cs_sql_count | »Function:cs_sql_delete |
