html_table_line($entry, $cols0, $param = array ()):

Mit ´html_table_line´ wird HTML-Code für eine (Daten)-Zeile einer Tabelle erzeugt. Dabei können Daten aus einem gegebenen Datentupel (z.b. aus der Datenbank, wie es von db_query zurückgeliefert wird) in gegebene Schablonen eingesetzt werden (siehe Parameter $param[datacell_format] unten). Parameter sind:

• [$entry:]Datentupel, d.h. 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
• [$cols0:]Liste Spaltennamen der Tabelle. Diese Bezeichner werden an anderen Stellen als Referenz benutzt. Die Reihenfolge in dieser Liste bestimmt die Reihenfolge der Spalten in der HTML-Tabelle, Eine Spalte mit Namen '*' wird aber zu Beginn durch die Liste aller (nichtnummerischen) Keys des Datentupels $entry ersetzt.
• [$param:]assoziatives Array, das weitere Parameter enthalten kann:
  • [data_bgcolor:]Standart-Hintergrundfarbe der Tabellenzeile (bgcolor-Attribut im tr-Tag)
  • [data_bgcolor2:]alternative Zeilen-Hintergrundfarbe; falls festgelegt, so wechselt die Hintergrundfarbe pro Zeile (d.h. pro Aufruf der Funktion db_table_line) zwischen dem in data_bgcolor2 und dem in data_bgcolor festgelegten Wert data_fgcolor: Standart-Vordergrundfarbe der Tabellenzeile (<font color=...>...</font>)
  • [data_fgcolor2:]alternative Zeilen-Vordergrundfarbe; falls festgelegt, so wechselt die Vordergrundfarbe pro Zeile (d.h. pro Aufruf der Funktion db_table_line) zwischen dem in data_fgcolor2 und dem in data_fgcolor festgelegten Wert
  • [data_valign:]valign-Ausrichtung der Tabellen-Zeile (valign-Attribut im tr-Tag)
  • [data_align:]align-Ausrichtung der Tabellen-Zeile (align-Attribut im tr-Tag)
  • [datacell_bgcolor:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols eine eigene Hintergrundfarbe festlegt (bgcolor-Attribut im td-Tag)
  • [datacell_fgcolor:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols eine eigene Vordergrundfarbe festlegt (<font color=...>)
  • [datacell_format:]Gibt ein Format für den Inhalt einer Tabellenspalte an.
    Kann im Prinzip beliebiger String sein, in dem vor Benutzung eine Reihe von Ersetzungen möglich ist. Vor allem sind Werte aus dem Datensatz $entry einsetzbar. Die Ersetzung wird durch die Funktion ´html_substitute_data´ vorgenommen, wobei hier alle von dieser Funktion unterstützten Ersetzungen erlaubt sind (siehe ´html_substitute_data´). Z.B. wird "$(feldname)" durch den bloßen String-Wert des Wertes $entry[feldname] aus dem Datensatz ersetzt, "$[feldname]" wird durch den htmlencodeten Wert von entry[feldname] und "$<feldname>" durch den urlencodeten Wert von $entry[feldname] ersetzt. Weitere Ersetzungen siehe ´html_substitute_data´.
    Ist für eine Spalte hier kein Format angegeben, so wird der Wert von datacell_format_default (siehe unten) statt dessen benutzt, fehlt auch dieser, so wird der Wert aus dem Datensatz $entry[$spaltenname] (htmlencoded) benutzt, wenn $spaltenname der Name der aktuellen Spalte aus $cols0 ist.
  • [datacell_param:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols weitere Parameter für die Spalte festlegt, d.h. Wert zu einem Key (Spaltenname) ist selbst assoziatives Array mit folgenden möglichen Parametern:
    • [width:]Weite der Spalte (width-Attribut im td-Tag)
    • [align:]Ausrichtung der Spalte mit align-Attribut des td-Tags
    • [valign:]Ausrichtung der Spalte mit valign-Attribut des td-Tags
    • [p_align:]Ausrichtung des Inhalts der Spalte mit <p align=..>-Tag
    • [bold:]Inhalt der Kopfspalte wird fett gedruckt (<b>..</b>)
    • [colspan:]Verbindung dieser Spalte mit einer oder mehreren der folgenden, bzw. colspan-Attribut des td-Tags und entsprechend viele folgende Spalten aus $cols werden übersprungen.
      Vor allem dann sinnvoll, falls jede Spalte durch einzelnen Aufruf von ´html_table_line´ durch Benutzer mit jeweils eigenem $param aufgebaut wird
    • [datacell_format_default:]Default-Wert für die Werte des Arrays datacell_format, falls nicht spezifiziert wird als Default für den Inhalt einer Spalte mit Namen $key jeweils der Wert aus dem Datentupel $entry[$key] genommen
    • [dataconversion:]assoziatives Array, das für jede Komponente eines Datensatzes anhand ihres Namens aus $cols0 eine Datenkonvertierungsfunktion definieren kann.
      Eine solche Funktion wird zu Beginn auf die jeweiligen Komponenten des Datensatzes $entry angewendet, bevor dieser benutzt wird. Sie ersetzt den jeweiligen Wert, durch die Rückgabe der Konvertierungsfunktion, die mit demursprünglichen Wert als erstem Parameter aufgerufen wird.
      Vor allem gedacht, um bei SQL-Ergebnisse Daten für die Ausgabe zu konvertieren, z.B. SQL-DATE oder SQL-BOOL-Werte.

Als Rückgabe liefert diese Funktion einen String, der den HTML-Quelltext für die Tabellen-Zeile enthält.