# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# 
# Translators:
# python-doc bot, 2025
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.9\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-22 21:56+0000\n"
"PO-Revision-Date: 2025-09-22 17:54+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh_CN\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/bz2.rst:2
msgid ":mod:`bz2` --- Support for :program:`bzip2` compression"
msgstr ":mod:`bz2` --- 对 :program:`bzip2` 压缩算法的支持"

#: ../../library/bz2.rst:12
msgid "**Source code:** :source:`Lib/bz2.py`"
msgstr "**源代码：** :source:`Lib/bz2.py`"

#: ../../library/bz2.rst:16
msgid ""
"This module provides a comprehensive interface for compressing and "
"decompressing data using the bzip2 compression algorithm."
msgstr "此模块提供了使用 bzip2 压缩算法压缩和解压数据的一套完整的接口。"

#: ../../library/bz2.rst:19
msgid "The :mod:`bz2` module contains:"
msgstr ":mod:`bz2` 模块包含："

#: ../../library/bz2.rst:21
msgid ""
"The :func:`.open` function and :class:`BZ2File` class for reading and "
"writing compressed files."
msgstr "用于读写压缩文件的 :func:`.open` 函数和 :class:`BZ2File` 类。"

#: ../../library/bz2.rst:23
msgid ""
"The :class:`BZ2Compressor` and :class:`BZ2Decompressor` classes for "
"incremental (de)compression."
msgstr "用于增量压缩和解压的 :class:`BZ2Compressor` 和 :class:`BZ2Decompressor` 类。"

#: ../../library/bz2.rst:25
msgid ""
"The :func:`compress` and :func:`decompress` functions for one-shot "
"(de)compression."
msgstr "用于一次性压缩和解压的 :func:`compress` 和 :func:`decompress` 函数。"

#: ../../library/bz2.rst:28
msgid ""
"All of the classes in this module may safely be accessed from multiple "
"threads."
msgstr ""

#: ../../library/bz2.rst:32
msgid "(De)compression of files"
msgstr "文件压缩和解压"

#: ../../library/bz2.rst:36
msgid ""
"Open a bzip2-compressed file in binary or text mode, returning a :term:`file"
" object`."
msgstr "以二进制或文本模式打开 bzip2 压缩文件，返回一个 :term:`file object`。"

#: ../../library/bz2.rst:39
msgid ""
"As with the constructor for :class:`BZ2File`, the *filename* argument can be"
" an actual filename (a :class:`str` or :class:`bytes` object), or an "
"existing file object to read from or write to."
msgstr ""
"和 :class:`BZ2File` 的构造函数类似，*filename* 参数可以是一个实际的文件名（:class:`str` 或 "
":class:`bytes` 对象），或是已有的可供读取或写入的文件对象。"

#: ../../library/bz2.rst:43
msgid ""
"The *mode* argument can be any of ``'r'``, ``'rb'``, ``'w'``, ``'wb'``, "
"``'x'``, ``'xb'``, ``'a'`` or ``'ab'`` for binary mode, or ``'rt'``, "
"``'wt'``, ``'xt'``, or ``'at'`` for text mode. The default is ``'rb'``."
msgstr ""
"*mode* 参数可设为二进制模式的 "
"``'r'``、``'rb'``、``'w'``、``'wb'``、``'x'``、``'xb'``、``'a'`` 或 "
"``'ab'``，或者文本模式的 ``'rt'``、``'wt'``、``'xt'`` 或 ``'at'``。默认是 ``'rb'``。"

#: ../../library/bz2.rst:47
msgid ""
"The *compresslevel* argument is an integer from 1 to 9, as for the "
":class:`BZ2File` constructor."
msgstr "*compresslevel* 参数是 1 到 9 的整数，和 :class:`BZ2File` 的构造函数一样。"

#: ../../library/bz2.rst:50
msgid ""
"For binary mode, this function is equivalent to the :class:`BZ2File` "
"constructor: ``BZ2File(filename, mode, compresslevel=compresslevel)``. In "
"this case, the *encoding*, *errors* and *newline* arguments must not be "
"provided."
msgstr ""
"对于二进制模式，这个函数等价于 :class:`BZ2File` 构造器: ``BZ2File(filename, mode, "
"compresslevel=compresslevel)``。 在这种情况下，不可提供 *encoding*, *errors* 和 *newline*"
" 参数。"

#: ../../library/bz2.rst:55
msgid ""
"For text mode, a :class:`BZ2File` object is created, and wrapped in an "
":class:`io.TextIOWrapper` instance with the specified encoding, error "
"handling behavior, and line ending(s)."
msgstr ""
"对于文本模式，将会创建一个 :class:`BZ2File` 对象，并将它包装到一个 :class:`io.TextIOWrapper` "
"实例中，此实例带有指定的编码格式、错误处理行为和行结束符。"

#: ../../library/bz2.rst:61 ../../library/bz2.rst:126
msgid "The ``'x'`` (exclusive creation) mode was added."
msgstr "添加了 ``'x'`` (单独创建) 模式。"

#: ../../library/bz2.rst:64 ../../library/bz2.rst:133
msgid "Accepts a :term:`path-like object`."
msgstr "接受一个 :term:`path-like object`。"

#: ../../library/bz2.rst:70
msgid "Open a bzip2-compressed file in binary mode."
msgstr "用二进制模式打开 bzip2 压缩文件。"

#: ../../library/bz2.rst:72
msgid ""
"If *filename* is a :class:`str` or :class:`bytes` object, open the named "
"file directly. Otherwise, *filename* should be a :term:`file object`, which "
"will be used to read or write the compressed data."
msgstr ""
"如果 *filename* 是一个 :class:`str` 或 :class:`bytes` 对象，则打开名称对应的文件目录。 "
"否则的话，*filename* 应当是一个 :term:`file object`，它将被用来读取或写入压缩数据。"

#: ../../library/bz2.rst:76
msgid ""
"The *mode* argument can be either ``'r'`` for reading (default), ``'w'`` for"
" overwriting, ``'x'`` for exclusive creation, or ``'a'`` for appending. "
"These can equivalently be given as ``'rb'``, ``'wb'``, ``'xb'`` and ``'ab'``"
" respectively."
msgstr ""
"*mode* 参数可以是表示读取的 ``'r'`` (默认值)，表示覆写的 ``'w'``，表示单独创建的 ``'x'``，或表示添加的 "
"``'a'``。 这些模式还可分别以 ``'rb'``, ``'wb'``, ``'xb'`` 和 ``'ab'`` 的等价形式给出。"

#: ../../library/bz2.rst:81
msgid ""
"If *filename* is a file object (rather than an actual file name), a mode of "
"``'w'`` does not truncate the file, and is instead equivalent to ``'a'``."
msgstr "如果 *filename* 是一个文件对象（而不是实际的文件名），则 ``'w'`` 模式并不会截断文件，而是会等价于 ``'a'``。"

#: ../../library/bz2.rst:84
msgid ""
"If *mode* is ``'w'`` or ``'a'``, *compresslevel* can be an integer between "
"``1`` and ``9`` specifying the level of compression: ``1`` produces the "
"least compression, and ``9`` (default) produces the most compression."
msgstr ""
"如果 *mode* 为 ``'w'`` 或 ``'a'``，则 *compresslevel* 可以是 ``1`` 到 ``9`` "
"之间的整数，用于指定压缩等级: ``1`` 产生最低压缩率，而 ``9`` (默认值) 产生最高压缩率。"

#: ../../library/bz2.rst:88
msgid ""
"If *mode* is ``'r'``, the input file may be the concatenation of multiple "
"compressed streams."
msgstr "如果 *mode* 为 ``'r'``，则输入文件可以为多个压缩流的拼接。"

