mailbox.po

# Copyright (C) 2001-2023, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-23 07:52+0800\n"
"PO-Revision-Date: 2018-05-23 16:05+0000\n"
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/mailbox.rst:2
msgid ":mod:`!mailbox` --- Manipulate mailboxes in various formats"
msgstr ":mod:`!mailbox` --- 以各種格式操作郵件信箱"

#: ../../library/mailbox.rst:10
msgid "**Source code:** :source:`Lib/mailbox.py`"
msgstr "**原始碼：**\\ :source:`Lib/mailbox.py`"

#: ../../library/mailbox.rst:14
msgid ""
"This module defines two classes, :class:`Mailbox` and :class:`Message`, for "
"accessing and manipulating on-disk mailboxes and the messages they contain. :"
"class:`!Mailbox` offers a dictionary-like mapping from keys to messages. :"
"class:`!Message` extends the :mod:`email.message` module's :class:`~email."
"message.Message` class with format-specific state and behavior. Supported "
"mailbox formats are Maildir, mbox, MH, Babyl, and MMDF."
msgstr ""

#: ../../library/mailbox.rst:24
msgid "Module :mod:`email`"
msgstr ":mod:`email` 模組"

#: ../../library/mailbox.rst:25
msgid "Represent and manipulate messages."
msgstr ""

#: ../../library/mailbox.rst:31
msgid ":class:`!Mailbox` objects"
msgstr ":class:`!Mailbox` 物件"

#: ../../library/mailbox.rst:35
msgid "A mailbox, which may be inspected and modified."
msgstr ""

#: ../../library/mailbox.rst:37
msgid ""
"The :class:`!Mailbox` class defines an interface and is not intended to be "
"instantiated.  Instead, format-specific subclasses should inherit from :"
"class:`!Mailbox` and your code should instantiate a particular subclass."
msgstr ""

#: ../../library/mailbox.rst:41
msgid ""
"The :class:`!Mailbox` interface is dictionary-like, with small keys "
"corresponding to messages. Keys are issued by the :class:`!Mailbox` instance "
"with which they will be used and are only meaningful to that :class:`!"
"Mailbox` instance. A key continues to identify a message even if the "
"corresponding message is modified, such as by replacing it with another "
"message."
msgstr ""

#: ../../library/mailbox.rst:47
msgid ""
"Messages may be added to a :class:`!Mailbox` instance using the set-like "
"method :meth:`add` and removed using a ``del`` statement or the set-like "
"methods :meth:`remove` and :meth:`discard`."
msgstr ""

#: ../../library/mailbox.rst:51
msgid ""
":class:`!Mailbox` interface semantics differ from dictionary semantics in "
"some noteworthy ways. Each time a message is requested, a new representation "
"(typically a :class:`Message` instance) is generated based upon the current "
"state of the mailbox. Similarly, when a message is added to a :class:`!"
"Mailbox` instance, the provided message representation's contents are "
"copied. In neither case is a reference to the message representation kept by "
"the :class:`!Mailbox` instance."
msgstr ""

#: ../../library/mailbox.rst:59
msgid ""
"The default :class:`!Mailbox` :term:`iterator` iterates over message "
"representations, not keys as the default :class:`dictionary <dict>` iterator "
"does. Moreover, modification of a mailbox during iteration is safe and well-"
"defined. Messages added to the mailbox after an iterator is created will not "
"be seen by the iterator. Messages removed from the mailbox before the "
"iterator yields them will be silently skipped, though using a key from an "
"iterator may result in a :exc:`KeyError` exception if the corresponding "
"message is subsequently removed."
msgstr ""

#: ../../library/mailbox.rst:71
msgid ""
"Be very cautious when modifying mailboxes that might be simultaneously "
"changed by some other process.  The safest mailbox format to use for such "
"tasks is :class:`Maildir`; try to avoid using single-file formats such as :"
"class:`mbox` for concurrent writing.  If you're modifying a mailbox, you "
"*must* lock it by calling the :meth:`lock` and :meth:`unlock` methods "
"*before* reading any messages in the file or making any changes by adding or "
"deleting a message.  Failing to lock the mailbox runs the risk of losing "
"messages or corrupting the entire mailbox."
msgstr ""

#: ../../library/mailbox.rst:81
msgid ":class:`!Mailbox` instances have the following methods:"
msgstr ""

#: ../../library/mailbox.rst:86
msgid ""
"Add *message* to the mailbox and return the key that has been assigned to it."
msgstr ""

#: ../../library/mailbox.rst:89
msgid ""
"Parameter *message* may be a :class:`Message` instance, an :class:`email."
"message.Message` instance, a string, a byte string, or a file-like object "
"(which should be open in binary mode). If *message* is an instance of the "
"appropriate format-specific :class:`Message` subclass (e.g., if it's an :"
"class:`mboxMessage` instance and this is an :class:`mbox` instance), its "
"format-specific information is used. Otherwise, reasonable defaults for "
"format-specific information are used."
msgstr ""

#: ../../library/mailbox.rst:98
msgid "Support for binary input was added."
msgstr ""

#: ../../library/mailbox.rst:106
msgid "Delete the message corresponding to *key* from the mailbox."
msgstr ""

#: ../../library/mailbox.rst:108
msgid ""
"If no such message exists, a :exc:`KeyError` exception is raised if the "
"method was called as :meth:`remove` or :meth:`__delitem__` but no exception "
"is raised if the method was called as :meth:`discard`. The behavior of :meth:"
"`discard` may be preferred if the underlying mailbox format supports "
"concurrent modification by other processes."
msgstr ""

#: ../../library/mailbox.rst:117
msgid ""
"Replace the message corresponding to *key* with *message*. Raise a :exc:"
"`KeyError` exception if no message already corresponds to *key*."
msgstr ""

#: ../../library/mailbox.rst:120
msgid ""
"As with :meth:`add`, parameter *message* may be a :class:`Message` instance, "
"an :class:`email.message.Message` instance, a string, a byte string, or a "
"file-like object (which should be open in binary mode). If *message* is an "
"instance of the appropriate format-specific :class:`Message` subclass (e.g., "
"if it's an :class:`mboxMessage` instance and this is an :class:`mbox` "
"instance), its format-specific information is used. Otherwise, the format-"
"specific information of the message that currently corresponds to *key* is "
"left unchanged."
msgstr ""

#: ../../library/mailbox.rst:133
msgid "Return an :term:`iterator` over all keys"
msgstr ""

#: ../../library/mailbox.rst:138
msgid ""
"The same as :meth:`iterkeys`, except that a :class:`list` is returned rather "
"than an :term:`iterator`"
msgstr ""

#: ../../library/mailbox.rst:145
msgid ""
"Return an :term:`iterator` over representations of all messages. The "
"messages are represented as instances of the appropriate format-specific :"
"class:`Message` subclass unless a custom message factory was specified when "
"the :class:`!Mailbox` instance was initialized."
msgstr ""

#: ../../library/mailbox.rst:153
msgid ""
"The behavior of :meth:`__iter__` is unlike that of dictionaries, which "
"iterate over keys."
msgstr ""

#: ../../library/mailbox.rst:159
msgid ""
"The same as :meth:`itervalues`, except that a :class:`list` is returned "
"rather than an :term:`iterator`"
msgstr ""

#: ../../library/mailbox.rst:165
msgid ""
"Return an :term:`iterator` over (*key*, *message*) pairs, where *key* is a "
"key and *message* is a message representation. The messages are represented "
"as instances of the appropriate format-specific :class:`Message` subclass "
"unless a custom message factory was specified when the :class:`!Mailbox` "
"instance was initialized."
msgstr ""

#: ../../library/mailbox.rst:174
msgid ""
"The same as :meth:`iteritems`, except that a :class:`list` of pairs is "
"returned rather than an :term:`iterator` of pairs."
msgstr ""

#: ../../library/mailbox.rst:181
msgid ""
"Return a representation of the message corresponding to *key*. If no such "
"message exists, *default* is returned if the method was called as :meth:"
"`get` and a :exc:`KeyError` exception is raised if the method was called as :"
"meth:`!__getitem__`. The message is represented as an instance of the "
"appropriate format-specific :class:`Message` subclass unless a custom "
"message factory was specified when the :class:`!Mailbox` instance was "
"initialized."
msgstr ""

#: ../../library/mailbox.rst:192
msgid ""
"Return a representation of the message corresponding to *key* as an instance "
"of the appropriate format-specific :class:`Message` subclass, or raise a :"
"exc:`KeyError` exception if no such message exists."
msgstr ""

#: ../../library/mailbox.rst:199
msgid ""
"Return a byte representation of the message corresponding to *key*, or raise "
"a :exc:`KeyError` exception if no such message exists."
msgstr ""

