Comma

Cro::MediaType

The Cro::MediaType class provides a range of functionality relating to media types, including parsing them into their parts or serializing them from their parts.

Parsing a media type§

To parse a media type, pass it to the parse method:

my $media-type = Cro::MediaType.parse('content/html; charset=UTF-8');

This results a Cro::MediaType instance.

Extracting parts of the media type§

Consider an example media type application/vnd.foobar+json; charset=UTF-8. The following methods are available for extracting parts of the media type:

  • type - returns application
  • subtype - returns vnd.foobar+json
  • tree - returns vnd
  • subtype-name - returns foobar
  • suffix - returns json
  • type-and-subtype - returns application/vnd.foobar+json
  • parameters - returns an Array containing a Pair; in the example given, charset => 'UTF-8'

Constructing a media type from parts§

The new method can be called to construct a media type from its parts. The type and subtype-name named parameters are required; tree, suffix, and parameters may be optionally provided.

Serializing a media type§

Stringify a Cro::MediaType object to turn it into a string representation of the media type.

my $media-type = Cro::MediaType.new:
    type => 'application',
    tree => 'vnd',
    subtype-name => 'foobar',
    suffix => 'json',
    parameters => [charset => 'UTF-8'];

say ~$media-type;   # application/vnd.foobar+json; charset=UTF-8