This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# `email.iterators`: Iterators

Вихідний код: Lib/email/iterators.py

Ітерація дерева об’єктів повідомлення досить проста за допомогою методу `Message.walk`. Модуль `email.iterators` забезпечує деякі корисні ітерації вищого рівня над деревами об’єктів повідомлень.

`email.iterators.``body_line_iterator`(msg, decode=False)

  Це повторює всі корисні навантаження в усіх підчастинах msg, повертаючи рядкові корисні навантаження рядок за рядком. Він пропускає всі заголовки підчастини, а також пропускає будь-яку підчастину з корисним навантаженням, яке не є рядком Python. Це дещо еквівалентно читанню простого текстового представлення повідомлення з файлу за допомогою `readline()`, пропускаючи всі проміжні заголовки.

  Додаткове decode передається до `Message.get_payload`.

`email.iterators.``typed_subpart_iterator`(msg, maintype='text', subtype=None)

  Це повторює всі підчастини msg, повертаючи лише ті підчастини, які відповідають типу MIME, визначеному maintype і subtype.

  Зауважте, що підтип необов’язковий; якщо опущено, то зіставлення типу MIME підрозділу виконується лише з основним типом. maintype також необов’язковий; за замовчуванням text.

  Таким чином, за замовчуванням `typed_subpart_iterator()` повертає кожну підчастину, яка має тип MIME text/*.

Наведену нижче функцію було додано як корисний інструмент налагодження. Його не слід вважати частиною підтримуваного загальнодоступного інтерфейсу пакета.

`email.iterators.``_structure`(msg, fp=None, level=0, include_default=False)

  Друкує представлення типів вмісту структури об’єкта повідомлення з відступом. Наприклад:

      >>> 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

  Необов’язковий fp — це файлоподібний об’єкт, у який потрібно надрукувати вихідні дані. Він має відповідати функції `print()` Python. level використовується внутрішньо. include_default, якщо true, також друкує тип за замовчуванням.