#: ../../library/bz2.rst:91
msgid ""
":class:`BZ2File` provides all of the members specified by the "
":class:`io.BufferedIOBase`, except for :meth:`detach` and :meth:`truncate`. "
"Iteration and the :keyword:`with` statement are supported."
msgstr ""
":class:`BZ2File` 提供了 :class:`io.BufferedIOBase` 所指定的所有成员，但 :meth:`detach` 和 "
":meth:`truncate` 除外。 并支持迭代和 :keyword:`with` 语句。"

#: ../../library/bz2.rst:95
msgid ":class:`BZ2File` also provides the following method:"
msgstr ":class:`BZ2File` 还提供了以下方法："

#: ../../library/bz2.rst:99
msgid ""
"Return buffered data without advancing the file position. At least one byte "
"of data will be returned (unless at EOF). The exact number of bytes returned"
" is unspecified."
msgstr "返回缓冲的数据而不前移文件位置。 至少将返回一个字节的数据（除非为 EOF）。 实际返回的字节数不确定。"

#: ../../library/bz2.rst:103
msgid ""
"While calling :meth:`peek` does not change the file position of the "
":class:`BZ2File`, it may change the position of the underlying file object "
"(e.g. if the :class:`BZ2File` was constructed by passing a file object for "
"*filename*)."
msgstr ""
"虽然调用 :meth:`peek` 不会改变 :class:`BZ2File` 的文件位置，但它可能改变下层文件对象的位置（举例来说如果 "
":class:`BZ2File` 是通过传入一个文件对象作为 *filename* 的话）。"

#: ../../library/bz2.rst:111
msgid "Support for the :keyword:`with` statement was added."
msgstr "添加了对 :keyword:`with` 语句的支持。"

#: ../../library/bz2.rst:114
msgid ""
"The :meth:`fileno`, :meth:`readable`, :meth:`seekable`, :meth:`writable`, "
":meth:`read1` and :meth:`readinto` methods were added."
msgstr ""
"添加了 :meth:`fileno`, :meth:`readable`, :meth:`seekable`, :meth:`writable`, "
":meth:`read1` 和 :meth:`readinto` 方法。"

#: ../../library/bz2.rst:118
msgid ""
"Support was added for *filename* being a :term:`file object` instead of an "
"actual filename."
msgstr "添加了对 *filename* 使用 :term:`file object` 而非实际文件名的支持。"

#: ../../library/bz2.rst:122
msgid ""
"The ``'a'`` (append) mode was added, along with support for reading multi-"
"stream files."
msgstr "添加了 ``'a'`` (append) 模式，以及对读取多数据流文件的支持。"

#: ../../library/bz2.rst:129
msgid ""
"The :meth:`~io.BufferedIOBase.read` method now accepts an argument of "
"``None``."
msgstr ":meth:`~io.BufferedIOBase.read` 方法现在接受 ``None`` 作为参数。"

#: ../../library/bz2.rst:136
msgid ""
"The *buffering* parameter has been removed. It was ignored and deprecated "
"since Python 3.0. Pass an open file object to control how the file is "
"opened."
msgstr "*buffering* 形参已被移除。 它自 Python 3.0 起即被忽略并弃用。 请传入一个打开文件对象来控制文件的打开方式。"

#: ../../library/bz2.rst:141
msgid "The *compresslevel* parameter became keyword-only."
msgstr "*compresslevel* 形参成为仅限关键字参数。"

#: ../../library/bz2.rst:145
msgid "Incremental (de)compression"
msgstr "增量压缩和解压"

#: ../../library/bz2.rst:149
msgid ""
"Create a new compressor object. This object may be used to compress data "
"incrementally. For one-shot compression, use the :func:`compress` function "
"instead."
msgstr "创建一个新的压缩器对象。 此对象可被用来执行增量数据压缩。 对于一次性压缩，请改用 :func:`compress` 函数。"

