.\" This man page is automatically generated using
.\" kayadoc2man from the Kaya development tools and the -xmldocs compile 
.\" option. Editing it directly is not encouraged.
.\" It is under the same license as the source .k file that it was
.\" generated from.
.TH "WebCommon.incomingData" "3kaya" "August 2014" "Kaya" "Kaya module reference"
.SH "NAME"
WebCommon::incomingData \- Returns all values for the specified key from user-supplied data
.SH "SYNOPSIS"
.B [String] incomingData(
\fIString key, DataSource ds\fP
.B ")"
.SH "ARGUMENTS"
.PP
.B "key"
The key to retrieve data for
.PP
.B "ds"
The source for user-supplied data
.SH "DESCRIPTION"
.PP
Returns an array of all values for the key from the specified data source, or throws a
.B "WebCommon.NotIncoming"(3kaya)
Exception if no such key exists.
.IP "" -4
 // 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 = ["","",""]
.PP
This is useful for processing the output from forms containing checkboxes with the same name or multiple selects.
.IP "" -4
 <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>
.SH "AUTHORS"
Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/
.SH LICENSE
The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.
.SH "RELATED"
.PD 0
.PP
.B "WebCommon.DataSource"(3kaya)
.PP
.B "WebCommon.incomingExists"(3kaya)
.PP
.B "WebCommon.incomingKeys"(3kaya)
.PP
.B "WebCommon.incomingValue"(3kaya)
.PD 0.4v