debian man page for data::random::wordlist

Query: data::random::wordlist

OS: debian

Section: 3pm

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

Data::Random::WordList(3pm)				User Contributed Perl Documentation			       Data::Random::WordList(3pm)

NAME
Data::Random::WordList - Perl module to get random words from a word list
SYNOPSIS
use Data::Random::WordList; my $wl = new Data::Random::WordList( wordlist => '/usr/share/dict/words' ); my @rand_words = $wl->get_words(10); $wl->close();
DESCRIPTION
Data::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.
METHODS
new() Returns a reference to a new Data::Random::WordList object. Use the "wordlist" param to initialize the object: o wordlist - the path to the wordlist file. If a path isn't supplied, the wordlist distributed with this module is used. get_words([NUM]) NUM contains the number of words you want from the wordlist. NUM defaults to 1 if it's not specified. get_words() dies if NUM is greater than the number of words in the wordlist. This function returns an array or an array reference depending on the context in which it's called. 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.
VERSION
0.07
AUTHOR
Originally written by: Adekunle Olonoh Currently maintained by: Buddy Burden (barefoot@cpan.org), starting with version 0.06
COPYRIGHT
Copyright (c) 2000-2011 Adekunle Olonoh. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
Data::Random perl v5.14.2 2012-06-04 Data::Random::WordList(3pm)
Related Man Pages
word-list-compress(1) - debian
word-list-compress(1) - suse
word-list-compress(1) - ultrix
data::random::wordlist(3pm) - debian
www::mechanize::formfiller::value::random(3pm) - debian
Similar Topics in the Unix Linux Community
Grammar
to insert some word somewhere in the line with shell (or perl)
Random number is not reused
Choose a single word from a wordlist by matching the letters it contains?
Random File Selection and Moving