WebCommon.incomingValue3kaya
Returns the first value for the specified key from user-supplied data
Usage
String incomingValue( String key, DataSource ds )
Arguments
key The key to retrieve data for
ds The source for user-supplied data
Overview
Returns the first value for the key from the specified data source, or throws a WebCommon.NotIncoming (3kaya) 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 WebCommon.incomingData (3kaya) if only one value is expected for that key.
Releases
4 releases since Debian 5.0 (Lenny); the text changed 3 times.