{
    "mode": "perldoc",
    "parameter": "Mail::Message::Convert",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMessage%3A%3AConvert/json",
    "generated": "2026-06-09T19:43:26Z",
    "synopsis": "Available methods are very converter-specific.",
    "sections": {
        "NAME": {
            "content": "Mail::Message::Convert - conversions between message types\n",
            "subsections": []
        },
        "INHERITANCE": {
            "content": "Mail::Message::Convert\nis a Mail::Reporter\n\nMail::Message::Convert is extended by\nMail::Message::Convert::EmailSimple\nMail::Message::Convert::Html\nMail::Message::Convert::HtmlFormatPS\nMail::Message::Convert::HtmlFormatText\nMail::Message::Convert::MailInternet\nMail::Message::Convert::MimeEntity\nMail::Message::Convert::TextAutoformat\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "Available methods are very converter-specific.\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This class is the base for various message (and message parts) converters.\n\nExtends \"DESCRIPTION\" in Mail::Reporter.\n",
            "subsections": [
                {
                    "name": "Converters between message objects",
                    "content": "Internally, the Mail::Message::coerce() is called when foreign objects are used where message\nobjects are expected. That method will automatically create the converting objects, and re-use\nthem.\n\n*   Mail::Message::Convert::MailInternet\n\nConverts the simple Mail::Internet messages into Mail::Message objects.\n\n*   Mail::Message::Convert::MimeEntity\n\nConverts the more complicated MIME::Entity messages into Mail::Message objects.\n\n*   Mail::Message::Convert::EmailSimple\n\nConverts Email::Simple messages into Mail::Message objects.\n"
                },
                {
                    "name": "Other converters",
                    "content": "*   Mail::Message::Convert::Html\n\nPlays tricks with HTML/XMHTML without help of external modules.\n\n*   Mail::Message::Convert::HtmlFormatText\n\nConverts HTML body objects to plain text objects using the HTML::FormatText module.\n\n*   Mail::Message::Convert::HtmlFormatPS\n\nConverts HTML body objects to Postscript objects using the HTML::FormatPS module.\n\n*   Mail::Message::Convert::TextAutoformat\n\nConverts a text message into text using Text::Autoformat.\n"
                }
            ]
        },
        "METHODS": {
            "content": "Extends \"METHODS\" in Mail::Reporter.\n",
            "subsections": [
                {
                    "name": "Constructors",
                    "content": "Extends \"Constructors\" in Mail::Reporter.\n\nMail::Message::Convert->new(%options)\n-Option--Defined in     --Default\nfields                   <see description>\nlog     Mail::Reporter   'WARNINGS'\ntrace   Mail::Reporter   'WARNINGS'\n\nfields => NAMES|ARRAY-OF-NAMES|REGEXS\nSelect the fields of a header which are to be handled. Other fields will not be used. The\nvalue of this option is passed to Mail::Message::Head::Complete::grepNames() whenever\nconverters feel a need for header line selection. By default, the \"To\", \"From\", \"Cc\",\n\"Bcc\", \"Date\", \"Subject\", and their \"Resent-\" counterparts will be selected. Specify an\nempty list to get all fields.\n\nlog => LEVEL\ntrace => LEVEL\n"
                },
                {
                    "name": "Converting",
                    "content": "$obj->selectedFields($head)\nReturns a list of fields to be included in the format. The list is an ordered selection of\nthe fields in the actual header, and filtered through the information as specified with\nnew(fields).\n"
                },
                {
                    "name": "Error handling",
                    "content": "Extends \"Error handling\" in Mail::Reporter.\n\n$obj->AUTOLOAD()\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->addReport($object)\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )\nMail::Message::Convert->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->errors()\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->log( [$level, [$strings]] )\nMail::Message::Convert->log( [$level, [$strings]] )\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->logPriority($level)\nMail::Message::Convert->logPriority($level)\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->logSettings()\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->notImplemented()\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->report( [$level] )\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->reportAll( [$level] )\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->trace( [$level] )\nInherited, see \"Error handling\" in Mail::Reporter\n\n$obj->warnings()\nInherited, see \"Error handling\" in Mail::Reporter\n"
                },
                {
                    "name": "Cleanup",
                    "content": "Extends \"Cleanup\" in Mail::Reporter.\n\n$obj->DESTROY()\nInherited, see \"Cleanup\" in Mail::Reporter\n"
                }
            ]
        },
        "DIAGNOSTICS": {
            "content": "Error: Package $package does not implement $method.\nFatal error: the specific package (or one of its superclasses) does not implement this\nmethod where it should. This message means that some other related classes do implement this\nmethod however the class at hand does not. Probably you should investigate this and probably\ninform the author of the package.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "This module is part of Mail-Message distribution version 3.012, built on February 11, 2022.\nWebsite: http://perl.overmeer.net/CPAN/\n",
            "subsections": []
        },
        "LICENSE": {
            "content": "Copyrights 2001-2022 by [Mark Overmeer <markov@cpan.org>]. For other contributors see ChangeLog.\n\nThis program is free software; you can redistribute it and/or modify it under the same terms as\nPerl itself. See http://dev.perl.org/licenses/\n",
            "subsections": []
        }
    },
    "summary": "Mail::Message::Convert - conversions between message types",
    "flags": [],
    "examples": [],
    "see_also": []
}