String incomingValue(String key, DataSource ds)
Arguments
key: The key to retrieve data fords: The source for user-supplied data
Usage
Returns the first value 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
val = incomingData("a",DataGet);
// val = "1"
val = incomingData("b",DataGet);
// val = "3"
val = incomingData("c",DataGet);
// NotIncoming exception thrown
val = incomingData("z",DataGet);
// val = ""This is generally easier to use than incomingData if only one value is expected for that key.
