NAME<\/a> MIME::Field::ParamVal \u2212 subclass of Mail::Field, for structured MIME fields<\/p>\n # Create an object for a content\u2212type field: This is an abstract superclass of most MIME<\/small> fields. It handles fields with a general syntax like this:<\/p>\n Content\u2212Type: Message\/Partial; Comments are supported between<\/i> items, like this:<\/p>\n Content\u2212Type: Message\/Partial; (a comment) set [%PARAMHASH | KEY=> VAL,…<\/small> ,KEY=> VAL<\/small> ]<\/p>\n Instance method.<\/i> Set this field. The paramhash should contain parameter names in all lowercase<\/i>, with the special “_” parameter name signifying the “default” (unnamed) parameter for the field:<\/p>\n # Set up to be… Note that a single argument is taken to be a reference<\/i> to a paramhash, while multiple args are taken to be the elements of the paramhash themselves.<\/p>\n Supplying undef for a hashref, or an empty set of values, effectively clears the object.<\/p>\n The self object is returned.<\/p>\n parse_params STRING<\/small><\/p>\n Class\/instance utility method.<\/i> Extract parameter info from a structured field, and return it as a hash reference. For example, here is a field with parameters:<\/p>\n Content\u2212Type: Message\/Partial; Here is how you\u2019d extract them:<\/p>\n $params = $class\u2212>parse_params(‘content\u2212type’); Like field names, parameter names are coerced to lowercase. The special \u2019_\u2019 parameter means the default parameter for the field.<\/p>\n NOTE:<\/small><\/b> This has been provided as a public method to support backwards compatibility, but you probably shouldn\u2019t use it.<\/p>\n parse STRING<\/small><\/p>\n Class\/instance method.<\/i> Parse the string into the instance. Any previous information is wiped. The self object is returned.<\/p>\n May also be used as a constructor.<\/p>\n param PARAMNAME<\/small> ,[ VALUE<\/small> ]<\/p>\n Instance method.<\/i> Return the given parameter, or undef if it isn\u2019t there. With argument, set the parameter to that VALUE.<\/small> The PARAMNAME<\/small> is case-insensitive. A “_” refers to the “default” parameter.<\/p>\n paramstr PARAMNAME<\/small> ,[ VALUE<\/small> ]<\/p>\n Instance method.<\/i> Like param()<\/b>: return the given parameter, or empty<\/i> if it isn\u2019t there. With argument, set the parameter to that VALUE.<\/small> The PARAMNAME<\/small> is case-insensitive. A “_” refers to the “default” parameter.<\/p>\n stringify<\/p>\n Instance method.<\/i> Convert the field to a string, and return it.<\/p>\n tag<\/p>\n<\/td>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
PUBLIC INTERFACE<\/a>
SEE ALSO<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
$field = new Mail::Field ‘Content\u2212type’;
# Set some attributes:
$field\u2212>param(‘_’ => ‘text\/html’);
$field\u2212>param(‘charset’ => ‘us\u2212ascii’);
$field\u2212>param(‘boundary’ => ‘\u2212\u2212\u2212ABC\u2212\u2212\u2212’);
# Same:
$field\u2212>set(‘_’ => ‘text\/html’,
‘charset’ => ‘us\u2212ascii’,
‘boundary’ => ‘\u2212\u2212\u2212ABC\u2212\u2212\u2212’);
# Get an attribute, or undefined if not present:
print “no id!” if defined($field\u2212>param(‘id’));
# Same, but use empty string for missing values:
print “no id!” if ($field\u2212>paramstr(‘id’) eq ”);
# Output as string:
print $field\u2212>stringify, “n”;<\/p>\nDESCRIPTION <\/a> <\/h2>\n
number=2; total=3;
id=”oc=jpbe0M2Yt4s@thumper.bellcore.com”<\/p>\n
number=2 (another comment) ; (yet another comment) total=3;
id=”oc=jpbe0M2Yt4s@thumper.bellcore.com”<\/p>\nPUBLIC INTERFACE <\/a> <\/h2>\n
#
# Content\u2212type: Message\/Partial; number=2; total=3; id=”ocj=pbe0M2″
#
$conttype\u2212>set(‘_’ => ‘Message\/Partial’,
‘number’ => 2,
‘total’ => 3,
‘id’ => “ocj=pbe0M2”);<\/p>\n
number=2; total=3;
id=”oc=jpbe0M2Yt4s@thumper.bellcore.com”<\/p>\n
if ($$params{‘_’} eq ‘message\/partial’) {
$number = $$params{‘number’};
$total = $$params{‘total’};
$id = $$params{‘id’};
}<\/p>\n\n
\n <\/td>\n \n <\/td>\n \n