Plucene::Search::HitCollector (3pm)

        # used in conjunction with the IndexSearcher

        my $searcher = Plucene::Search::IndexSearcher->new($DIRECTORY);

        my $hc = Plucene::Search::HitCollector->new( collect =>
                sub {
                        my ($self, $doc, $score) = @_;
                        ...
        });

        $searcher->search_hc($QUERY, $hc);

This is used in conjunction with the IndexSearcher, in that whenever a non-zero scoring document is found, the subref with with the HitCollector was made will get called.

new

my $hc = Plucene::Search::HitCollector->new( collect => sub { my ($self, $doc, $score) = @_; ... });

This will create a new Plucene::Search::HitCollector with the passed subref.

collect

This is called once for every non-zero scoring document, with the document number and its score.