NAME¶
WWW::Search::AltaVista - class for searching www.altavista.com
SYNOPSIS¶
require WWW::Search;
$search = new WWW::Search('AltaVista');
DESCRIPTION¶
This class is an AltaVista specialization of WWW::Search. It handles making and
interpreting AltaVista searches
http://www.altavista.com.
This class exports no public interface; all interaction should be done through
WWW::Search objects.
OPTIONS¶
The default is "any of these words" (OR of query terms).
- aqa=all+of+these+words
- Add the AND of these words to the query.
- aqp=this+exact+phrase
- Add "this exact phrase" to the query.
- aqo=any+of+these+words
- Add the OR of these words to the query. This is where the
query is placed by default.
- aqn=none+of+these+words
- Add NOT these words to the query.
- aqb=(boolean+AND+expression)+NEAR+entry
- Add a boolean expression to the query. Operators are AND,
OR, AND NOT, and NEAR. In the browser interface, the boolean expression
can not be combined with any other query types listed above. You should
probably build the boolean expression with parentheses and spaces and
urlescape it.
- aqs=these+words
- Pages containing "these words" will be ranked
highest.
- kgs=[0,1]
- To restrict the search to U.S. websites, set kgs=1. The
default is world-wide, kgs=0.
- kls=[0,1]
- To restrict the search to pages in English and Spanish, set
kls=1. The default is no language restrictions, kls=0.
- filetype=[html,pdf]
- To restrict the search to HTML pages only, set
filetype=html. To restrict the search to PDF pages only, set filetype=pdf.
The default is no restriction on page type, filetype=.
- rc=dmn&swd=net+org+or.jp
- To restrict the search to pages from certain domains, set
rc=dmn and set swd to a list of desired toplevel domains.
- rc=url&lh=www.sandcrawler.com/SWB
- To restrict the search to pages from a particular site, set
rc=url and set lh to the site name and path. Leave off the http:// from
the site.
PUBLIC METHODS¶
gui_query¶
Call this instead of
native_query() if you want to get the same results
as your average Joe web surfer.
PRIVATE METHODS¶
native_setup_search¶
This private method does the heavy lifting after you call
native_query()
or
gui_query().
parse_tree¶
This private method does the hard work of parsing the results out of the HTML.
BUGS¶
- Not all of the above options have been tested.
- Please report bugs and send feature requests via email to
"bug-WWW-Search-AltaVista@rt.cpan.org", or via the web interface
at https://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Search-AltaVista
<https://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Search-AltaVista>.
SEE ALSO¶
To make new back-ends, see WWW::Search, or the specialized AltaVista searches
described in options.
AUTHOR¶
Written by John Heidemann, "johnh@isi.edu"; maintained by Martin
Thurn, "mthurn@cpan.org".
LICENSE¶
This software is released under the same license as Perl itself.
COPYRIGHT¶
Copyright (c) 1996-1998 University of Southern California. All rights reserved.
Redistribution and use in source and binary forms are permitted provided that
the above copyright notice and this paragraph are duplicated in all such forms
and that any documentation, advertising materials, and other materials related
to such distribution and use acknowledge that the software was developed by
the University of Southern California, Information Sciences Institute. The
name of the University may not be used to endorse or promote products derived
from this software without specific prior written permission.
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.