mimeReader data type parses messages, and is the first type
encountered when using the API. It is created by opening a file or
string containing a message, or by "opening" a
object (since MIME messages can recurse). A
parses the MIME message as a stream, internally maintaining a
current-entity cursor, and there are functions to iterate over all the
entities in a message.
mimeReader object usually has a current entity it
points to in the message, the
mimeEntity access functions for
obtaining headers, body etc. also work on
mimeReader objects as
a convenience, to avoid having to first get a
from the reader.