python-docs-zh-cn/c-api/bytes.po at 3.13 · python/python-docs-zh-cn

429 lines (359 loc) · 16.9 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2026, 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
# Freesand Leo <yuqinju@163.com>, 2026
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-11 16:34+0000\n"
"PO-Revision-Date: 2025-09-15 01:03+0000\n"
"Last-Translator: Freesand Leo <yuqinju@163.com>, 2026\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"
#: ../../c-api/bytes.rst:6
msgid "Bytes Objects"
msgstr "bytes 对象"
#: ../../c-api/bytes.rst:8
"These functions raise :exc:`TypeError` when expecting a bytes parameter and "
"called with a non-bytes parameter."
msgstr "这些函数在期望附带一个字节串形参但却附带了一个非字节串形参被调用时会引发 :exc:`TypeError`。"
#: ../../c-api/bytes.rst:16
msgid "This subtype of :c:type:`PyObject` represents a Python bytes object."
msgstr "这种 :c:type:`PyObject` 的子类型表示一个 Python 字节对象。"
#: ../../c-api/bytes.rst:21
"This instance of :c:type:`PyTypeObject` represents the Python bytes type; it"
" is the same object as :class:`bytes` in the Python layer."
":c:type:`PyTypeObject` 的实例代表一个 Python 字节类型，在 Python 层面它与 :class:`bytes` "
#: ../../c-api/bytes.rst:27
"Return true if the object *o* is a bytes object or an instance of a subtype "
"of the bytes type.  This function always succeeds."
msgstr "如果对象 *o* 是一个 bytes 对象或者 bytes 类型的子类型的实例则返回真值。 此函数总是会成功执行。"
#: ../../c-api/bytes.rst:33
"Return true if the object *o* is a bytes object, but not an instance of a "
"subtype of the bytes type.  This function always succeeds."
msgstr "如果对象 *o* 是一个 bytes 对象但不是 bytes 类型的子类型的实例则返回真值。 此函数总是会成功执行。"
#: ../../c-api/bytes.rst:39
"Return a new bytes object with a copy of the string *v* as value on success,"
" and ``NULL`` on failure.  The parameter *v* must not be ``NULL``; it will "
"not be checked."
"成功时返回一个以字符串 *v* 的副本为值的新字节串对象，失败时返回 ``NULL``。 形参 *v* 不可为 ``NULL``；它不会被检查。"
#: ../../c-api/bytes.rst:46
"Return a new bytes object with a copy of the string *v* as value and length "
"*len* on success, and ``NULL`` on failure.  If *v* is ``NULL``, the contents"
" of the bytes object are uninitialized."
"成功时返回一个以字符串 *v* 的副本为值且长度为 *len* 的新字节串对象，失败时返回 ``NULL``。 如果 *v* 为 "
"``NULL``，则不初始化字节串对象的内容。"
#: ../../c-api/bytes.rst:53
"Take a C :c:func:`printf`\\ -style *format* string and a variable number of "
"arguments, calculate the size of the resulting Python bytes object and "
"return a bytes object with the values formatted into it.  The variable "
"arguments must be C types and must correspond exactly to the format "
"characters in the *format* string.  The following format characters are "
"接受一个 C :c:func:`printf` 风格的 *format* 字符串和可变数量的参数，计算结果 Python "
"字节串对象的大小并返回参数值经格式化后的字节串对象。 可变数量的参数必须均为 C 类型并且必须恰好与 *format* 字符串中的格式字符相对应。 "
"允许使用下列格式字符串:"
#: ../../c-api/bytes.rst:65
msgid "Format Characters"
msgstr "格式字符"
#: ../../c-api/bytes.rst:65
msgid "Type"
msgstr "类型"
#: ../../c-api/bytes.rst:65
msgid "Comment"
msgstr "注释"
#: ../../c-api/bytes.rst:67
msgid "``%%``"
msgstr "``%%``"
#: ../../c-api/bytes.rst:67
msgid "*n/a*"
msgstr "*不适用*"
#: ../../c-api/bytes.rst:67
msgid "The literal % character."
msgstr "文字%字符。"
#: ../../c-api/bytes.rst:69
msgid "``%c``"
msgstr "``%c``"
#: ../../c-api/bytes.rst:69 ../../c-api/bytes.rst:72 ../../c-api/bytes.rst:90
#: ../../c-api/bytes.rst:93
msgid "int"
msgstr "int"
#: ../../c-api/bytes.rst:69
msgid "A single byte, represented as a C int."
msgstr "一个字节，被表示为一个 C 语言的整型"
#: ../../c-api/bytes.rst:72
msgid "``%d``"
msgstr "``%d``"
#: ../../c-api/bytes.rst:72
msgid "Equivalent to ``printf(\"%d\")``. [1]_"
msgstr "相当于 ``printf(\"%d\")``. [1]_"
#: ../../c-api/bytes.rst:75
msgid "``%u``"
msgstr "``%u``"
#: ../../c-api/bytes.rst:75
msgid "unsigned int"
msgstr "unsigned int"
#: ../../c-api/bytes.rst:75
msgid "Equivalent to ``printf(\"%u\")``. [1]_"
msgstr "相当于 ``printf(\"%u\")``. [1]_"
#: ../../c-api/bytes.rst:78
msgid "``%ld``"
msgstr "``%ld``"
#: ../../c-api/bytes.rst:78
msgid "long"
msgstr "长整型"
#: ../../c-api/bytes.rst:78
msgid "Equivalent to ``printf(\"%ld\")``. [1]_"
msgstr "相当于 ``printf(\"%ld\")``. [1]_"
#: ../../c-api/bytes.rst:81
msgid "``%lu``"
msgstr "``%lu``"
#: ../../c-api/bytes.rst:81
msgid "unsigned long"
msgstr "unsigned long"
#: ../../c-api/bytes.rst:81
msgid "Equivalent to ``printf(\"%lu\")``. [1]_"
msgstr "相当于 ``printf(\"%lu\")``. [1]_"
#: ../../c-api/bytes.rst:84
msgid "``%zd``"
msgstr "``%zd``"
#: ../../c-api/bytes.rst:84
msgid ":c:type:`\\ Py_ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"
#: ../../c-api/bytes.rst:84
msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
msgstr "相当于 ``printf(\"%zd\")``. [1]_"
#: ../../c-api/bytes.rst:87
msgid "``%zu``"
msgstr "``%zu``"
#: ../../c-api/bytes.rst:87
msgid "size_t"
msgstr "size_t"
#: ../../c-api/bytes.rst:87
msgid "Equivalent to ``printf(\"%zu\")``. [1]_"
msgstr "相当于 ``printf(\"%zu\")``. [1]_"
#: ../../c-api/bytes.rst:90
msgid "``%i``"
msgstr "``%i``"
#: ../../c-api/bytes.rst:90
msgid "Equivalent to ``printf(\"%i\")``. [1]_"
msgstr "相当于 ``printf(\"%i\")``. [1]_"
#: ../../c-api/bytes.rst:93
msgid "``%x``"
msgstr "``%x``"
#: ../../c-api/bytes.rst:93
msgid "Equivalent to ``printf(\"%x\")``. [1]_"
msgstr "相当于 ``printf(\"%x\")``. [1]_"
#: ../../c-api/bytes.rst:96
msgid "``%s``"
msgstr "``%s``"
#: ../../c-api/bytes.rst:96
msgid "const char\\*"
msgstr "const char\\*"
#: ../../c-api/bytes.rst:96
msgid "A null-terminated C character array."
msgstr "以 null 为终止符的 C 字符数组。"
#: ../../c-api/bytes.rst:99
msgid "``%p``"
msgstr "``%p``"
#: ../../c-api/bytes.rst:99
msgid "const void\\*"
msgstr "const void\\*"
#: ../../c-api/bytes.rst:99
"The hex representation of a C pointer. Mostly equivalent to "
"``printf(\"%p\")`` except that it is guaranteed to start with the literal "
"``0x`` regardless of what the platform's ``printf`` yields."
"一个 C 指针的十六进制表示形式。 基本等价于 ``printf(\"%p\")`` 但它会确保以字面值 ``0x`` 开头，不论系统平台上 "
"``printf`` 的输出是什么。"
#: ../../c-api/bytes.rst:108
"An unrecognized format character causes all the rest of the format string to"
" be copied as-is to the result object, and any extra arguments discarded."
msgstr "无法识别的格式字符会导致将格式字符串的其余所有内容原样复制到结果对象，并丢弃所有多余的参数。"
#: ../../c-api/bytes.rst:111
"For integer specifiers (d, u, ld, lu, zd, zu, i, x): the 0-conversion flag "
"has effect even when a precision is given."
msgstr "对于整数说明符（d，u，ld，lu，zd，zu，i，x）：当给出精度时，0 转换标志是有效的。"
#: ../../c-api/bytes.rst:117
"Identical to :c:func:`PyBytes_FromFormat` except that it takes exactly two "
"arguments."
msgstr "与 :c:func:`PyBytes_FromFormat` 完全相同，除了它需要两个参数。"
#: ../../c-api/bytes.rst:123
"Return the bytes representation of object *o* that implements the buffer "
"protocol."
msgstr "返回字节表示实现缓冲区协议的对象*o*。"
#: ../../c-api/bytes.rst:129
msgid "Return the length of the bytes in bytes object *o*."
msgstr "返回字节对象*o*中字节的长度。"
#: ../../c-api/bytes.rst:134
msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."
msgstr "类似于 :c:func:`PyBytes_Size`，但是不带错误检测。"
#: ../../c-api/bytes.rst:139
"Return a pointer to the contents of *o*.  The pointer refers to the internal"
" buffer of *o*, which consists of ``len(o) + 1`` bytes.  The last byte in "
"the buffer is always null, regardless of whether there are any other null "
"bytes.  The data must not be modified in any way, unless the object was just"
" created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be "
"deallocated.  If *o* is not a bytes object at all, "
":c:func:`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`."
"返回对应 *o* 的内容的指针。 该指针指向 *o* 的内部缓冲区，其中包含 ``len(o) + 1`` 个字节。 "
"缓冲区的最后一个字节总是为空，不论是否存在其他空字节。 该数据不可通过任何形式来修改，除非是刚使用 "
"``PyBytes_FromStringAndSize(NULL, size)`` 创建该对象。 它不可被撤销分配。 如果 *o* "
"根本不是一个字节串对象，则 :c:func:`PyBytes_AsString` 将返回 ``NULL`` 并引发 :exc:`TypeError`。"
#: ../../c-api/bytes.rst:151
msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."
msgstr "类似于 :c:func:`PyBytes_AsString`，但是不带错误检测。"
#: ../../c-api/bytes.rst:156
"Return the null-terminated contents of the object *obj* through the output "
"variables *buffer* and *length*. Returns ``0`` on success."
msgstr "通过输出变量 *buffer* 和 *length* 返回对象 *obj* 以空值作为结束的内容。 成功时返回 ``0``。"
#: ../../c-api/bytes.rst:160
"If *length* is ``NULL``, the bytes object may not contain embedded null "
"bytes; if it does, the function returns ``-1`` and a :exc:`ValueError` is "
"如果 *length* 为 ``NULL``，字节串对象就不包含嵌入的空字节；如果包含，则该函数将返回 ``-1`` 并引发 "
":exc:`ValueError`。"
#: ../../c-api/bytes.rst:164
"The buffer refers to an internal buffer of *obj*, which includes an "
"additional null byte at the end (not counted in *length*).  The data must "
"not be modified in any way, unless the object was just created using "
"``PyBytes_FromStringAndSize(NULL, size)``.  It must not be deallocated.  If "
"*obj* is not a bytes object at all, :c:func:`PyBytes_AsStringAndSize` "
"returns ``-1`` and raises :exc:`TypeError`."
"该缓冲区指向 *obj* 的内部缓冲，它的末尾包含一个额外的空字节（不算在 *length* 当中）。 该数据不可通过任何方式来修改，除非是刚使用 "
"``PyBytes_FromStringAndSize(NULL, size)`` 创建该对象。 它不可被撤销分配。 如果 *obj* "
"根本不是一个字节串对象，则 :c:func:`PyBytes_AsStringAndSize` 将返回 ``-1`` 并引发 "
":exc:`TypeError`。"
#: ../../c-api/bytes.rst:171
"Previously, :exc:`TypeError` was raised when embedded null bytes were "
"encountered in the bytes object."
msgstr "以前，当字节串对象中出现嵌入的空字节时将引发 :exc:`TypeError`。"
#: ../../c-api/bytes.rst:178
"Create a new bytes object in *\\*bytes* containing the contents of *newpart*"
" appended to *bytes*; the caller will own the new reference. The reference "
"to the old value of *bytes* will be \":term:`stolen <steal>`\". If the new "
"object cannot be created, the old reference to *bytes* will still be "
"\"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the "
"appropriate exception will be set."
"Create a new bytes object 在 *\\*bytes* 中创建一个新的 bytes 对象其中包含将 *newpart* "
"的内容追加到 *bytes* 的结果；调用方将拥有这个新引用。 对 *bytes* 旧值的引用将被 \":term:`偷取 <steal>`\"。 "
"如果无法创建新对象，对指向 *bytes* 的旧引用仍然会被 \"偷取\"，*\\*bytes* 的值将被设为 ``NULL``，并将设置适当的异常。"
#: ../../c-api/bytes.rst:188
"Create a new bytes object in *\\*bytes* containing the contents of *newpart*"
" appended to *bytes*.  This version releases the :term:`strong reference` to"
" *newpart* (i.e. decrements its reference count)."
"在 *\\*bytes* 中创建一个新的字节串对象，其中包含添加到 *bytes* 的 *newpart* 的内容。 此版本将释放对 *newpart*"
" 的 :term:`strong reference` (即递减其引用计数)。"
#: ../../c-api/bytes.rst:195
"Resize a bytes object. *newsize* will be the new length of the bytes object."
" You can think of it as creating a new bytes object and destroying the old "
"one, only more efficiently. Pass the address of an existing bytes object as "
"an lvalue (it may be written into), and the new size desired.  On success, "
"*\\*bytes* holds the resized bytes object and ``0`` is returned; the address"
" in *\\*bytes* may differ from its input value.  If the reallocation fails, "
"the original bytes object at *\\*bytes* is deallocated, *\\*bytes* is set to"
" ``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned."
"改变字节串对象的大小。 *newsize* 将为字节串对象的新长度。 你可以将它当作是创建一个新的字节串对象并销毁旧的对象，但是更为高效。 "
"传入一个现有字节串对象的地址作为 lvalue（它可以被写入），以及想要的新大小。 当成功时，*\\*bytes* 将存放改变大小后的字节串对象并返回 "
"``0``；*\\*bytes* 中的地址可能与其输入值不同。 如果重新分配失败，则位于 *\\*bytes* "
"的原始字节串对象将被释放，*\\*bytes* 将被设为 ``NULL``，同时设置 :exc:`MemoryError`，然后返回 ``-1``。"
#: ../../c-api/bytes.rst:209
"Get the string representation of *bytes*. This function is currently used to"
" implement :meth:`!bytes.__repr__` in Python."
msgstr "获取 *bytes* 的字符串表示形式。 此函数目前被用于实现 Python 中的 :meth:`!bytes.__repr__`。"
#: ../../c-api/bytes.rst:212
"This function does not do type checking; it is undefined behavior to pass "
"*bytes* as a non-bytes object or ``NULL``."
msgstr "此函数不会进行类型检测；向 *bytes* 传入非字节对象或 ``NULL`` 是未定义的行为。"
#: ../../c-api/bytes.rst:215
"If *smartquotes* is true, the representation will use a double-quoted string"
" instead of single-quoted string when single-quotes are present in *bytes*. "
"For example, the byte string ``'Python'`` would be represented as "
"``b\"'Python'\"`` when *smartquotes* is true, or ``b'\\'Python\\''`` when it"
" is false."
"如果 *smartquotes* 为真值，表示形式将在 *bytes* 中存在单引号时使用带双引号的字符串而不是带单引号的字符串。 例如，当 "
"*smartquotes* 为真值时字节串 ``'Python'`` 将被表示为 ``b\"'Python'\"``，当其为假值时则为 "
"``b'\\'Python\\''``。"
#: ../../c-api/bytes.rst:221
"On success, this function returns a :term:`strong reference` to a "
":class:`str` object containing the representation. On failure, this returns "
"``NULL`` with an exception set."
"成功时，此函数将返回一个指向包含该表示形式的 :class:`str` 对象的 :term:`strong reference`。 失败时，此函数将返回"
" ``NULL`` 并设置一个异常。"
#: ../../c-api/bytes.rst:228
"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* "
"must be the size of *s*."
msgstr "取消带反斜杠转义的字符串 *s* 的转义。 *s* 必须不为 ``NULL``。 *len* 必须为 *s* 的长度。"
#: ../../c-api/bytes.rst:231
"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. "
"If *errors* is ``NULL``, then ``\"strict\"`` is used by default."
"*errors* 必须为 ``\"strict\"``, ``\"replace\"`` 或 ``\"ignore\"`` 之一。 如果 "
"*errors* 为 ``NULL``，则默认使用 ``\"strict\"``。"
#: ../../c-api/bytes.rst:234
"On success, this function returns a :term:`strong reference` to a Python "
":class:`bytes` object containing the unescaped string. On failure, this "
"function returns ``NULL`` with an exception set."
"成功时，此函数将返回一个指向包含未转义文本的 Python :class:`bytes` 对象的 :term:`strong reference`。 "
"失败时，此函数将返回 ``NULL`` 并设置一个异常。"
#: ../../c-api/bytes.rst:238
msgid "*unicode* and *recode_encoding* are now unused."
msgstr "*unicode* 和 *recode_encoding* 现在未被使用。"
#: ../../c-api/bytes.rst:11
msgid "object"
msgstr "object -- 对象"
#: ../../c-api/bytes.rst:11
msgid "bytes"
msgstr "字节串"
Navigation Menu

Uh oh!

Uh oh!

Uh oh!

Uh oh!

FilesExpand file tree

bytes.po

Latest commit

History

bytes.po

File metadata and controls
