html_table($datas, $cols0, $param = array ()):

Statt eine Tabelle durch Einzelaufrufe von ´html_table_head´, ´html_table_line´ bzw. ´html_table_lines´ und ´html_table_end´ zu erzeugen, kann bei gleichbleibendem $cols und $param auch ein einziger Aufruf der Funktion ´html_table´ verwendet werden. Mit ´html_table´ wird also der HTML-Quelltext für eine ganze HTML-Tabelle erzeugt, d.h. Tabellenkopf (<table>-Tag), Kopfzeile und Datenzeilen sowie Tabellenende (</table>-Tag). Für den Kopf und die Kopfzeile wird ´html_table_head´ aufgerufen. Die (Daten)-Zeilen werden dabei aus einer Liste vorgegebener Datentupel mit der Funktion ´html_table_lines´ generiert. Von´html_table_lines´ wird dabei je eine Zeile aus einem Datentupel generiert, d.h. pro Datentupel wird ´html_table_line´ aufgerufen. Die Rückgabewerte der einzelnen Aufrufe, d.h. die HTML-Quelltexte von Tabellenkopf, Kopfzeile, den einzelnen Daten-Zeilen und vom Tabellenende werden zu einem String zusammengesetzt und zurückgegeben.
´html_table´ ist vor allem für die Ausgabe von SQL-Ergebnissen gedacht.
Parameter sind (siehe auch ´html_table_head´, ´html_table_lines´, ´html_table_line´, ´html_table_end´) :

• [$datas:]Liste von Datentupeln, wobei ein Datentupel Datentupel ein assoziatives Array, bestehend aus beliebigen Key/Value-Paaren ist, z.b. wie es von db_query als Repräsentation einer Zeile eines SQL-Ergebnisses zurückgeliefert wird, d.h. die Elemente von $datas werden einzeln als Parameter $entry an ´html_table_line´ übergeben.
• [$cols0:]Liste Spaltennamen der Tabelle. Diese Bezeichner werden an anderer Stelle als Referenz benutzt. Die Reihenfolge in dieser Liste bestimmt die Reihenfolge der Spalten in der HTML-Tabelle.
  Eine Spalte mit Namen '*' wird aber ganz zu Beginn durch die Liste aller (nichtnummerischen) Keys des ersten Datentupels $datas[0] ersetzt. Ist die $cols leer, so wird als Standart '*' und damit dann die Liste aller (nichtnummerischen) Keys von $data[0] gewählt .
• [$param:]assoziatives Array, das Parameter für die Funktionen ´html_table_head´ (Tabellenkopf und Kopfzeile) und ´html_table_line´ (Datenzeilen) enthalten kann. Siehe ´html_table_head´ bzw. ´html_table_line´.

Rückgabe von ´html_table´ ist ein String, der den HTML-Quelltext für die Tabelle enthält.

 

Oft betrachtet man nicht eine ganze Liste von Datensätzen, sondern nur einen einzigen. Um einen Datensatz alleine in einer Tabelle darzustellen, empfiehlt es sich nicht, die Tabelle aus Kopfzeile und einer Datenzeile für den einzigen Datensatz aufzubauen. Besser ist eine mehrspaltige Darstellung, bei der Beschriftung, die sonst in der Kopfzeile stehen würde, und Datenwert in aufeinanderfolgende Spalten der Spalten zu setzen. Dies erledigt für den Benutzer die folgende Funktion: