NAME
Text::Pipe::RandomCase - Text::Pipe filter to randomize character case
SYNOPSIS
use Text::Pipe qw(PIPE);
print PIPE('RandomCase')->filter('foobar');
print PIPE('RandomCase', probability => 2 )->filter('foobar');
DESCRIPTION
This module provides a pipe segment for Text::Pipe to randomly uppercase
the characters of a string. All of the described methods can also be
used as paramters to its constructor.
METHODS
probability($arg)
Determines the frequency of upper case characters. Any 1/$arg'th
character will be uppercased on average. Defaults to undef, in which
case this module will return strings with a probability of 1/4 for any
character to be uppercased.
force_one($bool)
If given a true value - in the Perl sense, i.e. anything except undef, 0
or the empty string, any string will have at least one uppercased
character in a random position. If no argument is given, it returns the
slot's value. Default to false.
DEPENDENCIES
Text::Pipe
VERSION
0.01
AUTHOR
Mario Domgoergen <mdom@cpan.org>
BUGS
Please report any bugs or feature requests to "bug-text-pipe-randomcase
at rt.cpan.org", or through the web interface at
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-Pipe-RandomCase>. I
will be notified, and then you'll automatically be notified of progress
on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Text::Pipe::RandomCase
You can also look for information at:
* RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-Pipe-RandomCase>
* AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Text-Pipe-RandomCase>
* CPAN Ratings
<http://cpanratings.perl.org/d/Text-Pipe-RandomCase>
* Search CPAN
<http://search.cpan.org/dist/Text-Pipe-RandomCase>
LICENSE AND COPYRIGHT
Copyright 2008-2009 Mario Domgoergen.
This program is free software; you can redistribute it and/or modify it
under the terms the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any later
version.