man WWW::Search::Yahoo () - class for searching Yahoo

NAME

WWW::Search::Yahoo - class for searching Yahoo

SYNOPSIS

  use WWW::Search;
  my $oSearch = new WWW::Search('Yahoo');
  my $sQuery = WWW::Search::escape_query("sushi restaurant Columbus Ohio");
  $oSearch->native_query($sQuery);
  while (my $oResult = $oSearch->next_result())
    print $oResult->url, "\n";

DESCRIPTION

This 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.

NOTES

The default search is: Yahoo's Inktomi-based index (not usenet).

The default search is the OR of all query terms (not AND). If you want the AND of all the query terms, add {'za' => 'and'} to the second argument to native_query. If you want to search the query as a phrase, add {'za' => 'phrase'} to the second argument to native_query. If you want to search the query as Yahoo's intelligent default (whatever that means), add {'za' => 'default'} to the second argument to native_query.

SEE ALSO

To make new back-ends, see WWW::Search.

BUGS

Please tell the maintainer if you find any!

TESTING

This module adheres to the CWWWW::Search test suite mechanism.

AUTHOR

As of 1998-02-02, CWWWW::Search::Yahoo is maintained by Martin Thurn (mthurn@cpan.org).

CWWWW::Search::Yahoo was originally written by Wm. L. Scheding, based on CWWWW::Search::AltaVista.

LEGALESE

THIS 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.

VERSION HISTORY

If it''s not listed here, then it wasn''t a meaningful nor released revision.

2.27, 2002-10-31

new URL; tweak parser for new webpage format

2.24, 2001-12-24

fix for slightly changed output format

2.23, 2001-07-16

even better support for subclassing

2.22, 2001-03-31

added support for subclassing, for regional Yahoo sites

2.21, 2000-12-15

clean up URL parsing (yahoo.com added text to it)

2.19, 2000-11-10

rewrote parser using HTML::TreeBuilder

2.18, 2000-10-02

fixed parsing again.

2.17, 2000-09-22

fix description parsing and URL parsing

2.16, 2000-09-19

fix gui-style results parsing & new URL

2.15, 2000-09-14

fix result-count parsing

2.14, 2000-07-05

output format changed (thanks to Bin Yu for fixes)

2.11, 2000-04-27

new URL for gui_query

2.09, 2000-03-27

fixed for new CGI options

2.07, 2000-02-04

Added gui_query() function

2.06, 1999-11-22

Added support for Yahoo Korea.

2.04, 1999-10-11

fixed parser

2.03, 1999-10-05

now uses hash_to_cgi_string()

2.02, 1999-09-29

update test cases; add caveat about repeated URLs

2.01, 1999-07-13

version number alignment with new WWW::Search; new test mechanism

1.12, 1998-10-22

BUG FIX: now captures citation descriptions; BUG FIX: next page of results was often wrong or missing!

1.11, 1998-10-09

Now uses split_lines function

1.5

Fixed bug where next page tag was always missed. Fixed the maximum_to_retrieve off-by-one problem. Updated test cases.