html_form_parameter_array ($name, $data):

Next: *html_arrayquery_parameter_pairs($prefix, $data): Up: Funktionen für die Erstellung Previous: html_link_parameter_array_raw ($name, $data):

html_form_parameter_array ($name, $data):

Um ein ganzes Array nicht per Link, sondern per Hidden-Elementen eines Formulares, an eine neue Skript-Instanz zu übergeben, dient diese Funktion. Sie erzeugt aus gegebenem Array mehrere Hidden-Form-Elemente um das Array rekursiv per Formular zu übertragen. Dabei verwendet sie die Funktion 'html_form_element' und die Hilfsfunktion 'html_arrayquery_parameter_pairs'. Parameter sind (Vergleiche 'html_link_parameter_array'):

[$name:]Schlüsselname des Parameter-Arrays, d.h. später über ein oder mehrere Hidden-Formelemente übergebene Parameter bzw. späterer Variablenname bei Abschicken des vollständigen Formulares.
[$data:]gegebenes Array, ein Wert $data[key1][key2]...[keyn] wird dabei in einem eigenen Hidden-Formelement mit Namen (name=) "$name[key1][key2]...[keyn]" abgelegt. Die Werte werden dabei nicht htmlencoded.

Rückgabe ist ein String für Parameterübergabe des Arrays durch Hidden-Form-Elemente, d.h. ein String der HTML-Code für mehrere Hidden-Form-Elemente enthält. Um ein vollständiges Formular zu erhalten muss davor bzw. dahinter der Beginn bzw. das Ende eines HTML-Formulares - z.B. durch 'html_form_head' bzw. 'html_form_end' erzeugt - gesetzt werden.