#: ../../library/mailbox.rst:207
msgid ""
"Return a string representation of the message corresponding to *key*, or "
"raise a :exc:`KeyError` exception if no such message exists.  The message is "
"processed through :class:`email.message.Message` to convert it to a 7bit "
"clean representation."
msgstr ""

#: ../../library/mailbox.rst:215
msgid ""
"Return a :term:`file-like <file-like object>` representation of the message "
"corresponding to *key*, or raise a :exc:`KeyError` exception if no such "
"message exists.  The file-like object behaves as if open in binary mode.  "
"This file should be closed once it is no longer needed."
msgstr ""

#: ../../library/mailbox.rst:221
msgid ""
"The file object really is a :term:`binary file`; previously it was "
"incorrectly returned in text mode.  Also, the :term:`file-like object` now "
"supports the :term:`context manager` protocol: you can use a :keyword:`with` "
"statement to automatically close it."
msgstr ""

#: ../../library/mailbox.rst:229
msgid ""
"Unlike other representations of messages, :term:`file-like <file-like "
"object>` representations are not necessarily independent of the :class:`!"
"Mailbox` instance that created them or of the underlying mailbox.  More "
"specific documentation is provided by each subclass."
msgstr ""

#: ../../library/mailbox.rst:238
msgid "Return ``True`` if *key* corresponds to a message, ``False`` otherwise."
msgstr ""

#: ../../library/mailbox.rst:243
msgid "Return a count of messages in the mailbox."
msgstr ""

#: ../../library/mailbox.rst:248
msgid "Delete all messages from the mailbox."
msgstr ""

#: ../../library/mailbox.rst:253
msgid ""
"Return a representation of the message corresponding to *key* and delete the "
"message. If no such message exists, return *default*. The message is "
"represented as an instance of the appropriate format-specific :class:"
"`Message` subclass unless a custom message factory was specified when the :"
"class:`!Mailbox` instance was initialized."
msgstr ""

#: ../../library/mailbox.rst:262
msgid ""
"Return an arbitrary (*key*, *message*) pair, where *key* is a key and "
"*message* is a message representation, and delete the corresponding message. "
"If the mailbox is empty, raise a :exc:`KeyError` exception. The message is "
"represented as an instance of the appropriate format-specific :class:"
"`Message` subclass unless a custom message factory was specified when the :"
"class:`!Mailbox` instance was initialized."
msgstr ""

#: ../../library/mailbox.rst:272
msgid ""
"Parameter *arg* should be a *key*-to-*message* mapping or an iterable of "
"(*key*, *message*) pairs. Updates the mailbox so that, for each given *key* "
"and *message*, the message corresponding to *key* is set to *message* as if "
"by using :meth:`__setitem__`. As with :meth:`__setitem__`, each *key* must "
"already correspond to a message in the mailbox or else a :exc:`KeyError` "
"exception will be raised, so in general it is incorrect for *arg* to be a :"
"class:`!Mailbox` instance."
msgstr ""

#: ../../library/mailbox.rst:282
msgid "Unlike with dictionaries, keyword arguments are not supported."
msgstr ""

#: ../../library/mailbox.rst:287
msgid ""
"Write any pending changes to the filesystem. For some :class:`Mailbox` "
"subclasses, changes are always written immediately and :meth:`!flush` does "
"nothing, but you should still make a habit of calling this method."
msgstr ""

#: ../../library/mailbox.rst:294
msgid ""
"Acquire an exclusive advisory lock on the mailbox so that other processes "
"know not to modify it. An :exc:`ExternalClashError` is raised if the lock is "
"not available. The particular locking mechanisms used depend upon the "
"mailbox format.  You should *always* lock the mailbox before making any "
"modifications to its contents."
msgstr ""

#: ../../library/mailbox.rst:303
msgid "Release the lock on the mailbox, if any."
msgstr ""

#: ../../library/mailbox.rst:308
msgid ""
"Flush the mailbox, unlock it if necessary, and close any open files. For "
"some :class:`!Mailbox` subclasses, this method does nothing."
msgstr ""

#: ../../library/mailbox.rst:315
msgid ":class:`!Maildir` objects"
msgstr ":class:`!Mailbox` 物件"

#: ../../library/mailbox.rst:320
msgid ""
"A subclass of :class:`Mailbox` for mailboxes in Maildir format. Parameter "
"*factory* is a callable object that accepts a file-like message "
"representation (which behaves as if opened in binary mode) and returns a "
"custom representation. If *factory* is ``None``, :class:`MaildirMessage` is "
"used as the default message representation. If *create* is ``True``, the "
"mailbox is created if it does not exist."
msgstr ""

#: ../../library/mailbox.rst:327
msgid ""
"If *create* is ``True`` and the *dirname* path exists, it will be treated as "
"an existing maildir without attempting to verify its directory layout."
msgstr ""

#: ../../library/mailbox.rst:330
msgid ""
"It is for historical reasons that *dirname* is named as such rather than "
"*path*."
msgstr ""

#: ../../library/mailbox.rst:332
msgid ""
"Maildir is a directory-based mailbox format invented for the qmail mail "
"transfer agent and now widely supported by other programs. Messages in a "
"Maildir mailbox are stored in separate files within a common directory "
"structure. This design allows Maildir mailboxes to be accessed and modified "
"by multiple unrelated programs without data corruption, so file locking is "
"unnecessary."
msgstr ""

#: ../../library/mailbox.rst:339
msgid ""
"Maildir mailboxes contain three subdirectories, namely: :file:`tmp`, :file:"
"`new`, and :file:`cur`. Messages are created momentarily in the :file:`tmp` "
"subdirectory and then moved to the :file:`new` subdirectory to finalize "
"delivery. A mail user agent may subsequently move the message to the :file:"
"`cur` subdirectory and store information about the state of the message in a "
"special \"info\" section appended to its file name."
msgstr ""

#: ../../library/mailbox.rst:346
msgid ""
"Folders of the style introduced by the Courier mail transfer agent are also "
"supported. Any subdirectory of the main mailbox is considered a folder if "
"``'.'`` is the first character in its name. Folder names are represented by :"
"class:`!Maildir` without the leading ``'.'``. Each folder is itself a "
"Maildir mailbox but should not contain other folders. Instead, a logical "
"nesting is indicated using ``'.'`` to delimit levels, e.g., "
"\"Archived.2005.07\"."
msgstr ""

#: ../../library/mailbox.rst:355
msgid ""
"The Maildir specification requires the use of a colon (``':'``) in certain "
"message file names. However, some operating systems do not permit this "
"character in file names, If you wish to use a Maildir-like format on such an "
"operating system, you should specify another character to use instead. The "
"exclamation point (``'!'``) is a popular choice. For example::"
msgstr ""

#: ../../library/mailbox.rst:362
msgid ""
"import mailbox\n"
"mailbox.Maildir.colon = '!'"
msgstr ""
"import mailbox\n"
"mailbox.Maildir.colon = '!'"

#: ../../library/mailbox.rst:365
msgid "The :attr:`!colon` attribute may also be set on a per-instance basis."
msgstr ""

#: ../../library/mailbox.rst:367
msgid ":class:`Maildir` now ignores files with a leading dot."
msgstr ""

#: ../../library/mailbox.rst:370
msgid ""
":class:`!Maildir` instances have all of the methods of :class:`Mailbox` in "
"addition to the following:"
msgstr ""

#: ../../library/mailbox.rst:376 ../../library/mailbox.rst:654
msgid "Return a list of the names of all folders."
msgstr ""

#: ../../library/mailbox.rst:381
msgid ""
"Return a :class:`!Maildir` instance representing the folder whose name is "
"*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does "
"not exist."
msgstr ""

#: ../../library/mailbox.rst:388
msgid ""
"Create a folder whose name is *folder* and return a :class:`!Maildir` "
"instance representing it."
msgstr ""

#: ../../library/mailbox.rst:394 ../../library/mailbox.rst:672
msgid ""
"Delete the folder whose name is *folder*. If the folder contains any "
"messages, a :exc:`NotEmptyError` exception will be raised and the folder "
"will not be deleted."
msgstr ""

#: ../../library/mailbox.rst:401
msgid ""
"Delete temporary files from the mailbox that have not been accessed in the "
"last 36 hours. The Maildir specification says that mail-reading programs "
"should do this occasionally."
msgstr ""

#: ../../library/mailbox.rst:408
msgid ""
"Return as a string the flags that are set on the message corresponding to "
"*key*. This is the same as ``get_message(key).get_flags()`` but much faster, "
"because it does not open the message file. Use this method when iterating "
"over the keys to determine which messages are interesting to get."
msgstr ""

