Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) Standard preamble: ========================================================================
NAMEData::Random::WordList - Perl module to get random words from a word list
use Data::Random::WordList; my $wl = new Data::Random::WordList( wordlist => '/usr/share/dict/words' ); my @rand_words = $wl->get_words(10); $wl->close();
DESCRIPTIONData::Random::WordList is a module that manages a file containing a list of words.
The module expects each line of the word list file to contain only one word. It could thus be easily used to select random lines from a file, but for coherency's sake, I'll keep referring to each line as a word.
The module uses a persistent filehandle so that there isn't a lot of overhead every time you want to fetch a list of random words. However, it's much more efficient to grab multiple words at a time than it is to fetch one word at a time multiple times.
The module also refrains from reading the whole file into memory, so it can be safer to use with larger files.
new()Returns a reference to a new Data::Random::WordList object. Use the ``wordlist'' param to initialize the object:
- wordlist - the path to the wordlist file. If a path isn't supplied, the wordlist distributed with this module is used.
close()Closes the filehandle associated with the word list. It's good practice to do this every time you're done with the word list.
AUTHOROriginally written by: Adekunle Olonoh
Currently maintained by: Buddy Burden (firstname.lastname@example.org), starting with version 0.06