HTTP::Headers::Util - Header value parsing utility
       functions

SYNOPSIS

         use HTTP::Headers::Util qw(split_header_words);
         @values = split_header_words($h->header("Content-Type"));

DESCRIPTION

       This module provide a few functions that helps parsing and
       construction of valid header values.  None of the
       functions are exported by default.

       The following functions are provided:

       split_header_words( @header_values )
           This function will split the header values given as
           argument into a list of anonymous arrays containing
           key/value pairs.  The function know how to deal with
           ",", ";" and "=" as well as quoted values.  Multiple
           values are treated as if they were separated by comma.

           This is easier to describe with an example:

              split_header_words('foo="bar"; port="80,81"; discard, bar=baz')
              split_header_words('text/html; charset="iso-8859-1");

           will return

              [foo=>'bar', port=>'80,81', discard=> undef], [bar=>'baz' ]
              ['text/html' => undef, charset => 'iso-8859-1']


       join_header_words( @arrays )
           This will do the opposite convertion of what
           split_header_words() does.  It takes a list of
           anonymous arrays as argument and produce a single
           header value.  Attribute values are quoted if needed.
           Example:

              join_header_words(["text/plain" => undef, charset => "iso-8859/1"]);

COPYRIGHT

       Copyright 1997, Gisle Aas

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