#: ../../library/mailbox.rst:415
msgid ""
"If you do have a :class:`MaildirMessage` object, use its :meth:"
"`~MaildirMessage.get_flags` method instead, because changes made by the "
"message's :meth:`~MaildirMessage.set_flags`, :meth:`~MaildirMessage."
"add_flag` and :meth:`~MaildirMessage.remove_flag` methods are not reflected "
"here until the mailbox's :meth:`__setitem__` method is called."
msgstr ""

#: ../../library/mailbox.rst:427
msgid ""
"On the message corresponding to *key*, set the flags specified by *flags* "
"and unset all others. Calling ``some_mailbox.set_flags(key, flags)`` is "
"similar to ::"
msgstr ""

#: ../../library/mailbox.rst:431
msgid ""
"one_message = some_mailbox.get_message(key)\n"
"one_message.set_flags(flags)\n"
"some_mailbox[key] = one_message"
msgstr ""

#: ../../library/mailbox.rst:435 ../../library/mailbox.rst:498
msgid "but faster, because it does not open the message file."
msgstr ""

#: ../../library/mailbox.rst:437
msgid ""
"If you do have a :class:`MaildirMessage` object, use its :meth:"
"`~MaildirMessage.set_flags` method instead, because changes made with this "
"mailbox method will not be visible to the message object's method, :meth:"
"`~MaildirMessage.get_flags`."
msgstr ""

#: ../../library/mailbox.rst:447
msgid ""
"On the message corresponding to *key*, set the flags specified by *flag* "
"without changing other flags. To add more than one flag at a time, *flag* "
"may be a string of more than one character."
msgstr ""

#: ../../library/mailbox.rst:451
msgid ""
"Considerations for using this method versus the message object's :meth:"
"`~MaildirMessage.add_flag` method are similar to those for :meth:"
"`set_flags`; see the discussion there."
msgstr ""

#: ../../library/mailbox.rst:460
msgid ""
"On the message corresponding to *key*, unset the flags specified by *flag* "
"without changing other flags. To remove more than one flag at a time, *flag* "
"may be a string of more than one character."
msgstr ""

#: ../../library/mailbox.rst:464
msgid ""
"Considerations for using this method versus the message object's :meth:"
"`~MaildirMessage.remove_flag` method are similar to those for :meth:"
"`set_flags`; see the discussion there."
msgstr ""

#: ../../library/mailbox.rst:473
msgid ""
"Return a string containing the info for the message corresponding to *key*. "
"This is the same as ``get_message(key).get_info()`` but much faster, because "
"it does not open the message file. Use this method when iterating over the "
"keys to determine which messages are interesting to get."
msgstr ""

#: ../../library/mailbox.rst:480
msgid ""
"If you do have a :class:`MaildirMessage` object, use its :meth:"
"`~MaildirMessage.get_info` method instead, because changes made by the "
"message's :meth:`~MaildirMessage.set_info` method are not reflected here "
"until the mailbox's :meth:`__setitem__` method is called."
msgstr ""

#: ../../library/mailbox.rst:491
msgid ""
"Set the info of the message corresponding to *key* to *info*. Calling "
"``some_mailbox.set_info(key, flags)`` is similar to ::"
msgstr ""

#: ../../library/mailbox.rst:494
msgid ""
"one_message = some_mailbox.get_message(key)\n"
"one_message.set_info(info)\n"
"some_mailbox[key] = one_message"
msgstr ""

#: ../../library/mailbox.rst:500
msgid ""
"If you do have a :class:`MaildirMessage` object, use its :meth:"
"`~MaildirMessage.set_info` method instead, because changes made with this "
"mailbox method will not be visible to the message object's method, :meth:"
"`~MaildirMessage.get_info`."
msgstr ""

#: ../../library/mailbox.rst:507
msgid ""
"Some :class:`Mailbox` methods implemented by :class:`!Maildir` deserve "
"special remarks:"
msgstr ""

#: ../../library/mailbox.rst:517
msgid ""
"These methods generate unique file names based upon the current process ID. "
"When using multiple threads, undetected name clashes may occur and cause "
"corruption of the mailbox unless threads are coordinated to avoid using "
"these methods to manipulate the same mailbox simultaneously."
msgstr ""

#: ../../library/mailbox.rst:525
msgid ""
"All changes to Maildir mailboxes are immediately applied, so this method "
"does nothing."
msgstr ""

#: ../../library/mailbox.rst:532
msgid ""
"Maildir mailboxes do not support (or require) locking, so these methods do "
"nothing."
msgstr ""

#: ../../library/mailbox.rst:538
msgid ""
":class:`!Maildir` instances do not keep any open files and the underlying "
"mailboxes do not support locking, so this method does nothing."
msgstr ""

#: ../../library/mailbox.rst:544
msgid ""
"Depending upon the host platform, it may not be possible to modify or remove "
"the underlying message while the returned file remains open."
msgstr ""

#: ../../library/mailbox.rst:550
msgid ""
"`maildir man page from Courier <https://www.courier-mta.org/maildir.html>`_"
msgstr ""

#: ../../library/mailbox.rst:551
msgid ""
"A specification of the format. Describes a common extension for supporting "
"folders."
msgstr ""

#: ../../library/mailbox.rst:554
msgid "`Using maildir format <https://cr.yp.to/proto/maildir.html>`_"
msgstr ""

#: ../../library/mailbox.rst:555
msgid ""
"Notes on Maildir by its inventor. Includes an updated name-creation scheme "
"and details on \"info\" semantics."
msgstr ""

#: ../../library/mailbox.rst:562
msgid ":class:`!mbox` objects"
msgstr ":class:`!mbox` 物件"

#: ../../library/mailbox.rst:567
msgid ""
"A subclass of :class:`Mailbox` for mailboxes in mbox format. Parameter "
"*factory* is a callable object that accepts a file-like message "
"representation (which behaves as if opened in binary mode) and returns a "
"custom representation. If *factory* is ``None``, :class:`mboxMessage` is "
"used as the default message representation. If *create* is ``True``, the "
"mailbox is created if it does not exist."
msgstr ""

#: ../../library/mailbox.rst:574
msgid ""
"The mbox format is the classic format for storing mail on Unix systems. All "
"messages in an mbox mailbox are stored in a single file with the beginning "
"of each message indicated by a line whose first five characters are \"From "
"\"."
msgstr ""

#: ../../library/mailbox.rst:578
msgid ""
"Several variations of the mbox format exist to address perceived "
"shortcomings in the original. In the interest of compatibility, :class:`!"
"mbox` implements the original format, which is sometimes referred to as :dfn:"
"`mboxo`. This means that the :mailheader:`Content-Length` header, if "
"present, is ignored and that any occurrences of \"From \" at the beginning "
"of a line in a message body are transformed to \">From \" when storing the "
"message, although occurrences of \">From \" are not transformed to \"From \" "
"when reading the message."
msgstr ""

#: ../../library/mailbox.rst:586
msgid ""
"Some :class:`Mailbox` methods implemented by :class:`!mbox` deserve special "
"remarks:"
msgstr ""

#: ../../library/mailbox.rst:592
msgid ""
"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox."
"close` on the :class:`!mbox` instance may yield unpredictable results or "
"raise an exception."
msgstr ""

#: ../../library/mailbox.rst:600 ../../library/mailbox.rst:813
#: ../../library/mailbox.rst:864
msgid ""
"Three locking mechanisms are used---dot locking and, if available, the :c:"
"func:`!flock` and :c:func:`!lockf` system calls."
msgstr ""

#: ../../library/mailbox.rst:606
msgid ""
"`mbox man page from tin <http://www.tin.org/bin/man.cgi?"
"section=5&topic=mbox>`_"
msgstr ""

#: ../../library/mailbox.rst:607
msgid "A specification of the format, with details on locking."
msgstr ""

#: ../../library/mailbox.rst:609
msgid ""
"`Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad "
"<https://www.jwz.org/doc/content-length.html>`_"
msgstr ""

#: ../../library/mailbox.rst:610
msgid "An argument for using the original mbox format rather than a variation."
msgstr ""

#: ../../library/mailbox.rst:612
msgid ""
"`\"mbox\" is a family of several mutually incompatible mailbox formats "
"<https://www.loc.gov/preservation/digital/formats/fdd/fdd000383.shtml>`_"
msgstr ""

#: ../../library/mailbox.rst:613
msgid "A history of mbox variations."
msgstr ""

#: ../../library/mailbox.rst:619
msgid ":class:`!MH` objects"
msgstr ":class:`!MH` 物件"

#: ../../library/mailbox.rst:624
msgid ""
"A subclass of :class:`Mailbox` for mailboxes in MH format. Parameter "
"*factory* is a callable object that accepts a file-like message "
"representation (which behaves as if opened in binary mode) and returns a "
"custom representation. If *factory* is ``None``, :class:`MHMessage` is used "
"as the default message representation. If *create* is ``True``, the mailbox "
"is created if it does not exist."
msgstr ""

