lr.paramarrRandom

Returns the value of the parameter at a random location in a parameter array

ExampleString and Parameter Functions

Syntax

lr.paramarrRandom( paramArrayName );

Arguments

ArgumentComments
paramArrayNameThe name of the parameter array.

lr.paramarrRandom returns a string containing the value of the parameter in a parameter array. The value is returned from the parameter at a position chosen randomly.

Return Values

A string buffer containing the value. On error, returns NULL.

Parameterization

Standard parameterization is not available for this function.

Concept Link IconSee Also

Example

   web.regSaveParam({name : 'outFlightVal',
     lb:'outboundFlight value',
     rb:'>',
     ord:'ALL',
     saveLen:'18'}
   );

   web.submitForm({name : 'reservations.pl',
     snapshot:'t4.inf',
     itemData :[{name:'depart',value:'London'},
         {name:'departDate',value:'11/20/2003'},
         {name:'arrive',value:'New York'},
         {name:'returnDate',value:'11/21/2003'},
         {name:'numPassengers',value:'1'},
         {name:'roundtrip',value:'<OFF>'},
         {name:'seatPref',value:'None'},
         {name:'seatType',value:'Coach'},
         {name:'findFlights.x',value:'83'},
         {name:'findFlights.y',value:'16'}
       ]}
   );

   /*

   The result of regSaveParam having been called before the form submit is:
   Notify: Saving Parameter "outFlightVal_1 = 230;378;11/20/2003"
   Notify: Saving Parameter "outFlightVal_2 = 231;337;11/20/2003"
   Notify: Saving Parameter "outFlightVal_3 = 232;357;11/20/2003"
   Notify: Saving Parameter "outFlightVal_4 = 233;309;11/20/2003"
   Notify: Saving Parameter "outFlightVal_count = 4"
   */

   var flightVal = lr.paramarrRandom("outFlightVal");