NAME

       Lingua::Stem::It - Porter's stemming algorithm for Italian

SYNOPSIS

           use Lingua::Stem::It;
           my $stems = Lingua::Stem::It::stem({ -words => $word_list_reference,
                                                -locale => 'it',
                                                -exceptions => $exceptions_hash,
                                             });

           my $stem = Lingua::Stem::It::stem_word( $word );

DESCRIPTION

       This module applies the Porter Stemming Algorithm to its parameters, returning the stemmed
       words.

       The algorithm is implemented exactly (I hope :-) as described in:

           http://snowball.tartarus.org/algorithms/italian/stemmer.html

       The code is carefully crafted to work in conjunction with the Lingua::Stem module by
       Benjamin Franz, from which I've also borrowed some functionalities (caching and exception
       list).

METHODS

       stem({ -words => \@words, -locale => 'it', -exceptions => \%exceptions });
           Stems a list of passed words. Returns an anonymous list reference to the stemmed
           words.

           Example:

             my $stemmed_words = Lingua::Stem::It::stem({ -words => \@words,
                                                          -locale => 'it',
                                                          -exceptions => \%exceptions,
                                     });

       stem_word( $word );
           Stems a single word and returns the stem directly.

           Example:

             my $stem = Lingua::Stem::It::stem_word( $word );

       stem_caching({ -level => 0|1|2 });
           Sets the level of stem caching.

           '0' means 'no caching'. This is the default level.

           '1' means 'cache per run'. This caches stemming results during a single
               call to 'stem'.

           '2' means 'cache indefinitely'. This caches stemming results until
               either the process exits or the 'clear_stem_cache' method is called.

       clear_stem_cache;
           Clears the cache of stemmed words

   EXPORT
       None by default.

AUTHOR

       Aldo Calpini, dada@perl.it

SEE ALSO

        Lingua::Stem

COPYRIGHT

       Copyright (c) Aldo Calpini, dada@perl.it. All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.