trusty (3) WebCommon.incomingData.3kaya.gz

NAME

       WebCommon::incomingData - Returns all values for the specified key from user-supplied data

SYNOPSIS

       [String] incomingData( String key, DataSource ds )

ARGUMENTS

       key The key to retrieve data for

       ds The source for user-supplied data

DESCRIPTION

       Returns   an   array   of  all  values  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
    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>

AUTHORS

       Kaya  standard  library  by  Edwin  Brady,  Chris  Morris  and  others  (kaya@kayalang.org).  For further
       information see http://kayalang.org/

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.

RELATED

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