my $oSearch = new WWW::Search('Yahoo');
my $sQuery = WWW::Search::escape_query("sushi restaurant Columbus Ohio");
while (my $oResult = $oSearch->next_result())
print $oResult->url, "\n";
DESCRIPTIONThis class is a Yahoo specialization of WWW::Search. It handles making and interpreting Yahoo searches http://www.yahoo.com.
This class exports no public interface; all interaction should be done through WWW::Search objects.
NOTESThe default search is: Yahoo's web-based index (not Directory).
PRIVATE METHODSIf you just want to write Perl code to search Yahoo, you do NOT need to read any further here. Instead, just read the WWW::Search documentation.
If you want to write a subclass of this module (e.g. create a backend for another branch of Yahoo) then please read about the private methods here:
gui_queryYes, Virginia, we do try to emulate stupid-human queries.
need_to_delayThis method tells the WWW::Search controller code whether we need to pause and give the yahoo.com servers a breather.
user_agent_delayThis method tells the WWW::Search controller code how many seconds we should pause.
preprocess_results_pageClean up the Yahoo HTML before we attempt to parse it.
_result_list_tagsReturns a list, which will be passed as arguments to HTML::Element::look_down() in order to return a list of HTML::Element which contain the query results.
_result_list_itemsGiven an HTML::TreeBuilder tree, returns a list of HTML::Element, which contain the query results.
parse_detailsGiven a (portion of an) HTML::TreeBuilder tree and a WWW::SearchResult object, parses one result out of the tree and populates the SearchResult.
_where_to_find_countReturns a list, which will be passed as arguments to HTML::Element::look_down() in order to return an HTML::Element which contains the approximate result count.
_string_has_countGiven a string, returns the approximate result count if that string contains the approximate result count.
_a_is_next_linkGiven an HTML::Element, returns true if it seems to contain the clickable ``next page'' widget.
stripGiven a string, strips leading and trailing whitespace off of it.
BUGSPlease tell the maintainer if you find any!
AUTHORAs of 1998-02-02, "WWW::Search::Yahoo" is maintained by Martin Thurn ([email protected]).
"WWW::Search::Yahoo" was originally written by Wm. L. Scheding, based on "WWW::Search::AltaVista".
LEGALESETHIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
LICENSECopyright (C) 1998-2009 Martin 'Kingpin' Thurn
This software is released under the same license as Perl itself.