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

NAME

       WWW::OpenSearch::Description - Encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine

SYNOPSIS

	   use WWW::OpenSearch;

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

	   my $format	= $description->Format;   # or $description->format
	   my $longname = $description->LongName; # or $description->longname

DESCRIPTION

       WWW::OpenSearch::Description is a module designed to encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine.
       See http://opensearch.a9.com/spec/1.1/description/ for details.

CONSTRUCTOR

   new( [ $xml ] )
       Constructs a new instance of WWW::OpenSearch::Description. If scalar parameter $xml is provided, data will be automatically loaded from it
       using load( $xml ).

METHODS

   load( $xml )
       Loads description data by parsing provided argument using XML::LibXML.

   urls( )
       Return all of the urls associated with this description in an array.

   get_best_url( )
       Attempts to retrieve the best URL associated with this description, based on the following content types (from most preferred to least
       preferred):

       o   application/atom+xml

       o   application/rss+xml

       o   text/xml

   get_url_by_type( $type )
       Retrieves the first WWW::OpenSearch::URL associated with this description whose type is equal to $type.

ACCESSORS

   version( )
   ns( )
   AdultContent( )
   Attribution( )
   Contact( )
   Description( )
   Developer( )
   Format( )
   InputEncoding( )
   Image( )
   Language( )
   LongName( )
   OutputEncoding( )
   Query( )
   SampleSearch( )
   ShortName( )
   SyndicationRight( )
   Tags( )
   Url( )
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::Description(3pm)