lwp::mediatypes(3) [mojave man page]

LWP::MediaTypes(3)					User Contributed Perl Documentation					LWP::MediaTypes(3)

NAME

       LWP::MediaTypes - guess media type for a file or a URL

SYNOPSIS

	use LWP::MediaTypes qw(guess_media_type);
	$type = guess_media_type("/tmp/foo.gif");

DESCRIPTION

       This module provides functions for handling media (also known as MIME) types and encodings.  The mapping from file extensions to media
       types is defined by the media.types file.  If the ~/.media.types file exists it is used instead.  For backwards compatibility we will also
       look for ~/.mime.types.

       The following functions are exported by default:

       guess_media_type( $filename )
       guess_media_type( $uri )
       guess_media_type( $filename_or_uri, $header_to_modify )
	   This function tries to guess media type and encoding for a file or a URI.  It returns the content type, which is a string like
	   "text/html".  In array context it also returns any content encodings applied (in the order used to encode the file).  You can pass a
	   URI object reference, instead of the file name.

	   If the type can not be deduced from looking at the file name, then guess_media_type() will let the "-T" Perl operator take a look.  If
	   this works (and "-T" returns a TRUE value) then we return text/plain as the type, otherwise we return application/octet-stream as the
	   type.

	   The optional second argument should be a reference to a HTTP::Headers object or any object that implements the $obj->header method in a
	   similar way.  When it is present the values of the 'Content-Type' and 'Content-Encoding' will be set for this header.

       media_suffix( $type, ... )
	   This function will return all suffixes that can be used to denote the specified media type(s).  Wildcard types can be used.	In a
	   scalar context it will return the first suffix found. Examples:

	     @suffixes = media_suffix('image/*', 'audio/basic');
	     $suffix = media_suffix('text/html');

       The following functions are only exported by explicit request:

       add_type( $type, @exts )
	   Associate a list of file extensions with the given media type.  Example:

	       add_type("x-world/x-vrml" => qw(wrl vrml));

       add_encoding( $type, @ext )
	   Associate a list of file extensions with an encoding type.  Example:

	    add_encoding("x-gzip" => "gz");

       read_media_types( @files )
	   Parse media types files and add the type mappings found there.  Example:

	       read_media_types("conf/mime.types");

COPYRIGHT

       Copyright 1995-1999 Gisle Aas.

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

perl v5.18.2							    2012-02-16							LWP::MediaTypes(3)

Check Out this Related Man Page

URI::data(3)						User Contributed Perl Documentation					      URI::data(3)

NAME

       URI::data - URI that contain immediate data

SYNOPSIS

	use URI;

	$u = URI->new("data:");
	$u->media_type("image/gif");
	$u->data(scalar(`cat camel.gif`));
	print "$u
";
	open(XV, "|xv -") and print XV $u->data;

DESCRIPTION

       The "URI::data" class supports "URI" objects belonging to the data URI scheme.  The data URI scheme is specified in RFC 2397.  It allows
       inclusion of small data items as "immediate" data, as if it had been included externally.  Examples:

	 data:,Perl%20is%20good

	 data:image/gif;base64,R0lGODdhIAAgAIAAAAAAAPj8+CwAAAAAI
	   AAgAAAClYyPqcu9AJyCjtIKc5w5xP14xgeO2tlY3nWcajmZZdeJcG
	   Kxrmimms1KMTa1Wg8UROx4MNUq1HrycMjHT9b6xKxaFLM6VRKzI+p
	   KS9XtXpcbdun6uWVxJXA8pNPkdkkxhxc21LZHFOgD2KMoQXa2KMWI
	   JtnE2KizVUkYJVZZ1nczBxXlFopZBtoJ2diXGdNUymmJdFMAADs=

       "URI" objects belonging to the data scheme support the common methods (described in URI) and the following two scheme specific methods:

       $uri->media_type( [$new_media_type] )
	   This method can be used to get or set the media type specified in the URI.  If no media type is specified, then the default
	   "text/plain;charset=US-ASCII" is returned.

       $uri->data( [$new_data] )
	   This method can be used to get or set the data contained in the URI.  The data is passed unescaped (in binary form).  The decision
	   about whether to base64 encode the data in the URI is taken automatically based on what encoding produces the shortest URI string.

SEE ALSO

       URI

COPYRIGHT

       Copyright 1995-1998 Gisle Aas.

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

perl v5.8.0							    1999-03-20							      URI::data(3)

Linux and UNIX Man Pages

lwp::mediatypes(3) [mojave man page]

Check Out this Related Man Page