Provides a framework for registering and retrieving decoder classes for RFC 822 message parts.

TIdMessageDecoderList = class(TObject)

TIdMessageDecoderList is a TObject descendant that provides a framework for registering and retrieving decoder classes for RFC 822-compliant message parts.

All methods in TIdMessageDecoderList, except the Constructor and Destructor, are class methods that provide for registering a new decoder class, accessing a decoder by name, and determining when a decoder is appropriate for use on a given message part.

Locates an instance of a registered decoder class by name.

class function ByName(const AName: string): TIdMessageDecoderInfo;

Decoder class name to be located.

TIdMessageDecoderInfo - Container that holds information and class type for the registered decoder class.

ByName is a TIdMessageDecoderInfo class function used to locate an instance of a registered decoder class by the name specified in AName. ByName searches the global list of registerd decoder classes to locate an instance with a name matching AName.

If there is no registered decoder class with a name matching AName, an EIdException is raised with the constant message RSMessageDecoderNotFound and the value in AName.

Determines the registered decoder class instance to be used for an RFC 822 message part.

class function CheckForStart(ASender: TIdMessage; const ALine: string): TIdMessageDecoder;

Message to be associated with the decoder class instance.

Text to be examined to determine the decoder needed for the message part.

TIdMessageDecoder - Decoder class instance for the message part.

CheckForStart is a TIdMessageDecoder class function in TIdMessageDecoderList that determines the registered decoder class instance to be used for an RFC 822 message part.

CheckForStart examines the list of registered decoder classes, and calls the TIdMessageDecoderInfo.CheckForStart method for each instance. When a decoder class is found for the message part, the method exits and returns the TIdMessageDecoderInfo instance for the message part. If no decoder class is located for the message part, the return value for CheckForStart is Nil.

Constructor for the object instance.

constructor Create;

Create is the Constructor for the object instance, and relies on the inherited Create method. Create also initializes an internal list used to identify and retrieve registered message decoder class instances.

Destructor for the object instance.

destructor Destroy; override;

Destroy is the Destructor for the object instance. Destroy iterates over a list of the registered decoder class instances, and frees each TIdMessageDecoderInfo instance. When all registered decoder class instances have been freed, Destroy also frees the list. Finally, Destroy calls the inherited Destroy method.

Adds a decoder class to the list of registered decoder classes.

class procedure RegisterDecoder(const AMessageCoderName: string; AMessageCoderInfo: TIdMessageDecoderInfo);

Name to used for identification of the registered decoder class.

Decoder class information to be registered.

RegisterDecoder is a class procedure in TIdMessageDecoderList that adds information about decoder classes for RFC message parts to the list of registered decoder classes.

RegisterDecoder checks to make sure that the list for registered decoder classes has been initalized to an instance of TIdMessageDecoderList. RegisterDecoder then adds the decoder information in AMessageCoderInfo to the list with the name specified in AMessageCoderName.

RegisterDecoder is called in the initialization section of the unit that contains the decoder class, like IdMessageCoderMIME.pas, IdMessageCoderUUE.pas, and IdMessageCoderXXE.pas.