Form fields: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>Bale
No edit summary
imported>StDoodle
mNo edit summary
Line 15: Line 15:
parameter1=|
parameter1=|
p1desc=Similiar to [[form_field|form_field()]], but returns a map with all the name/value pairs from the relay request being handled. Unlike the [[form_field|form_field()]] function, this allows iterating over all the fields,
p1desc=Similiar to [[form_field|form_field()]], but returns a map with all the name/value pairs from the relay request being handled. Unlike the [[form_field|form_field()]] function, this allows iterating over all the fields,
and can distinguish a field with a blank value from a nonexistent field.|
and can distinguish a field with a blank value from a nonexistent field. (The exception to this being checkboxes, which return no information when unchecked.)|
}}|
}}|


Line 29: Line 29:


see_also={{SeeAlso|form_field|write|writeln}}|
see_also={{SeeAlso|form_field|write|writeln}}|
more_info=See [http://kolmafia.us/showthread.php?3842-Form-of...HTML!&highlight=form+html this thread] for details.|
}}
}}

Revision as of 13:57, 3 May 2010

Function Syntax

string [string] form_fields()

  • Similiar to form_field(), but returns a map with all the name/value pairs from the relay request being handled. Unlike the form_field() function, this allows iterating over all the fields, and can distinguish a field with a blank value from a nonexistent field. (The exception to this being checkboxes, which return no information when unchecked.)

Used to read form information in User Interface Scripts.

Code Sample

Read the form fields in a UI script for use later.

string [string] fields;
fields = form_fields();
boolean success = count(fields) > 0;

See Also

form_field() | write() | writeln()

More Information

See this thread for details.