Difference between revisions of "Form fields"

From Kolmafia
Jump to navigation Jump to search
imported>Bale
imported>StDoodle
m
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.