Text::Filter::URI - Filter a string to meet URI requirements
Use either the exported function or the OO interface:
use Text::Filter::URI qw( filter_uri );
my $uri = filter_uri("A text which needs to be filtered ");
# $uri = "a-text-which-needs-to-be-filtered"
my $f = Text::Filter::URI->new(input => $input, output => $output);
$f->filter;
See Text::Filter for details on $input and $output.
This method can be exported using use Text::Filter::URI qw( filter_uri );
It expects a string or an array of strings and returns the filtered strings accordingly.
These methods are used for the OO interface. This allows you to use the full power of Text::Filter.
The constructor new takes a hash for configuration. See "CONSTRUCTOR" in Text::Filter for more information on these settings.
There is one additional parameter:
Define an individual string for separating the words. Defaults to -.
Call this method after calling new to actually filter the $input.
Unicode characters get encoded to their ascii equivalents using the Text::Unidecode. This module maps characters like ä to the ascii character a. This method contains several regular expressions which convert every not word character (\W) and the underscore to a blank. Blanks at the beginning and the end are removed. All remaining blanks are replaced by the separator (defaults to -). Then it creates a lowercased version of the string.
Moritz Onken, <onken at houseofdesign.de>
Please report any bugs or feature requests to bug-text-filter-uri at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-Filter-URI. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
Copyright 2008 Moritz Onken, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
