Provided by: kaya_0.4.4-6ubuntu3_amd64 bug


       WebCommon::incomingValue  -  Returns  the  first  value  for  the specified key from user-
       supplied data


       String incomingValue( String key, DataSource ds )


       key The key to retrieve data for

       ds The source for user-supplied data


       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.


       Kaya standard library by Edwin Brady, Chris Morris  and  others  (  For
       further information see


       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.


       WebCommon.DataSource (3kaya)
       WebCommon.incomingData (3kaya)
       WebCommon.incomingExists (3kaya)
       WebCommon.incomingKeys (3kaya)