The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

String::MFN - Normalize a string to produce a sane Unix filename

VERSION

Version 1.29

SYNOPSIS

    use String::MFN;

    my $clean = mfn($dirty);

DESCRIPTION

String::MFN exports a single function, mfn(), which modifies a string to resemble a sane Unix filename.

In a nutshell, this means lowercasing everything and either getting rid of "funny" characters or replacing them with sane equivalents which allow the string to maintain some structure. See the test suite for a battery of examples.

FUNCTIONS

mfn

Normalizes a string. Returns the normalized string. If no argument is given, $_ is used.

TODO

  • Add "classic" ASCII-oriented function for extra strictness

  • Add track/sequence number stuff to mfn(1p)

BUGS

  • mfn() forces Perl's _is_utf8 flag on, but does not attempt to verify that the data being passed to it is valid UTF-8.

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.

AUTHOR

Shawn Boyette, <mdxi@cpan.org>

COPYRIGHT & LICENSE

Copyright 2003-2007 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.