#: ../../library/bz2.rst:153 ../../library/bz2.rst:241
msgid ""
"*compresslevel*, if given, must be an integer between ``1`` and ``9``. The "
"default is ``9``."
msgstr "如果给定 *compresslevel*，它必须为 ``1`` 至 ``9`` 之间的整数。 默认值为 ``9``。"

#: ../../library/bz2.rst:158
msgid ""
"Provide data to the compressor object. Returns a chunk of compressed data if"
" possible, or an empty byte string otherwise."
msgstr "向压缩器对象提供数据。 在可能的情况下返回一段已压缩数据，否则返回空字节串。"

#: ../../library/bz2.rst:161
msgid ""
"When you have finished providing data to the compressor, call the "
":meth:`flush` method to finish the compression process."
msgstr "当你已结束向压缩器提供数据时，请调用 :meth:`flush` 方法来完成压缩进程。"

#: ../../library/bz2.rst:167
msgid ""
"Finish the compression process. Returns the compressed data left in internal"
" buffers."
msgstr "结束压缩进程，返回内部缓冲中剩余的压缩完成的数据。"

#: ../../library/bz2.rst:170
msgid ""
"The compressor object may not be used after this method has been called."
msgstr "调用此方法之后压缩器对象将不可再被使用。"

#: ../../library/bz2.rst:175
msgid ""
"Create a new decompressor object. This object may be used to decompress data"
" incrementally. For one-shot compression, use the :func:`decompress` "
"function instead."
msgstr "创建一个新的解压缩器对象。 此对象可被用来执行增量数据解压缩。 对于一次性解压缩，请改用 :func:`decompress` 函数。"

#: ../../library/bz2.rst:180
msgid ""
"This class does not transparently handle inputs containing multiple "
"compressed streams, unlike :func:`decompress` and :class:`BZ2File`. If you "
"need to decompress a multi-stream input with :class:`BZ2Decompressor`, you "
"must use a new decompressor for each stream."
msgstr ""
"这个类不会透明地处理包含多个已压缩数据流的输入，这不同于 :func:`decompress` 和 :class:`BZ2File`。 如果你需要通过 "
":class:`BZ2Decompressor` 来解压缩多个数据流输入，你必须为每个数据流都使用新的解压缩器。"

#: ../../library/bz2.rst:187
msgid ""
"Decompress *data* (a :term:`bytes-like object`), returning uncompressed data"
" as bytes. Some of *data* may be buffered internally, for use in later calls"
" to :meth:`decompress`. The returned data should be concatenated with the "
"output of any previous calls to :meth:`decompress`."
msgstr ""
"解压缩 *data* (一个 :term:`bytes-like object`)，返回字节串形式的解压缩数据。 某些 *data* "
"可以在内部被缓冲，以便用于后续的 :meth:`decompress` 调用。 返回的数据应当与之前任何 :meth:`decompress` "
"调用的输出进行拼接。"

#: ../../library/bz2.rst:193
msgid ""
"If *max_length* is nonnegative, returns at most *max_length* bytes of "
"decompressed data. If this limit is reached and further output can be "
"produced, the :attr:`~.needs_input` attribute will be set to ``False``. In "
"this case, the next call to :meth:`~.decompress` may provide *data* as "
"``b''`` to obtain more of the output."
msgstr ""
"如果 *max_length* 为非负数，将返回至多 *max_length* 个字节的解压缩数据。 如果达到此限制并且可以产生后续输出，则 "
":attr:`~.needs_input` 属性将被设为 ``False``。 在这种情况下，下一次 :meth:`~.decompress` "
"调用提供的 *data* 可以为 ``b''`` 以获取更多的输出。"

#: ../../library/bz2.rst:200
msgid ""
"If all of the input data was decompressed and returned (either because this "
"was less than *max_length* bytes, or because *max_length* was negative), the"
" :attr:`~.needs_input` attribute will be set to ``True``."
msgstr ""
"如果所有输入数据都已被解压缩并返回（或是因为它少于 *max_length* 个字节，或是因为 *max_length* 为负数），则 "
":attr:`~.needs_input` 属性将被设为 ``True``。"

