Extracted from Pike v8.0 release 28 as of 2015-08-03.
   

Method Iterator()->_random()


Method _random

void random( Iterator arg )

Description

If this function is defined then it sets the iterator to point to a random item in the accessible set. The random distribution should be rectangular within that set, and the pseudorandom sequence provided by random should be used.