NAME

String::MFN - 'Normalize' a string in the manner of the mfn utility

VERSION

Version 1.11

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, replaecment of "bracketing" characters ({[(<>)]}), replacement of ampersands, and collapsing (things that look like) repeating extentions.

FUNCTIONS

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.