#: ../../library/mailbox.rst:631
msgid ""
"MH is a directory-based mailbox format invented for the MH Message Handling "
"System, a mail user agent. Each message in an MH mailbox resides in its own "
"file. An MH mailbox may contain other MH mailboxes (called :dfn:`folders`) "
"in addition to messages. Folders may be nested indefinitely. MH mailboxes "
"also support :dfn:`sequences`, which are named lists used to logically group "
"messages without moving them to sub-folders. Sequences are defined in a file "
"called :file:`.mh_sequences` in each folder."
msgstr ""

#: ../../library/mailbox.rst:639
msgid ""
"The :class:`!MH` class manipulates MH mailboxes, but it does not attempt to "
"emulate all of :program:`mh`'s behaviors. In particular, it does not modify "
"and is not affected by the :file:`context` or :file:`.mh_profile` files that "
"are used by :program:`mh` to store its state and configuration."
msgstr ""

#: ../../library/mailbox.rst:644
msgid ""
":class:`!MH` instances have all of the methods of :class:`Mailbox` in "
"addition to the following:"
msgstr ""

#: ../../library/mailbox.rst:649
msgid "Supported folders that don't contain a :file:`.mh_sequences` file."
msgstr ""

#: ../../library/mailbox.rst:659
msgid ""
"Return an :class:`!MH` instance representing the folder whose name is "
"*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does "
"not exist."
msgstr ""

#: ../../library/mailbox.rst:666
msgid ""
"Create a folder whose name is *folder* and return an :class:`!MH` instance "
"representing it."
msgstr ""

#: ../../library/mailbox.rst:679
msgid ""
"Return a dictionary of sequence names mapped to key lists. If there are no "
"sequences, the empty dictionary is returned."
msgstr ""

#: ../../library/mailbox.rst:685
msgid ""
"Re-define the sequences that exist in the mailbox based upon *sequences*, a "
"dictionary of names mapped to key lists, like returned by :meth:"
"`get_sequences`."
msgstr ""

#: ../../library/mailbox.rst:692
msgid ""
"Rename messages in the mailbox as necessary to eliminate gaps in numbering.  "
"Entries in the sequences list are updated correspondingly."
msgstr ""

#: ../../library/mailbox.rst:697
msgid ""
"Already-issued keys are invalidated by this operation and should not be "
"subsequently used."
msgstr ""

#: ../../library/mailbox.rst:700
msgid ""
"Some :class:`Mailbox` methods implemented by :class:`!MH` deserve special "
"remarks:"
msgstr ""

#: ../../library/mailbox.rst:708
msgid ""
"These methods immediately delete the message. The MH convention of marking a "
"message for deletion by prepending a comma to its name is not used."
msgstr ""

#: ../../library/mailbox.rst:715
msgid ""
"Three locking mechanisms are used---dot locking and, if available, the :c:"
"func:`!flock` and :c:func:`!lockf` system calls. For MH mailboxes, locking "
"the mailbox means locking the :file:`.mh_sequences` file and, only for the "
"duration of any operations that affect them, locking individual message "
"files."
msgstr ""

#: ../../library/mailbox.rst:724
msgid ""
"Depending upon the host platform, it may not be possible to remove the "
"underlying message while the returned file remains open."
msgstr ""

#: ../../library/mailbox.rst:730
msgid ""
"All changes to MH mailboxes are immediately applied, so this method does "
"nothing."
msgstr ""

#: ../../library/mailbox.rst:736
msgid ""
":class:`!MH` instances do not keep any open files, so this method is "
"equivalent to :meth:`unlock`."
msgstr ""

#: ../../library/mailbox.rst:742
msgid "`nmh - Message Handling System <https://www.nongnu.org/nmh/>`_"
msgstr ""

#: ../../library/mailbox.rst:743
msgid ""
"Home page of :program:`nmh`, an updated version of the original :program:"
"`mh`."
msgstr ""

#: ../../library/mailbox.rst:745
msgid ""
"`MH & nmh: Email for Users & Programmers <https://rand-mh.sourceforge.io/"
"book/>`_"
msgstr ""

#: ../../library/mailbox.rst:746
msgid ""
"A GPL-licensed book on :program:`mh` and :program:`nmh`, with some "
"information on the mailbox format."
msgstr ""

#: ../../library/mailbox.rst:753
msgid ":class:`!Babyl` objects"
msgstr ":class:`!Babyl` 物件"

#: ../../library/mailbox.rst:758
msgid ""
"A subclass of :class:`Mailbox` for mailboxes in Babyl format. Parameter "
"*factory* is a callable object that accepts a file-like message "
"representation (which behaves as if opened in binary mode) and returns a "
"custom representation. If *factory* is ``None``, :class:`BabylMessage` is "
"used as the default message representation. If *create* is ``True``, the "
"mailbox is created if it does not exist."
msgstr ""

#: ../../library/mailbox.rst:765
msgid ""
"Babyl is a single-file mailbox format used by the Rmail mail user agent "
"included with Emacs. The beginning of a message is indicated by a line "
"containing the two characters Control-Underscore (``'\\037'``) and Control-L "
"(``'\\014'``). The end of a message is indicated by the start of the next "
"message or, in the case of the last message, a line containing a Control-"
"Underscore (``'\\037'``) character."
msgstr ""

#: ../../library/mailbox.rst:772
msgid ""
"Messages in a Babyl mailbox have two sets of headers, original headers and "
"so-called visible headers. Visible headers are typically a subset of the "
"original headers that have been reformatted or abridged to be more "
"attractive. Each message in a Babyl mailbox also has an accompanying list "
"of :dfn:`labels`, or short strings that record extra information about the "
"message, and a list of all user-defined labels found in the mailbox is kept "
"in the Babyl options section."
msgstr ""

#: ../../library/mailbox.rst:780
msgid ""
":class:`!Babyl` instances have all of the methods of :class:`Mailbox` in "
"addition to the following:"
msgstr ""

#: ../../library/mailbox.rst:786
msgid ""
"Return a list of the names of all user-defined labels used in the mailbox."
msgstr ""

#: ../../library/mailbox.rst:790
msgid ""
"The actual messages are inspected to determine which labels exist in the "
"mailbox rather than consulting the list of labels in the Babyl options "
"section, but the Babyl section is updated whenever the mailbox is modified."
msgstr ""

#: ../../library/mailbox.rst:795
msgid ""
"Some :class:`Mailbox` methods implemented by :class:`!Babyl` deserve special "
"remarks:"
msgstr ""

#: ../../library/mailbox.rst:801
msgid ""
"In Babyl mailboxes, the headers of a message are not stored contiguously "
"with the body of the message. To generate a file-like representation, the "
"headers and body are copied together into an :class:`io.BytesIO` instance, "
"which has an API identical to that of a file. As a result, the file-like "
"object is truly independent of the underlying mailbox but does not save "
"memory compared to a string representation."
msgstr ""

#: ../../library/mailbox.rst:819
msgid ""
"`Format of Version 5 Babyl Files <https://quimby.gnus.org/notes/BABYL>`_"
msgstr ""

#: ../../library/mailbox.rst:820
msgid "A specification of the Babyl format."
msgstr ""

#: ../../library/mailbox.rst:822
msgid ""
"`Reading Mail with Rmail <https://www.gnu.org/software/emacs/manual/"
"html_node/emacs/Rmail.html>`_"
msgstr ""

#: ../../library/mailbox.rst:823
msgid "The Rmail manual, with some information on Babyl semantics."
msgstr ""

#: ../../library/mailbox.rst:829
msgid ":class:`!MMDF` objects"
msgstr ":class:`!MMDF` 物件"

#: ../../library/mailbox.rst:834
msgid ""
"A subclass of :class:`Mailbox` for mailboxes in MMDF format. Parameter "
"*factory* is a callable object that accepts a file-like message "
"representation (which behaves as if opened in binary mode) and returns a "
"custom representation. If *factory* is ``None``, :class:`MMDFMessage` is "
"used as the default message representation. If *create* is ``True``, the "
"mailbox is created if it does not exist."
msgstr ""

#: ../../library/mailbox.rst:841
msgid ""
"MMDF is a single-file mailbox format invented for the Multichannel "
"Memorandum Distribution Facility, a mail transfer agent. Each message is in "
"the same form as an mbox message but is bracketed before and after by lines "
"containing four Control-A (``'\\001'``) characters. As with the mbox format, "
"the beginning of each message is indicated by a line whose first five "
"characters are \"From \", but additional occurrences of \"From \" are not "
"transformed to \">From \" when storing messages because the extra message "
"separator lines prevent mistaking such occurrences for the starts of "
"subsequent messages."
msgstr ""

#: ../../library/mailbox.rst:850
msgid ""
"Some :class:`Mailbox` methods implemented by :class:`!MMDF` deserve special "
"remarks:"
msgstr ""

