debian man page for www::opensearch::response

WWW::OpenSearch::Response(3pm)				User Contributed Perl Documentation			    WWW::OpenSearch::Response(3pm)

NAME
       WWW::OpenSearch::Response - Encapsulate a response received from an A9 OpenSearch compatible engine

SYNOPSIS
	   use WWW::OpenSearch;

	   my $url = "http://bulkfeeds.net/opensearch.xml";
	   my $engine = WWW::OpenSearch->new($url);

	   # Retrieve page 4 of search results for "iPod"
	   my $response = $engine->search("iPod",{ startPage => 4 });
	   for my $item (@{$response->feed->items}) {
	       print $item->{description};
	   }

	   # Retrieve page 3 of results
	   $response = $response->previous_page;

	   # Retrieve page 5 of results
	   $response = $response->next_page;

DESCRIPTION
       WWW::OpenSearch::Response is a module designed to encapsulate a response received from an A9 OpenSearch compatible engine.  See
       http://opensearch.a9.com/spec/1.1/response/ for details.

CONSTRUCTOR
   new( $response )
       Constructs a new instance of WWW::OpenSearch::Response from the WWWW::OpenSearch:Response returned by the search request.

METHODS
   parse_response( )
       Parses the content of the HTTP response using XML::Feed. If successful, parse_feed( ) is also called.

   parse_feed( )
       Parses the XML::Feed originally parsed from the HTTP response content.  Sets the pager object appropriately.

   previous_page( ) / next_page( )
       Performs another search on the parent object, returning a WWW::OpenSearch::Response instance containing the previous/next page of results.
       If the current response includes a <link rel="previous/next" href="..." /> tag, the page will simply be the parsed content of the URL
       specified by the tag's href attribute. However, if the current response does not include the appropriate link, a new query is constructed
       using the startPage or startIndex query arguments.

   _get_link( $type )
       Gets the href attribute of the first link whose rel attribute is equal to $type.

ACCESSORS
   feed( )
   pager( )
AUTHOR
       o   Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       o   Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE
       Copyright 2005-2010 by Tatsuhiko Miyagawa and Brian Cassidy

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2010-05-25					    WWW::OpenSearch::Response(3pm)