NAME
String::MFN - 'Normalize' a string in the manner of the mfn utility
VERSION
Version 1.17
SYNOPSIS
use String::MFN;
my $sane_string = mfn($retarded_string);
...DESCRIPTION
This module provides an mechanism for normalizing a string in the same manner filenames are by the utility mfn (the Moronic Filename Normalizer).
Normalization, in brief, means converting the string to something which resembles a sane UNIX filename containing no special characters, while attempting to maintain information carried by the original formatting.
Normalization, in specific, consists of characters other than [A-Za-z0-9_-.+] being removed, lowercasing of all letters, separation of internaCaps, separation of leading numerals from trailing non-numerals, replacement of "bracketing" characters ({[(<>)]}), replacement of ampersands, and collapsing (things that look like) repeating extentions.
Some concrete examples (filenames found by googling for "mp3 playlist"):
Eurodance - DMA dance (Doop by Doop).mp3
eurodance-dma_dance-doop_by_doop.mp3
Faithless [Trance House I] - Insomnia (Monstermix).mp3
faithless-trance_house_i-insomnia-monstermix.mp3
Frank Sinatra & Count Basie - More.mp3
frank_sinatra_and_count_basie-more.mp3
Cornershop - Heavy Soup [Outro] [*] [*].mp3
cornershop-heavy_soup-outro.mp3
Soundtrack - American Pie 2\05 - Uncle Kracker - (Im Gonna) Split This Room In Half.mp3
soundtrack-american_pie_205-uncle_kracker-im_gonna-split_this_room_in_half.mp3FUNCTIONS
mfn
Applies normalization routines to a string. Returns the normalized string. If no argument is explicitly specified, mfn operates on $_.
AUTHOR
Shawn Boyette, <mdxi@cpan.org>
BUGS
None known.
Please report any bugs or feature requests to bug-string-mfn@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
COPYRIGHT & LICENSE
Copyright 2004 Shawn Boyette, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.