#: ../../library/mailbox.rst:856
msgid ""
"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox."
"close` on the :class:`!MMDF` instance may yield unpredictable results or "
"raise an exception."
msgstr ""

#: ../../library/mailbox.rst:870
msgid ""
"`mmdf man page from tin <http://www.tin.org/bin/man.cgi?"
"section=5&topic=mmdf>`_"
msgstr ""

#: ../../library/mailbox.rst:871
msgid ""
"A specification of MMDF format from the documentation of tin, a newsreader."
msgstr ""

#: ../../library/mailbox.rst:873
msgid "`MMDF <https://en.wikipedia.org/wiki/MMDF>`_"
msgstr "`MMDF <https://en.wikipedia.org/wiki/MMDF>`_"

#: ../../library/mailbox.rst:874
msgid ""
"A Wikipedia article describing the Multichannel Memorandum Distribution "
"Facility."
msgstr ""

#: ../../library/mailbox.rst:881
msgid ":class:`!Message` objects"
msgstr ":class:`!Message` 物件"

#: ../../library/mailbox.rst:886
msgid ""
"A subclass of the :mod:`email.message` module's :class:`~email.message."
"Message`. Subclasses of :class:`!mailbox.Message` add mailbox-format-"
"specific state and behavior."
msgstr ""

#: ../../library/mailbox.rst:890
msgid ""
"If *message* is omitted, the new instance is created in a default, empty "
"state. If *message* is an :class:`email.message.Message` instance, its "
"contents are copied; furthermore, any format-specific information is "
"converted insofar as possible if *message* is a :class:`!Message` instance. "
"If *message* is a string, a byte string, or a file, it should contain an :"
"rfc:`2822`\\ -compliant message, which is read and parsed.  Files should be "
"open in binary mode, but text mode files are accepted for backward "
"compatibility."
msgstr ""

#: ../../library/mailbox.rst:899
msgid ""
"The format-specific state and behaviors offered by subclasses vary, but in "
"general it is only the properties that are not specific to a particular "
"mailbox that are supported (although presumably the properties are specific "
"to a particular mailbox format). For example, file offsets for single-file "
"mailbox formats and file names for directory-based mailbox formats are not "
"retained, because they are only applicable to the original mailbox. But "
"state such as whether a message has been read by the user or marked as "
"important is retained, because it applies to the message itself."
msgstr ""

#: ../../library/mailbox.rst:908
msgid ""
"There is no requirement that :class:`!Message` instances be used to "
"represent messages retrieved using :class:`Mailbox` instances. In some "
"situations, the time and memory required to generate :class:`!Message` "
"representations might not be acceptable. For such situations, :class:`!"
"Mailbox` instances also offer string and file-like representations, and a "
"custom message factory may be specified when a :class:`!Mailbox` instance is "
"initialized."
msgstr ""

#: ../../library/mailbox.rst:919
msgid ":class:`!MaildirMessage` objects"
msgstr ":class:`!MaildirMessage` 物件"

#: ../../library/mailbox.rst:924
msgid ""
"A message with Maildir-specific behaviors. Parameter *message* has the same "
"meaning as with the :class:`Message` constructor."
msgstr ""

#: ../../library/mailbox.rst:927
msgid ""
"Typically, a mail user agent application moves all of the messages in the :"
"file:`new` subdirectory to the :file:`cur` subdirectory after the first time "
"the user opens and closes the mailbox, recording that the messages are old "
"whether or not they've actually been read. Each message in :file:`cur` has "
"an \"info\" section added to its file name to store information about its "
"state. (Some mail readers may also add an \"info\" section to messages in :"
"file:`new`.)  The \"info\" section may take one of two forms: it may contain "
"\"2,\" followed by a list of standardized flags (e.g., \"2,FR\") or it may "
"contain \"1,\" followed by so-called experimental information. Standard "
"flags for Maildir messages are as follows:"
msgstr ""

#: ../../library/mailbox.rst:939 ../../library/mailbox.rst:1106
#: ../../library/mailbox.rst:1477
msgid "Flag"
msgstr ""

#: ../../library/mailbox.rst:939 ../../library/mailbox.rst:1106
#: ../../library/mailbox.rst:1477
msgid "Meaning"
msgstr "含義"

#: ../../library/mailbox.rst:939 ../../library/mailbox.rst:1106
#: ../../library/mailbox.rst:1257 ../../library/mailbox.rst:1344
#: ../../library/mailbox.rst:1477
msgid "Explanation"
msgstr ""

#: ../../library/mailbox.rst:941 ../../library/mailbox.rst:1112
#: ../../library/mailbox.rst:1483
msgid "D"
msgstr "D"

#: ../../library/mailbox.rst:941
msgid "Draft"
msgstr ""

#: ../../library/mailbox.rst:941
msgid "Under composition"
msgstr ""

#: ../../library/mailbox.rst:943 ../../library/mailbox.rst:1114
#: ../../library/mailbox.rst:1485
msgid "F"
msgstr "F"

#: ../../library/mailbox.rst:943 ../../library/mailbox.rst:1114
#: ../../library/mailbox.rst:1485
msgid "Flagged"
msgstr ""

#: ../../library/mailbox.rst:943 ../../library/mailbox.rst:1114
#: ../../library/mailbox.rst:1263 ../../library/mailbox.rst:1485
msgid "Marked as important"
msgstr ""

#: ../../library/mailbox.rst:945
msgid "P"
msgstr "P"

#: ../../library/mailbox.rst:945
msgid "Passed"
msgstr ""

#: ../../library/mailbox.rst:945
msgid "Forwarded, resent, or bounced"
msgstr ""

#: ../../library/mailbox.rst:947 ../../library/mailbox.rst:1108
#: ../../library/mailbox.rst:1479
msgid "R"
msgstr "R"

#: ../../library/mailbox.rst:947
msgid "Replied"
msgstr ""

#: ../../library/mailbox.rst:947 ../../library/mailbox.rst:1116
#: ../../library/mailbox.rst:1261 ../../library/mailbox.rst:1352
#: ../../library/mailbox.rst:1487
msgid "Replied to"
msgstr ""

#: ../../library/mailbox.rst:949
msgid "S"
msgstr "S"

#: ../../library/mailbox.rst:949
msgid "Seen"
msgstr ""

#: ../../library/mailbox.rst:949 ../../library/mailbox.rst:1108
#: ../../library/mailbox.rst:1479
msgid "Read"
msgstr ""

#: ../../library/mailbox.rst:951
msgid "T"
msgstr "T"

#: ../../library/mailbox.rst:951
msgid "Trashed"
msgstr ""

#: ../../library/mailbox.rst:951 ../../library/mailbox.rst:1112
#: ../../library/mailbox.rst:1348 ../../library/mailbox.rst:1483
msgid "Marked for subsequent deletion"
msgstr ""

#: ../../library/mailbox.rst:954
msgid ":class:`!MaildirMessage` instances offer the following methods:"
msgstr ""

#: ../../library/mailbox.rst:959
msgid ""
"Return either \"new\" (if the message should be stored in the :file:`new` "
"subdirectory) or \"cur\" (if the message should be stored in the :file:`cur` "
"subdirectory)."
msgstr ""

#: ../../library/mailbox.rst:965
msgid ""
"A message is typically moved from :file:`new` to :file:`cur` after its "
"mailbox has been accessed, whether or not the message has been read. A "
"message ``msg`` has been read if ``\"S\" in msg.get_flags()`` is ``True``."
msgstr ""

#: ../../library/mailbox.rst:973
msgid ""
"Set the subdirectory the message should be stored in. Parameter *subdir* "
"must be either \"new\" or \"cur\"."
msgstr ""

#: ../../library/mailbox.rst:979
msgid ""
"Return a string specifying the flags that are currently set. If the message "
"complies with the standard Maildir format, the result is the concatenation "
"in alphabetical order of zero or one occurrence of each of ``'D'``, ``'F'``, "
"``'P'``, ``'R'``, ``'S'``, and ``'T'``. The empty string is returned if no "
"flags are set or if \"info\" contains experimental semantics."
msgstr ""

#: ../../library/mailbox.rst:989
msgid "Set the flags specified by *flags* and unset all others."
msgstr ""

#: ../../library/mailbox.rst:994
msgid ""
"Set the flag(s) specified by *flag* without changing other flags. To add "
"more than one flag at a time, *flag* may be a string of more than one "
"character. The current \"info\" is overwritten whether or not it contains "
"experimental information rather than flags."
msgstr ""

#: ../../library/mailbox.rst:1002
msgid ""
"Unset the flag(s) specified by *flag* without changing other flags. To "
"remove more than one flag at a time, *flag* maybe a string of more than one "
"character.  If \"info\" contains experimental information rather than flags, "
"the current \"info\" is not modified."
msgstr ""

