Bing::Search::Response - A response object for the Bing AJAX Api
my $resulsts = $search->search(); my $array_ref = $response->results;
This object contains the results from a search. Or something telling you why things went horribly wrong. It should be noted that this does not tell you if your request failed at some LWP-style failure -- for that, check the request_obj of your Bing::Search object.
request_obj
Responses are generally a read-only ordeal. You may change the values here in these various methods, if it makes you feel better. Nothing will try to stop you. Won't do much, though.
Version
Contains the Bing API version.
Query
The query sent to Bing. Use this for verification.
AlterationOverride
If the query sent to Bing is "fixed" automatically by Bing, this string will allow you to re-submit the query "as-is". The example from the Bing documentation:
For example, if the original query is microsift offic, then AlterationOverrideQuery would be +microsift +offic
results
This is the biggie. This is an arrayref of the Bing::Search::Result objects. This is what you want to fiddle with.
Total
This is the total number of results generated by your search(es). If you have more than one source, these results are summed together.
If you need access to the individual source's counts, you may access it in the data hashref (see below) with {SearchResponse}->{source name}->{Total}, where the source name is "Web" or "Video" or so forth and so on.
data
A hashref, it initially contains the deparsed JSON structure. As objects are populated, it is depopulated. Anything left over is something Bing sent but was, for some reason, not handled. In a perfect world, by the time you're able to do anything, this should be empty. You probably don't want to fiddle with it.
_parse
Don't mess with this. It's what turns data into objects. Seriously. Just leave it alone.
Probably. Patches welcome.
Bing::Search
Dave Houston, " dhouston@cpan.org ", 2010
This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.
1 POD Error
The following errors were encountered while parsing the POD:
L<> starts or ends with whitespace
To install Bing::Search, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Bing::Search
CPAN shell
perl -MCPAN -e shell install Bing::Search
For more information on module installation, please visit the detailed CPAN module installation guide.