NAME

News::Pan::Server::Group::_Search - search methods for group object

DESCRIPTION

This module is inherited by News::Pan::Server::Group. This is to perform a search of a pan file for article subjects.

SYNOPSIS

   my $search = new News::Pan::Server::Group({ abs_path =>'/home/myself/.pan/astraweb/alt.binaries.sounds.mp3' });

   $search->search_add('elvis');
   $search->search_add('presley');
   $search->search_add('.mp3');
   $search->search_negative('lisa');

   $search->search_count;

   $search->search_subjects;

   $search->search_reset;

SEARCH METHODS

Calling any of the term setters starts a search. the term setters are search add and search negative methods.

search_add_exact()

argument is a string. will match case sensitive.

   $g->search_add_exact('James Mason');

search_add()

argument is a string, will split on non word chars and do insensitive inclusive match

   $g->search_add('Lisa Loeb');

matches all article subjects with lisa and loeb, in any order.

search_negative_exact()

reverse of search_add_exact()

search_negative()

reverse of search_add().

search_reset()

reset the search for a new search to be made.

search_count()

returns number of article subjects matching at present.

search_results()

returns array ref with subjects of matching articles.

SEE ALSO

News::Pan

AUTHOR

Leo Charre leocharre at cpan dot org