Text::Hyphen - determine positions for hyphens inside words
This module implements Knuth-Liang algorithm to find positions inside words where it is possible to insert hyphens to break a line.
use Text::Hyphen; my $hyphenator = new Text::Hyphen; print $hyphenator->hyphenate('representation'); # prints rep-re-sen-ta-tion
This version does not export anything and uses OOP interface. This will probably change.
XXX employ a singleton to provide functional interface
Creates the hyphenator object.
You can pass several options:
Minimum length of word to be hyphenated. Shorter words are returned right away. Defaults to 5 for English.
Minimal prefix to leave without any hyphens. Defaults to 2 for English.
Minimal suffix to leave wothout any hyphens. Defaults to 2 for English.
$word by inserting
$delim into hyphen positions.
$delim defaults to dash ("-").
<kappa at cpan.org>
Please report any bugs or feature requests to
bug-text-hyphen at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-Hyphen. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
Donald Knuth and Frank Liang for the algorithm.
Alexander Lebedev for all his valuable work on russian ispell dictionaries and russian hyphenation patterns. See his archive at ftp://scon155.phys.msu.ru/pub/russian/.
Ned Batchelder for his public domain Python implementation of Knuth-Liang algorithm available at http://nedbatchelder.com/code/modules/hyphenate.html.
Copyright 2008 Alex Kapranoff.
This program is released under the following license: BSD.