NAME

       HTTP::Headers::ActionPack::MediaTypeList - A Priority List customized for Media Types

VERSION

       version 0.09

SYNOPSIS

         use HTTP::Headers::ActionPack::MediaTypeList;

         # normal constructor
         my $list = HTTP::Headers::ActionPack::MediaTypeList->new(
             HTTP::Headers::ActionPack::MediaType->new('audio/*', q => 0.2 ),
             HTTP::Headers::ActionPack::MediaType->new('audio/basic', q => 1.0 )
         );

         # you can also specify the 'q'
         # rating independent of the
         # media type definition
         my $list = HTTP::Headers::ActionPack::MediaTypeList->new(
             [ 0.2 => HTTP::Headers::ActionPack::MediaType->new('audio/*', q => 0.2 )     ],
             [ 1.0 => HTTP::Headers::ActionPack::MediaType->new('audio/basic' ) ]
         );

         # or from a string
         my $list = HTTP::Headers::ActionPack::MediaTypeList->new_from_string(
             'audio/*; q=0.2, audio/basic'
         );

DESCRIPTION

       This is a subclass of the HTTP::Headers::ActionPack::PriorityList class with some specific media-type
       features. It is the default object used to parse most of the "Accept" header since they will often
       contain more then one media type.

METHODS

       "iterable"
           This  returns  the  same data type as the parent (two element ARRAY ref with quality and choice), but
           the choice element will be a HTTP::Headers::ActionPack::MediaType object. This is also  sorted  in  a
           very specific manner in order to align with RFC-2616 Sec14.

             Media ranges can be overridden by more specific
             media ranges or specific media types. If more
             than one media range applies to a given type,
             the most specific reference has precedence.

       "canonicalize_choice"
           If  this  is  passed a string, it returns a new HTTP::Headers::ActionPack::MediaType object from that
           string. If it receives an object it simply returns that object as is.

AUTHOR

       Stevan Little <stevan.little@iinteractive.com>

CONTRIBUTORS

       •   Andrew Nelson <anelson@cpan.org>

       •   Dave Rolsky <autarch@urth.org>

       •   Florian Ragwitz <rafl@debian.org>

       •   Jesse Luehrs <doy@tozt.net>

       •   Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Infinity Interactive, Inc..

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

perl v5.32.0                                       2021-01-07             HTTP::Headers::...::MediaTypeList(3pm)