#: ../../library/mailbox.rst:1010
msgid ""
"Return the delivery date of the message as a floating-point number "
"representing seconds since the epoch."
msgstr ""

#: ../../library/mailbox.rst:1016
msgid ""
"Set the delivery date of the message to *date*, a floating-point number "
"representing seconds since the epoch."
msgstr ""

#: ../../library/mailbox.rst:1022
msgid ""
"Return a string containing the \"info\" for a message. This is useful for "
"accessing and modifying \"info\" that is experimental (i.e., not a list of "
"flags)."
msgstr ""

#: ../../library/mailbox.rst:1029
msgid "Set \"info\" to *info*, which should be a string."
msgstr ""

#: ../../library/mailbox.rst:1031
msgid ""
"When a :class:`!MaildirMessage` instance is created based upon an :class:"
"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` "
"and :mailheader:`X-Status` headers are omitted and the following conversions "
"take place:"
msgstr ""

#: ../../library/mailbox.rst:1037 ../../library/mailbox.rst:1055
#: ../../library/mailbox.rst:1070 ../../library/mailbox.rst:1177
#: ../../library/mailbox.rst:1194 ../../library/mailbox.rst:1209
#: ../../library/mailbox.rst:1225 ../../library/mailbox.rst:1292
#: ../../library/mailbox.rst:1307 ../../library/mailbox.rst:1321
#: ../../library/mailbox.rst:1418 ../../library/mailbox.rst:1435
#: ../../library/mailbox.rst:1449 ../../library/mailbox.rst:1549
#: ../../library/mailbox.rst:1566 ../../library/mailbox.rst:1581
#: ../../library/mailbox.rst:1597
msgid "Resulting state"
msgstr ""

#: ../../library/mailbox.rst:1037 ../../library/mailbox.rst:1307
#: ../../library/mailbox.rst:1435
msgid ":class:`mboxMessage` or :class:`MMDFMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1040 ../../library/mailbox.rst:1057
#: ../../library/mailbox.rst:1072 ../../library/mailbox.rst:1181
#: ../../library/mailbox.rst:1553
msgid "\"cur\" subdirectory"
msgstr ""

#: ../../library/mailbox.rst:1040 ../../library/mailbox.rst:1181
#: ../../library/mailbox.rst:1198 ../../library/mailbox.rst:1213
#: ../../library/mailbox.rst:1229 ../../library/mailbox.rst:1553
#: ../../library/mailbox.rst:1570 ../../library/mailbox.rst:1585
#: ../../library/mailbox.rst:1601
msgid "O flag"
msgstr ""

#: ../../library/mailbox.rst:1042 ../../library/mailbox.rst:1061
#: ../../library/mailbox.rst:1185 ../../library/mailbox.rst:1200
#: ../../library/mailbox.rst:1233 ../../library/mailbox.rst:1298
#: ../../library/mailbox.rst:1314 ../../library/mailbox.rst:1557
#: ../../library/mailbox.rst:1572 ../../library/mailbox.rst:1605
msgid "F flag"
msgstr ""

#: ../../library/mailbox.rst:1044 ../../library/mailbox.rst:1046
#: ../../library/mailbox.rst:1063 ../../library/mailbox.rst:1078
#: ../../library/mailbox.rst:1179 ../../library/mailbox.rst:1187
#: ../../library/mailbox.rst:1227 ../../library/mailbox.rst:1296
#: ../../library/mailbox.rst:1424 ../../library/mailbox.rst:1551
#: ../../library/mailbox.rst:1559 ../../library/mailbox.rst:1599
msgid "R flag"
msgstr ""

#: ../../library/mailbox.rst:1044 ../../library/mailbox.rst:1187
#: ../../library/mailbox.rst:1202 ../../library/mailbox.rst:1217
#: ../../library/mailbox.rst:1235 ../../library/mailbox.rst:1312
#: ../../library/mailbox.rst:1442 ../../library/mailbox.rst:1559
#: ../../library/mailbox.rst:1574 ../../library/mailbox.rst:1589
#: ../../library/mailbox.rst:1607
msgid "A flag"
msgstr ""

#: ../../library/mailbox.rst:1046 ../../library/mailbox.rst:1179
#: ../../library/mailbox.rst:1551
msgid "S flag"
msgstr ""

#: ../../library/mailbox.rst:1048 ../../library/mailbox.rst:1080
#: ../../library/mailbox.rst:1183 ../../library/mailbox.rst:1422
#: ../../library/mailbox.rst:1555
msgid "T flag"
msgstr ""

#: ../../library/mailbox.rst:1048 ../../library/mailbox.rst:1183
#: ../../library/mailbox.rst:1215 ../../library/mailbox.rst:1231
#: ../../library/mailbox.rst:1440 ../../library/mailbox.rst:1555
#: ../../library/mailbox.rst:1587 ../../library/mailbox.rst:1603
msgid "D flag"
msgstr ""

#: ../../library/mailbox.rst:1051
msgid ""
"When a :class:`!MaildirMessage` instance is created based upon an :class:"
"`MHMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1055 ../../library/mailbox.rst:1194
#: ../../library/mailbox.rst:1449 ../../library/mailbox.rst:1566
msgid ":class:`MHMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1057 ../../library/mailbox.rst:1198
#: ../../library/mailbox.rst:1294 ../../library/mailbox.rst:1310
#: ../../library/mailbox.rst:1323 ../../library/mailbox.rst:1451
#: ../../library/mailbox.rst:1570
msgid "\"unseen\" sequence"
msgstr ""

#: ../../library/mailbox.rst:1059 ../../library/mailbox.rst:1074
msgid "\"cur\" subdirectory and S flag"
msgstr ""

#: ../../library/mailbox.rst:1059 ../../library/mailbox.rst:1196
#: ../../library/mailbox.rst:1568
msgid "no \"unseen\" sequence"
msgstr ""

#: ../../library/mailbox.rst:1061 ../../library/mailbox.rst:1200
#: ../../library/mailbox.rst:1298 ../../library/mailbox.rst:1314
#: ../../library/mailbox.rst:1572
msgid "\"flagged\" sequence"
msgstr ""

#: ../../library/mailbox.rst:1063 ../../library/mailbox.rst:1202
#: ../../library/mailbox.rst:1296 ../../library/mailbox.rst:1312
#: ../../library/mailbox.rst:1325 ../../library/mailbox.rst:1453
#: ../../library/mailbox.rst:1574
msgid "\"replied\" sequence"
msgstr ""

#: ../../library/mailbox.rst:1066
msgid ""
"When a :class:`!MaildirMessage` instance is created based upon a :class:"
"`BabylMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1070 ../../library/mailbox.rst:1209
#: ../../library/mailbox.rst:1321 ../../library/mailbox.rst:1581
msgid ":class:`BabylMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1072 ../../library/mailbox.rst:1213
#: ../../library/mailbox.rst:1323 ../../library/mailbox.rst:1420
#: ../../library/mailbox.rst:1438 ../../library/mailbox.rst:1451
#: ../../library/mailbox.rst:1585
msgid "\"unseen\" label"
msgstr ""

#: ../../library/mailbox.rst:1074 ../../library/mailbox.rst:1211
#: ../../library/mailbox.rst:1583
msgid "no \"unseen\" label"
msgstr ""

#: ../../library/mailbox.rst:1076 ../../library/mailbox.rst:1426
msgid "P flag"
msgstr ""

#: ../../library/mailbox.rst:1076
msgid "\"forwarded\" or \"resent\" label"
msgstr ""

#: ../../library/mailbox.rst:1078 ../../library/mailbox.rst:1217
#: ../../library/mailbox.rst:1325 ../../library/mailbox.rst:1424
#: ../../library/mailbox.rst:1442 ../../library/mailbox.rst:1453
#: ../../library/mailbox.rst:1589
msgid "\"answered\" label"
msgstr ""

#: ../../library/mailbox.rst:1080 ../../library/mailbox.rst:1215
#: ../../library/mailbox.rst:1422 ../../library/mailbox.rst:1440
#: ../../library/mailbox.rst:1587
msgid "\"deleted\" label"
msgstr ""

#: ../../library/mailbox.rst:1087
msgid ":class:`!mboxMessage` objects"
msgstr ":class:`!mboxMessage` 物件"

#: ../../library/mailbox.rst:1092
msgid ""
"A message with mbox-specific behaviors. Parameter *message* has the same "
"meaning as with the :class:`Message` constructor."
msgstr ""

#: ../../library/mailbox.rst:1095
msgid ""
"Messages in an mbox mailbox are stored together in a single file. The "
"sender's envelope address and the time of delivery are typically stored in a "
"line beginning with \"From \" that is used to indicate the start of a "
"message, though there is considerable variation in the exact format of this "
"data among mbox implementations. Flags that indicate the state of the "
"message, such as whether it has been read or marked as important, are "
"typically stored in :mailheader:`Status` and :mailheader:`X-Status` headers."
msgstr ""

