18.1.10. email.iterators
: 迭代器¶
通过 Message.walk
方法来迭代消息对象树是相当容易的。 email.iterators
模块提供了一些适用于消息对象树的高层级迭代器。
-
email.iterators.
body_line_iterator
(msg[, decode])¶ 此对象会迭代 msg 的所有子部分中的所有载荷,逐行返回字符串载荷。 它会跳过所有子部分的标头,并且它也会跳过任何包含不为 Python 字符串的载荷的子部分。 这基本上等价于使用
readline()
从一个文件读取消息的纯文本表示形式,并跳过所有中间的标头。可选的 decode 会被传递给
Message.get_payload
。
-
email.iterators.
typed_subpart_iterator
(msg[, maintype[, subtype]])¶ 此函数会迭代 msg 的所有子部分,只返回其中与 maintype 和 subtype 所指定的 MIME 类型相匹配的子部分。
请注意 subtype 是可选项;如果省略,则仅使用主类型来进行子部分 MIME 类型的匹配。 maintype 也是可选项;它的默认值为 text。
因此,在默认情况下
typed_subpart_iterator()
会返回每一个 MIME 类型为 text/* 的子部分。
增加了以下函数作为有用的调试工具。 它 不应当 被视为该包所支持的公共接口的组成部分。
-
email.iterators.
_structure
(msg[, fp[, level]])¶ Prints an indented representation of the content types of the message object structure. For example:
>>> msg = email.message_from_file(somefile) >>> _structure(msg) multipart/mixed text/plain text/plain multipart/digest message/rfc822 text/plain message/rfc822 text/plain message/rfc822 text/plain message/rfc822 text/plain message/rfc822 text/plain text/plain
Optional fp is a file-like object to print the output to. It must be suitable for Python’s extended print statement. level is used internally.