version 1.11.3 Yahoo::Search::Request -- Container object for a Yahoo! Search request. (This package is included in, and automatically loaded by, the Yahoo::Search package.)
You never need to use this package directly -- it is loaded automatically by Yahoo::Search.
use
In practice, this class is generally not dealt with explicitly, but rather implicitly via functions in Yahoo::Search such as Query and Links, which build and use a Request object under the hood.
Query
Links
Request
You also have access to the Request object via Request() method of resulting Response and Result objects.
Request()
Response
Result
To be clear, Request objects are created by the Request() method of a Search Engine object (Yahoo::Search).
A Request object provides the following methods:
Returns the URI::http object representing the url fetched (or to be fetched) from Yahoo's Search servers. The url is actually fetched when the Request object's Fetch() method is called.
Fetch()
Note that this does not reflect the fact that a request is changed to a POST when request is sufficiently large. Thus, there are times when the url represented by the URI::http object returned is not actually fetchable from the Yahoo! servers.
Like the Uri method, but returns a string with the full url fetched (or to be fetched).
Uri
Note that this does not reflect the fact that a request is changed to a POST when request is sufficiently large. Thus, there are times when the url returned is not actually fetchable from the Yahoo! servers.
Returns the search space the request represents (Doc, Image, etc.)
Returns the Yahoo::Search "search engine" object used in creating this request.
Actually contact the Yahoo Search servers, returning a Result (Yahoo::Search::Result) object.
Perform a Related request for search terms related to the query phrase of the current request, returning the new Request or Response object, respectively.
Both return nothing if the current request is already for a Related search.
Perform a Spell request for a search term that may reflect proper spelling of the query phrase of the current request, returning the new Request or Response object, respectively.
Both return nothing if the current request is already for a Spell search.
Jeffrey Friedl (jfriedl@yahoo.com)
To install Yahoo::Search, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Yahoo::Search
CPAN shell
perl -MCPAN -e shell install Yahoo::Search
For more information on module installation, please visit the detailed CPAN module installation guide.