#: ../../library/mailbox.rst:1103
msgid "Conventional flags for mbox messages are as follows:"
msgstr ""

#: ../../library/mailbox.rst:1110 ../../library/mailbox.rst:1481
msgid "O"
msgstr "O"

#: ../../library/mailbox.rst:1110 ../../library/mailbox.rst:1481
msgid "Old"
msgstr ""

#: ../../library/mailbox.rst:1110 ../../library/mailbox.rst:1481
msgid "Previously detected by MUA"
msgstr ""

#: ../../library/mailbox.rst:1112 ../../library/mailbox.rst:1483
msgid "Deleted"
msgstr ""

#: ../../library/mailbox.rst:1116 ../../library/mailbox.rst:1487
msgid "A"
msgstr "A"

#: ../../library/mailbox.rst:1116 ../../library/mailbox.rst:1487
msgid "Answered"
msgstr ""

#: ../../library/mailbox.rst:1119 ../../library/mailbox.rst:1490
msgid ""
"The \"R\" and \"O\" flags are stored in the :mailheader:`Status` header, and "
"the \"D\", \"F\", and \"A\" flags are stored in the :mailheader:`X-Status` "
"header. The flags and headers typically appear in the order mentioned."
msgstr ""

#: ../../library/mailbox.rst:1123
msgid ":class:`!mboxMessage` instances offer the following methods:"
msgstr ""

#: ../../library/mailbox.rst:1128 ../../library/mailbox.rst:1500
msgid ""
"Return a string representing the \"From \" line that marks the start of the "
"message in an mbox mailbox. The leading \"From \" and the trailing newline "
"are excluded."
msgstr ""

#: ../../library/mailbox.rst:1135 ../../library/mailbox.rst:1507
msgid ""
"Set the \"From \" line to *from_*, which should be specified without a "
"leading \"From \" or trailing newline. For convenience, *time_* may be "
"specified and will be formatted appropriately and appended to *from_*. If "
"*time_* is specified, it should be a :class:`time.struct_time` instance, a "
"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to use :"
"func:`time.gmtime`)."
msgstr ""

#: ../../library/mailbox.rst:1145 ../../library/mailbox.rst:1517
msgid ""
"Return a string specifying the flags that are currently set. If the message "
"complies with the conventional format, the result is the concatenation in "
"the following order of zero or one occurrence of each of ``'R'``, ``'O'``, "
"``'D'``, ``'F'``, and ``'A'``."
msgstr ""

#: ../../library/mailbox.rst:1153 ../../library/mailbox.rst:1525
msgid ""
"Set the flags specified by *flags* and unset all others. Parameter *flags* "
"should be the concatenation in any order of zero or more occurrences of each "
"of ``'R'``, ``'O'``, ``'D'``, ``'F'``, and ``'A'``."
msgstr ""

#: ../../library/mailbox.rst:1160 ../../library/mailbox.rst:1532
msgid ""
"Set the flag(s) specified by *flag* without changing other flags. To add "
"more than one flag at a time, *flag* may be a string of more than one "
"character."
msgstr ""

#: ../../library/mailbox.rst:1167 ../../library/mailbox.rst:1539
msgid ""
"Unset the flag(s) specified by *flag* without changing other flags. To "
"remove more than one flag at a time, *flag* maybe a string of more than one "
"character."
msgstr ""

#: ../../library/mailbox.rst:1171
msgid ""
"When an :class:`!mboxMessage` instance is created based upon a :class:"
"`MaildirMessage` instance, a \"From \" line is generated based upon the :"
"class:`MaildirMessage` instance's delivery date, and the following "
"conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1177 ../../library/mailbox.rst:1292
#: ../../library/mailbox.rst:1418 ../../library/mailbox.rst:1549
msgid ":class:`MaildirMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1190
msgid ""
"When an :class:`!mboxMessage` instance is created based upon an :class:"
"`MHMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1196 ../../library/mailbox.rst:1211
#: ../../library/mailbox.rst:1568 ../../library/mailbox.rst:1583
msgid "R flag and O flag"
msgstr ""

#: ../../library/mailbox.rst:1205
msgid ""
"When an :class:`!mboxMessage` instance is created based upon a :class:"
"`BabylMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1220
msgid ""
"When a :class:`!mboxMessage` instance is created based upon an :class:"
"`MMDFMessage` instance, the \"From \" line is copied and all flags directly "
"correspond:"
msgstr ""

#: ../../library/mailbox.rst:1225
msgid ":class:`MMDFMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1242
msgid ":class:`!MHMessage` objects"
msgstr ":class:`!MHMessage` 物件"

#: ../../library/mailbox.rst:1247
msgid ""
"A message with MH-specific behaviors. Parameter *message* has the same "
"meaning as with the :class:`Message` constructor."
msgstr ""

#: ../../library/mailbox.rst:1250
msgid ""
"MH messages do not support marks or flags in the traditional sense, but they "
"do support sequences, which are logical groupings of arbitrary messages. "
"Some mail reading programs (although not the standard :program:`mh` and :"
"program:`nmh`) use sequences in much the same way flags are used with other "
"formats, as follows:"
msgstr ""

#: ../../library/mailbox.rst:1257
msgid "Sequence"
msgstr ""

#: ../../library/mailbox.rst:1259 ../../library/mailbox.rst:1346
msgid "unseen"
msgstr ""

#: ../../library/mailbox.rst:1259 ../../library/mailbox.rst:1346
msgid "Not read, but previously detected by MUA"
msgstr ""

#: ../../library/mailbox.rst:1261
msgid "replied"
msgstr ""

#: ../../library/mailbox.rst:1263
msgid "flagged"
msgstr ""

#: ../../library/mailbox.rst:1266
msgid ":class:`!MHMessage` instances offer the following methods:"
msgstr ""

#: ../../library/mailbox.rst:1271
msgid "Return a list of the names of sequences that include this message."
msgstr ""

#: ../../library/mailbox.rst:1276
msgid "Set the list of sequences that include this message."
msgstr ""

#: ../../library/mailbox.rst:1281
msgid "Add *sequence* to the list of sequences that include this message."
msgstr ""

#: ../../library/mailbox.rst:1286
msgid "Remove *sequence* from the list of sequences that include this message."
msgstr ""

#: ../../library/mailbox.rst:1288
msgid ""
"When an :class:`!MHMessage` instance is created based upon a :class:"
"`MaildirMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1294 ../../library/mailbox.rst:1420
msgid "no S flag"
msgstr ""

#: ../../library/mailbox.rst:1301
msgid ""
"When an :class:`!MHMessage` instance is created based upon an :class:"
"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` "
"and :mailheader:`X-Status` headers are omitted and the following conversions "
"take place:"
msgstr ""

#: ../../library/mailbox.rst:1310 ../../library/mailbox.rst:1438
msgid "no R flag"
msgstr ""

#: ../../library/mailbox.rst:1317
msgid ""
"When an :class:`!MHMessage` instance is created based upon a :class:"
"`BabylMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1332
msgid ":class:`!BabylMessage` objects"
msgstr ":class:`!BabylMessage` 物件"

#: ../../library/mailbox.rst:1337
msgid ""
"A message with Babyl-specific behaviors. Parameter *message* has the same "
"meaning as with the :class:`Message` constructor."
msgstr ""

#: ../../library/mailbox.rst:1340
msgid ""
"Certain message labels, called :dfn:`attributes`, are defined by convention "
"to have special meanings. The attributes are as follows:"
msgstr ""

#: ../../library/mailbox.rst:1344
msgid "Label"
msgstr ""

#: ../../library/mailbox.rst:1348
msgid "deleted"
msgstr ""

#: ../../library/mailbox.rst:1350
msgid "filed"
msgstr ""

#: ../../library/mailbox.rst:1350
msgid "Copied to another file or mailbox"
msgstr ""

#: ../../library/mailbox.rst:1352
msgid "answered"
msgstr ""

#: ../../library/mailbox.rst:1354
msgid "forwarded"
msgstr ""

#: ../../library/mailbox.rst:1354
msgid "Forwarded"
msgstr ""

#: ../../library/mailbox.rst:1356
msgid "edited"
msgstr ""

#: ../../library/mailbox.rst:1356
msgid "Modified by the user"
msgstr ""

#: ../../library/mailbox.rst:1358
msgid "resent"
msgstr ""

#: ../../library/mailbox.rst:1358
msgid "Resent"
msgstr ""

#: ../../library/mailbox.rst:1361
msgid ""
"By default, Rmail displays only visible headers. The :class:`!BabylMessage` "
"class, though, uses the original headers because they are more complete. "
"Visible headers may be accessed explicitly if desired."
msgstr ""

