[String] incomingData(String key, DataSource ds)
Arguments
key: The key to retrieve data fords: The source for user-supplied data
Usage
Returns an array of all values for the key from the specified data source, or throws a NotIncoming Exception if no such key exists.
// GET /example.cgi?a=1;b=3;b=5;z=;z;z
vals = incomingData("a",DataGet);
// vals = ["1"]
vals = incomingData("b",DataGet);
// vals = ["3","5"]
vals = incomingData("c",DataGet);
// NotIncoming exception thrown
vals = incomingData("z",DataGet);
// vals = ["","",""]This is useful for processing the output from forms containing checkboxes with the same name or multiple selects.
<form action='example.cgi' method='get'>
<fieldset><legend>Example form</legend>
<select multiple='multiple' name='a'>
<option value='1'>Option 1</option>
<option value='2'>Option 2</option>
<option value='3'>Option 3</option>
<option value='4'>Option 4</option>
</select>
<input type='submit' value='Test!'>
</fieldset>
</form>