#: ../../library/bz2.rst:205
msgid ""
"Attempting to decompress data after the end of stream is reached raises an "
"`EOFError`.  Any data found after the end of the stream is ignored and saved"
" in the :attr:`~.unused_data` attribute."
msgstr ""

#: ../../library/bz2.rst:209
msgid "Added the *max_length* parameter."
msgstr "添加了 *max_length* 形参。"

#: ../../library/bz2.rst:214
msgid "``True`` if the end-of-stream marker has been reached."
msgstr "若达到了数据流的末尾标记则为 ``True``。"

#: ../../library/bz2.rst:221
msgid "Data found after the end of the compressed stream."
msgstr "在压缩数据流的末尾之后获取的数据。"

#: ../../library/bz2.rst:223
msgid ""
"If this attribute is accessed before the end of the stream has been reached,"
" its value will be ``b''``."
msgstr "如果在达到数据流末尾之前访问此属性，其值将为 ``b''``。"

#: ../../library/bz2.rst:228
msgid ""
"``False`` if the :meth:`.decompress` method can provide more decompressed "
"data before requiring new uncompressed input."
msgstr "如果在要求新的未解压缩输入之前 :meth:`.decompress` 方法可以提供更多的解压缩数据则为 ``False``。"

#: ../../library/bz2.rst:235
msgid "One-shot (de)compression"
msgstr "一次性压缩或解压缩"

#: ../../library/bz2.rst:239
msgid "Compress *data*, a :term:`bytes-like object <bytes-like object>`."
msgstr "压缩 *data*，此参数为一个 :term:`字节类对象 <bytes-like object>`。"

#: ../../library/bz2.rst:244
msgid "For incremental compression, use a :class:`BZ2Compressor` instead."
msgstr "对于增量压缩，请改用 :class:`BZ2Compressor`。"

#: ../../library/bz2.rst:249
msgid "Decompress *data*, a :term:`bytes-like object <bytes-like object>`."
msgstr "解压缩 *data*，此参数为一个 :term:`字节类对象 <bytes-like object>`。"

#: ../../library/bz2.rst:251
msgid ""
"If *data* is the concatenation of multiple compressed streams, decompress "
"all of the streams."
msgstr "如果 *data* 是多个压缩数据流的拼接，则解压缩所有数据流。"

#: ../../library/bz2.rst:254
msgid "For incremental decompression, use a :class:`BZ2Decompressor` instead."
msgstr "对于增量解压缩，请改用 :class:`BZ2Decompressor`。"

#: ../../library/bz2.rst:256
msgid "Support for multi-stream inputs was added."
msgstr "支持了多数据流的输入。"

#: ../../library/bz2.rst:262
msgid "Examples of usage"
msgstr "用法示例"

#: ../../library/bz2.rst:264
msgid "Below are some examples of typical usage of the :mod:`bz2` module."
msgstr "以下是 :mod:`bz2` 模块典型用法的一些示例。"

#: ../../library/bz2.rst:266
msgid ""
"Using :func:`compress` and :func:`decompress` to demonstrate round-trip "
"compression:"
msgstr "使用 :func:`compress` 和 :func:`decompress` 来显示往复式的压缩："

#: ../../library/bz2.rst:284
msgid "Using :class:`BZ2Compressor` for incremental compression:"
msgstr "使用 :class:`BZ2Compressor` 进行增量压缩："

#: ../../library/bz2.rst:302
msgid ""
"The example above uses a very \"nonrandom\" stream of data (a stream of "
"`b\"z\"` chunks).  Random data tends to compress poorly, while ordered, "
"repetitive data usually yields a high compression ratio."
msgstr ""

#: ../../library/bz2.rst:306
msgid "Writing and reading a bzip2-compressed file in binary mode:"
msgstr "用二进制模式写入和读取 bzip2 压缩文件："