#: ../../library/mailbox.rst:1365
msgid ":class:`!BabylMessage` instances offer the following methods:"
msgstr ""

#: ../../library/mailbox.rst:1370
msgid "Return a list of labels on the message."
msgstr ""

#: ../../library/mailbox.rst:1375
msgid "Set the list of labels on the message to *labels*."
msgstr ""

#: ../../library/mailbox.rst:1380
msgid "Add *label* to the list of labels on the message."
msgstr ""

#: ../../library/mailbox.rst:1385
msgid "Remove *label* from the list of labels on the message."
msgstr ""

#: ../../library/mailbox.rst:1390
msgid ""
"Return a :class:`Message` instance whose headers are the message's visible "
"headers and whose body is empty."
msgstr ""

#: ../../library/mailbox.rst:1396
msgid ""
"Set the message's visible headers to be the same as the headers in "
"*message*.  Parameter *visible* should be a :class:`Message` instance, an :"
"class:`email.message.Message` instance, a string, or a file-like object "
"(which should be open in text mode)."
msgstr ""

#: ../../library/mailbox.rst:1404
msgid ""
"When a :class:`!BabylMessage` instance's original headers are modified, the "
"visible headers are not automatically modified to correspond. This method "
"updates the visible headers as follows: each visible header with a "
"corresponding original header is set to the value of the original header, "
"each visible header without a corresponding original header is removed, and "
"any of :mailheader:`Date`, :mailheader:`From`, :mailheader:`Reply-To`, :"
"mailheader:`To`, :mailheader:`CC`, and :mailheader:`Subject` that are "
"present in the original headers but not the visible headers are added to the "
"visible headers."
msgstr ""

#: ../../library/mailbox.rst:1414
msgid ""
"When a :class:`!BabylMessage` instance is created based upon a :class:"
"`MaildirMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1426
msgid "\"forwarded\" label"
msgstr ""

#: ../../library/mailbox.rst:1429
msgid ""
"When a :class:`!BabylMessage` instance is created based upon an :class:"
"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` "
"and :mailheader:`X-Status` headers are omitted and the following conversions "
"take place:"
msgstr ""

#: ../../library/mailbox.rst:1445
msgid ""
"When a :class:`!BabylMessage` instance is created based upon an :class:"
"`MHMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1460
msgid ":class:`!MMDFMessage` objects"
msgstr ":class:`!MMDFMessage` 物件"

#: ../../library/mailbox.rst:1465
msgid ""
"A message with MMDF-specific behaviors. Parameter *message* has the same "
"meaning as with the :class:`Message` constructor."
msgstr ""

#: ../../library/mailbox.rst:1468
msgid ""
"As with message in an mbox mailbox, MMDF messages are stored with the "
"sender's address and the delivery date in an initial line beginning with "
"\"From \".  Likewise, flags that indicate the state of the message are "
"typically stored in :mailheader:`Status` and :mailheader:`X-Status` headers."
msgstr ""

#: ../../library/mailbox.rst:1473
msgid ""
"Conventional flags for MMDF messages are identical to those of mbox message "
"and are as follows:"
msgstr ""

#: ../../library/mailbox.rst:1494
msgid ""
":class:`!MMDFMessage` instances offer the following methods, which are "
"identical to those offered by :class:`mboxMessage`:"
msgstr ""

#: ../../library/mailbox.rst:1543
msgid ""
"When an :class:`!MMDFMessage` instance is created based upon a :class:"
"`MaildirMessage` instance, a \"From \" line is generated based upon the :"
"class:`MaildirMessage` instance's delivery date, and the following "
"conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1562
msgid ""
"When an :class:`!MMDFMessage` instance is created based upon an :class:"
"`MHMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1577
msgid ""
"When an :class:`!MMDFMessage` instance is created based upon a :class:"
"`BabylMessage` instance, the following conversions take place:"
msgstr ""

#: ../../library/mailbox.rst:1592
msgid ""
"When an :class:`!MMDFMessage` instance is created based upon an :class:"
"`mboxMessage` instance, the \"From \" line is copied and all flags directly "
"correspond:"
msgstr ""

#: ../../library/mailbox.rst:1597
msgid ":class:`mboxMessage` state"
msgstr ""

#: ../../library/mailbox.rst:1612
msgid "Exceptions"
msgstr "例外"

#: ../../library/mailbox.rst:1614
msgid ""
"The following exception classes are defined in the :mod:`!mailbox` module:"
msgstr ""

#: ../../library/mailbox.rst:1619
msgid "The based class for all other module-specific exceptions."
msgstr ""

#: ../../library/mailbox.rst:1624
msgid ""
"Raised when a mailbox is expected but is not found, such as when "
"instantiating a :class:`Mailbox` subclass with a path that does not exist "
"(and with the *create* parameter set to ``False``), or when opening a folder "
"that does not exist."
msgstr ""

#: ../../library/mailbox.rst:1631
msgid ""
"Raised when a mailbox is not empty but is expected to be, such as when "
"deleting a folder that contains messages."
msgstr ""

#: ../../library/mailbox.rst:1637
msgid ""
"Raised when some mailbox-related condition beyond the control of the program "
"causes it to be unable to proceed, such as when failing to acquire a lock "
"that another program already holds a lock, or when a uniquely generated file "
"name already exists."
msgstr ""

#: ../../library/mailbox.rst:1645
msgid ""
"Raised when the data in a file cannot be parsed, such as when an :class:`MH` "
"instance attempts to read a corrupted :file:`.mh_sequences` file."
msgstr ""

#: ../../library/mailbox.rst:1652
msgid "Examples"
msgstr "範例"

#: ../../library/mailbox.rst:1654
msgid ""
"A simple example of printing the subjects of all messages in a mailbox that "
"seem interesting::"
msgstr ""

#: ../../library/mailbox.rst:1657
msgid ""
"import mailbox\n"
"for message in mailbox.mbox('~/mbox'):\n"
"    subject = message['subject']       # Could possibly be None.\n"
"    if subject and 'python' in subject.lower():\n"
"        print(subject)"
msgstr ""
"import mailbox\n"
"for message in mailbox.mbox('~/mbox'):\n"
"    subject = message['subject']       # 可能為 None.\n"
"    if subject and 'python' in subject.lower():\n"
"        print(subject)"

#: ../../library/mailbox.rst:1663
msgid ""
"To copy all mail from a Babyl mailbox to an MH mailbox, converting all of "
"the format-specific information that can be converted::"
msgstr ""

#: ../../library/mailbox.rst:1666
msgid ""
"import mailbox\n"
"destination = mailbox.MH('~/Mail')\n"
"destination.lock()\n"
"for message in mailbox.Babyl('~/RMAIL'):\n"
"    destination.add(mailbox.MHMessage(message))\n"
"destination.flush()\n"
"destination.unlock()"
msgstr ""
"import mailbox\n"
"destination = mailbox.MH('~/Mail')\n"
"destination.lock()\n"
"for message in mailbox.Babyl('~/RMAIL'):\n"
"    destination.add(mailbox.MHMessage(message))\n"
"destination.flush()\n"
"destination.unlock()"

#: ../../library/mailbox.rst:1674
msgid ""
"This example sorts mail from several mailing lists into different mailboxes, "
"being careful to avoid mail corruption due to concurrent modification by "
"other programs, mail loss due to interruption of the program, or premature "
"termination due to malformed messages in the mailbox::"
msgstr ""

#: ../../library/mailbox.rst:1679
msgid ""
"import mailbox\n"
"import email.errors\n"
"\n"
"list_names = ('python-list', 'python-dev', 'python-bugs')\n"
"\n"
"boxes = {name: mailbox.mbox('~/email/%s' % name) for name in list_names}\n"
"inbox = mailbox.Maildir('~/Maildir', factory=None)\n"
"\n"
"for key in inbox.iterkeys():\n"
"    try:\n"
"        message = inbox[key]\n"
"    except email.errors.MessageParseError:\n"
"        continue                # The message is malformed. Just leave it.\n"
"\n"
"    for name in list_names:\n"
"        list_id = message['list-id']\n"
"        if list_id and name in list_id:\n"
"            # Get mailbox to use\n"
"            box = boxes[name]\n"
"\n"
"            # Write copy to disk before removing original.\n"
"            # If there's a crash, you might duplicate a message, but\n"
"            # that's better than losing a message completely.\n"
"            box.lock()\n"
"            box.add(message)\n"
"            box.flush()\n"
"            box.unlock()\n"
"\n"
"            # Remove original message\n"
"            inbox.lock()\n"
"            inbox.discard(key)\n"
"            inbox.flush()\n"
"            inbox.unlock()\n"
"            break               # Found destination, so stop looking.\n"
"\n"
"for box in boxes.itervalues():\n"
"    box.close()"
msgstr ""