# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2023, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# ppcfish <ppcfish@gmail.com>, 2019

# 8af080f2e6702c64bedd01873aed27e8_25aec74 <fd99d14239138a1f987c22e7736dde81_777475>, 2019

# 1lin24 <1lin24@sina.com>, 2019

# 伟 裴 <sky_wander@outlook.com>, 2020

# 高乐喆 <gaolezhe@outlook.com>, 2023

# Freesand Leo <yuqinju@163.com>, 2023

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.7\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-06-23 16:56+0000\n"

"PO-Revision-Date: 2019-09-01 03:41+0000\n"

"Last-Translator: Freesand Leo <yuqinju@163.com>, 2023\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"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:6

msgid "Unicode Objects and Codecs"

msgstr "Unicode对象和编码解码器"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:12

msgid "Unicode Objects"

msgstr "Unicode对象"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:14

msgid ""

"Since the implementation of :pep:`393` in Python 3.3, Unicode objects "

"internally use a variety of representations, in order to allow handling the "

"complete range of Unicode characters while staying memory efficient. There "

"are special cases for strings where all code points are below 128, 256, or "

"65536; otherwise, code points must be below 1114112 (which is the full "

"Unicode range)."

msgstr ""

"自从python3.3中实现了:pep:`393` "

"以来，Unicode对象在内部使用各种表示形式，以便在保持内存效率的同时处理完整范围的Unicode字符。对于所有代码点都低于128、256或65536的字符串，有一些特殊情况；否则，代码点必须低于1114112（这是完整的Unicode范围）。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:20

msgid ""

":c:type:`Py_UNICODE*` and UTF-8 representations are created on demand and "

"cached in the Unicode object. The :c:type:`Py_UNICODE*` representation is "

"deprecated and inefficient; it should be avoided in performance- or memory-"

"sensitive situations."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:25

msgid ""

"Due to the transition between the old APIs and the new APIs, Unicode objects"

" can internally be in two states depending on how they were created:"

msgstr "由于旧API和新API之间的转换，Unicode对象内部可以处于两种状态，这取决于它们的创建方式："

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:28

msgid ""

"\"canonical\" Unicode objects are all objects created by a non-deprecated "

"Unicode API. They use the most efficient representation allowed by the "

"implementation."

msgstr "“规范”Unicode对象是由非弃用的Unicode API创建的所有对象。它们使用实现所允许的最有效的表示。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:32

msgid ""

"\"legacy\" Unicode objects have been created through one of the deprecated "

"APIs (typically :c:func:`PyUnicode_FromUnicode`) and only bear the "

":c:type:`Py_UNICODE*` representation; you will have to call "

":c:func:`PyUnicode_READY` on them before calling any other API."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:39

msgid "Unicode Type"

msgstr "Unicode类型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:41

msgid ""

"These are the basic Unicode object types used for the Unicode implementation"

" in Python:"

msgstr "以下是用于Python中Unicode实现的基本Unicode对象类型："

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:48

msgid ""

"These types are typedefs for unsigned integer types wide enough to contain "

"characters of 32 bits, 16 bits and 8 bits, respectively. When dealing with "

"single Unicode characters, use :c:type:`Py_UCS4`."

msgstr ""

"这些类型是无符号整数类型的类型定义，其宽度足以分别包含 32 位、16 位和 8 位字符。 当需要处理单个 Unicode 字符时，请使用 "

":c:type:`Py_UCS4`。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:57

msgid ""

"This is a typedef of :c:type:`wchar_t`, which is a 16-bit type or 32-bit "

"type depending on the platform."

msgstr "这是 :c:type:`wchar_t` 的类型定义，根据平台的不同它可能为 16 位类型或 32 位类型。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:60

msgid ""

"In previous versions, this was a 16-bit type or a 32-bit type depending on "

"whether you selected a \"narrow\" or \"wide\" Unicode version of Python at "

"build time."

msgstr "在以前的版本中，这是16位类型还是32位类型，这取决于您在构建时选择的是“窄”还是“宽”Unicode版本的Python。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:70

msgid ""

"These subtypes of :c:type:`PyObject` represent a Python Unicode object. In "

"almost all cases, they shouldn't be used directly, since all API functions "

"that deal with Unicode objects take and return :c:type:`PyObject` pointers."

msgstr ""

"这些关于 :c:type:`PyObject` 的子类型表示了一个 Python Unicode "

"对象。在几乎所有情形下，它们不应该被直接使用，因为所有处理 Unicode 对象的 API 函数都采用并返回 :c:type:`PyObject` "

"类型的指针。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:79

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python Unicode type."

" It is exposed to Python code as ``str``."

msgstr ""

"这个 :c:type:`PyTypeObject` 实例代表 Python Unicode 类型。 它作为 ``str`` 公开给 Python 代码。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:83

msgid ""

"The following APIs are really C macros and can be used to do fast checks and"

" to access internal read-only data of Unicode objects:"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:88

msgid ""

"Return true if the object *o* is a Unicode object or an instance of a "

"Unicode subtype."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:94

msgid ""

"Return true if the object *o* is a Unicode object, but not an instance of a "

"subtype."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:100

msgid ""

"Ensure the string object *o* is in the \"canonical\" representation. This "

"is required before using any of the access macros described below."

msgstr "确保字符串对象*o*处于“规范”表示形式。在使用下面描述的任何访问宏之前，这是必需的。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:105

msgid ""

"Returns ``0`` on success and ``-1`` with an exception set on failure, which "

"in particular happens if memory allocation fails."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:113

msgid ""

"Return the length of the Unicode string, in code points. *o* has to be a "

"Unicode object in the \"canonical\" representation (not checked)."

msgstr "返回Unicode字符串的长度（以代码点为单位）*o*必须是“规范”表示中的Unicode对象（未选中）。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:123

msgid ""

"Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 "

"integer types for direct character access. No checks are performed if the "

"canonical representation has the correct character size; use "

":c:func:`PyUnicode_KIND` to select the right macro. Make sure "

":c:func:`PyUnicode_READY` has been called before accessing this."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:137

msgid "Return values of the :c:func:`PyUnicode_KIND` macro."

msgstr "返回 :c:func:`PyUnicode_KIND` 宏的值。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:144

msgid ""

"Return one of the PyUnicode kind constants (see above) that indicate how "

"many bytes per character this Unicode object uses to store its data. *o* "

"has to be a Unicode object in the \"canonical\" representation (not "

"checked)."

msgstr ""

"返回一个PyUnicode类常量（见上文），指示此Unicode对象用于存储其数据的每个字符的字节数*o*必须是“规范”表达方式中的Unicode对象（未选中）。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:155

msgid ""

"Return a void pointer to the raw Unicode buffer. *o* has to be a Unicode "

"object in the \"canonical\" representation (not checked)."

msgstr "返回指向原始Unicode缓冲区的空指针*o*必须是“规范”表达方式中的Unicode对象（未选中）。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:164

msgid ""

"Write into a canonical representation *data* (as obtained with "

":c:func:`PyUnicode_DATA`). This macro does not do any sanity checks and is "

"intended for usage in loops. The caller should cache the *kind* value and "

"*data* pointer as obtained from other macro calls. *index* is the index in "

"the string (starts at 0) and *value* is the new code point value which "

"should be written to that location."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:176

msgid ""

"Read a code point from a canonical representation *data* (as obtained with "

":c:func:`PyUnicode_DATA`). No checks or ready calls are performed."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:184

msgid ""

"Read a character from a Unicode object *o*, which must be in the "

"\"canonical\" representation. This is less efficient than "

":c:func:`PyUnicode_READ` if you do multiple consecutive reads."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:193

msgid ""

"Return the maximum code point that is suitable for creating another string "

"based on *o*, which must be in the \"canonical\" representation. This is "

"always an approximation but more efficient than iterating over the string."

msgstr "返回适合于基于*o*创建另一个字符串的最大代码点，该字符串必须在“规范”表达方式中。这始终是一种近似，但比在字符串上迭代更有效。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:202

msgid "Clear the free list. Return the total number of freed items."

msgstr "清空释放列表。 返回所释放的条目数。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:207

msgid ""

"Return the size of the deprecated :c:type:`Py_UNICODE` representation, in "

"code units (this includes surrogate pairs as 2 units). *o* has to be a "

"Unicode object (not checked)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:213

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:223

msgid ""

"Part of the old-style Unicode API, please migrate to using "

":c:func:`PyUnicode_GET_LENGTH`."

msgstr "旧式 Unicode API 的一部分，请迁移到使用 :c:func:`PyUnicode_GET_LENGTH`。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:218

msgid ""

"Return the size of the deprecated :c:type:`Py_UNICODE` representation in "

"bytes. *o* has to be a Unicode object (not checked)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:229

msgid ""

"Return a pointer to a :c:type:`Py_UNICODE` representation of the object. "

"The returned buffer is always terminated with an extra null code point. It "

"may also contain embedded null code points, which would cause the string to "

"be truncated when used in most C functions. The ``AS_DATA`` form casts the "

"pointer to :c:type:`const char *`. The *o* argument has to be a Unicode "

"object (not checked)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:236

msgid ""

"This macro is now inefficient -- because in many cases the "

":c:type:`Py_UNICODE` representation does not exist and needs to be created "

"-- and can fail (return ``NULL`` with an exception set). Try to port the "

"code to use the new :c:func:`PyUnicode_nBYTE_DATA` macros or use "

":c:func:`PyUnicode_WRITE` or :c:func:`PyUnicode_READ`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:245

msgid ""

"Part of the old-style Unicode API, please migrate to using the "

":c:func:`PyUnicode_nBYTE_DATA` family of macros."

msgstr "旧式 Unicode API 的一部分，请迁移到使用 :c:func:`PyUnicode_nBYTE_DATA` 宏族。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:249

msgid "Unicode Character Properties"

msgstr "Unicode字符属性"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:251

msgid ""

"Unicode provides many different character properties. The most often needed "

"ones are available through these macros which are mapped to C functions "

"depending on the Python configuration."

msgstr "Unicode提供了许多不同的字符财产。最常需要的宏可以通过这些宏获得，这些宏根据Python配置映射到C函数。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:258

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a whitespace character."

msgstr "根据 *ch* 是否为空白字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:263

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a lowercase character."

msgstr "根据 *ch* 是否为小写字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:268

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is an uppercase character."

msgstr "根据 *ch* 是否为大写字符返回 ``1`` 或 ``0``"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:273

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a titlecase character."

msgstr "根据 *ch* 是否为标题化的大小写返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:278

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a linebreak character."

msgstr "根据 *ch* 是否为换行字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:283

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a decimal character."

msgstr "根据 *ch* 是否为十进制数字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:288

msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character."

msgstr "根据 *ch* 是否为数码类字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:293

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a numeric character."

msgstr "根据 *ch* 是否为数值类字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:298

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is an alphabetic character."

msgstr "根据 *ch* 是否为字母类字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:303

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric "

"character."

msgstr "根据 *ch* 是否为字母数字类字符返回 ``1`` 或 ``0``。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:308

msgid ""

"Return ``1`` or ``0`` depending on whether *ch* is a printable character. "

"Nonprintable characters are those characters defined in the Unicode "

"character database as \"Other\" or \"Separator\", excepting the ASCII space "

"(0x20) which is considered printable. (Note that printable characters in "

"this context are those which should not be escaped when :func:`repr` is "

"invoked on a string. It has no bearing on the handling of strings written to"

" :data:`sys.stdout` or :data:`sys.stderr`.)"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:317

msgid "These APIs can be used for fast direct character conversions:"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:322

msgid "Return the character *ch* converted to lower case."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:324

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:332

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:340

msgid "This function uses simple case mappings."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:330

msgid "Return the character *ch* converted to upper case."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:338

msgid "Return the character *ch* converted to title case."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:346

msgid ""

"Return the character *ch* converted to a decimal positive integer. Return "

"``-1`` if this is not possible. This macro does not raise exceptions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:352

msgid ""

"Return the character *ch* converted to a single digit integer. Return ``-1``"

" if this is not possible. This macro does not raise exceptions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:358

msgid ""

"Return the character *ch* converted to a double. Return ``-1.0`` if this is "

"not possible. This macro does not raise exceptions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:362

msgid "These APIs can be used to work with surrogates:"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:366

msgid "Check if *ch* is a surrogate (``0xD800 <= ch <= 0xDFFF``)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:370

msgid "Check if *ch* is a high surrogate (``0xD800 <= ch <= 0xDBFF``)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:374

msgid "Check if *ch* is a low surrogate (``0xDC00 <= ch <= 0xDFFF``)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:378

msgid ""

"Join two surrogate characters and return a single Py_UCS4 value. *high* and "

"*low* are respectively the leading and trailing surrogates in a surrogate "

"pair."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:384

msgid "Creating and accessing Unicode strings"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:386

msgid ""

"To create Unicode objects and access their basic sequence properties, use "

"these APIs:"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:391

msgid ""

"Create a new Unicode object. *maxchar* should be the true maximum code "

"point to be placed in the string. As an approximation, it can be rounded up"

" to the nearest value in the sequence 127, 255, 65535, 1114111."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:395

msgid ""

"This is the recommended way to allocate a new Unicode object. Objects "

"created using this function are not resizable."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:404

msgid ""

"Create a new Unicode object with the given *kind* (possible values are "

":c:macro:`PyUnicode_1BYTE_KIND` etc., as returned by "

":c:func:`PyUnicode_KIND`). The *buffer* must point to an array of *size* "

"units of 1, 2 or 4 bytes per character, as given by the kind."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:414

msgid ""

"Create a Unicode object from the char buffer *u*. The bytes will be "

"interpreted as being UTF-8 encoded. The buffer is copied into the new "

"object. If the buffer is not ``NULL``, the return value might be a shared "

"object, i.e. modification of the data is not allowed."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:419

msgid ""

"If *u* is ``NULL``, this function behaves like "

":c:func:`PyUnicode_FromUnicode` with the buffer set to ``NULL``. This usage"

" is deprecated in favor of :c:func:`PyUnicode_New`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:426

msgid ""

"Create a Unicode object from a UTF-8 encoded null-terminated char buffer "

"*u*."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:432

msgid ""

"Take a C :c:func:`printf`\\ -style *format* string and a variable number of "

"arguments, calculate the size of the resulting Python Unicode string and "

"return a string with the values formatted into it. The variable arguments "

"must be C types and must correspond exactly to the format characters in the "

"*format* ASCII-encoded string. The following format characters are allowed:"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:447

msgid "Format Characters"

msgstr "格式字符"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:447

msgid "Type"

msgstr "类型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:447

msgid "Comment"

msgstr "注释"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:449

msgid ":attr:`%%`"

msgstr ":attr:`%%`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:449

msgid "*n/a*"

msgstr "*不适用*"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:449

msgid "The literal % character."

msgstr "文字%字符。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:451

msgid ":attr:`%c`"

msgstr ":attr:`%c`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:451

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:454

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:487

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:490

msgid "int"

msgstr "整型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:451

msgid "A single character, represented as a C int."

msgstr "单个字符，表示为C 语言的整型。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:454

msgid ":attr:`%d`"

msgstr ":attr:`%d`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:454

msgid "Equivalent to ``printf(\"%d\")``. [1]_"

msgstr "相当于 ``printf(\"%d\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:457

msgid ":attr:`%u`"

msgstr ":attr:`%u`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:457

msgid "unsigned int"

msgstr "无符号整型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:457

msgid "Equivalent to ``printf(\"%u\")``. [1]_"

msgstr "相当于 ``printf(\"%u\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:460

msgid ":attr:`%ld`"

msgstr ":attr:`%ld`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:460

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:463

msgid "long"

msgstr "长整型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:460

msgid "Equivalent to ``printf(\"%ld\")``. [1]_"

msgstr "相当于 ``printf(\"%ld\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:463

msgid ":attr:`%li`"

msgstr ":attr:`%li`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:463

msgid "Equivalent to ``printf(\"%li\")``. [1]_"

msgstr "相当于 ``printf(\"%li\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:466

msgid ":attr:`%lu`"

msgstr ":attr:`%lu`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:466

msgid "unsigned long"

msgstr "无符号长整型"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:466

msgid "Equivalent to ``printf(\"%lu\")``. [1]_"

msgstr "相当于 ``printf(\"%lu\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:469

msgid ":attr:`%lld`"

msgstr ":attr:`%lld`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:469

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:472

msgid "long long"

msgstr "long long"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:469

msgid "Equivalent to ``printf(\"%lld\")``. [1]_"

msgstr "相当于 ``printf(\"%lld\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:472

msgid ":attr:`%lli`"

msgstr ":attr:`%lli`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:472

msgid "Equivalent to ``printf(\"%lli\")``. [1]_"

msgstr "相当于 ``printf(\"%lli\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:475

msgid ":attr:`%llu`"

msgstr ":attr:`%llu`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:475

msgid "unsigned long long"

msgstr "无符号 long long"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:475

msgid "Equivalent to ``printf(\"%llu\")``. [1]_"

msgstr "相当于 ``printf(\"%llu\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:478

msgid ":attr:`%zd`"

msgstr ":attr:`%zd`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:478

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:481

msgid "Py_ssize_t"

msgstr "Py_ssize_t"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:478

msgid "Equivalent to ``printf(\"%zd\")``. [1]_"

msgstr "相当于 ``printf(\"%zd\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:481

msgid ":attr:`%zi`"

msgstr ":attr:`%zi`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:481

msgid "Equivalent to ``printf(\"%zi\")``. [1]_"

msgstr "相当于 ``printf(\"%zi\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:484

msgid ":attr:`%zu`"

msgstr ":attr:`%zu`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:484

msgid "size_t"

msgstr "size_t"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:484

msgid "Equivalent to ``printf(\"%zu\")``. [1]_"

msgstr "相当于 ``printf(\"%zu\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:487

msgid ":attr:`%i`"

msgstr ":attr:`%i`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:487

msgid "Equivalent to ``printf(\"%i\")``. [1]_"

msgstr "相当于 ``printf(\"%i\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:490

msgid ":attr:`%x`"

msgstr ":attr:`%x`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:490

msgid "Equivalent to ``printf(\"%x\")``. [1]_"

msgstr "相当于 ``printf(\"%x\")``. [1]_"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:493

msgid ":attr:`%s`"

msgstr ":attr:`%s`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:493

msgid "const char\\*"

msgstr "const char\\*"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:493

msgid "A null-terminated C character array."

msgstr "以 null 为终止符的 C 字符数组。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:496

msgid ":attr:`%p`"

msgstr ":attr:`%p`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:496

msgid "const void\\*"

msgstr "const void\\*"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:496

msgid ""

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

msgstr ""

"一个 C 指针的十六进制表示形式。 基本等价于 ``printf(\"%p\")`` 但它会确保以字面值 ``0x`` 开头，不论系统平台上 "

"``printf`` 的输出是什么。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:504

msgid ":attr:`%A`"

msgstr ":attr:`%A`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:504

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:507

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:516

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:519

msgid "PyObject\\*"

msgstr "PyObject\\*"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:504

msgid "The result of calling :func:`ascii`."

msgstr ":func:`ascii` 调用的结果。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:507

msgid ":attr:`%U`"

msgstr ":attr:`%U`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:507

msgid "A Unicode object."

msgstr "一个 Unicode 对象。"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:509

msgid ":attr:`%V`"

msgstr ":attr:`%V`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:509

msgid "PyObject\\*, const char\\*"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:509

msgid ""

"A Unicode object (which may be ``NULL``) and a null-terminated C character "

"array as a second parameter (which will be used, if the first parameter is "

"``NULL``)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:516

msgid ":attr:`%S`"

msgstr ":attr:`%S`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:516

msgid "The result of calling :c:func:`PyObject_Str`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:519

msgid ":attr:`%R`"

msgstr ":attr:`%R`"

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:519

msgid "The result of calling :c:func:`PyObject_Repr`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:523

msgid ""

"An unrecognized format character causes all the rest of the format string to"

" be copied as-is to the result string, and any extra arguments discarded."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:527

msgid ""

"The width formatter unit is number of characters rather than bytes. The "

"precision formatter unit is number of bytes for ``\"%s\"`` and ``\"%V\"`` "

"(if the ``PyObject*`` argument is ``NULL``), and a number of characters for "

"``\"%A\"``, ``\"%U\"``, ``\"%S\"``, ``\"%R\"`` and ``\"%V\"`` (if the "

"``PyObject*`` argument is not ``NULL``)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:533

msgid ""

"For integer specifiers (d, u, ld, li, lu, lld, lli, llu, zd, zi, zu, i, x): "

"the 0-conversion flag has effect even when a precision is given."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:536

msgid "Support for ``\"%lld\"`` and ``\"%llu\"`` added."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:539

msgid "Support for ``\"%li\"``, ``\"%lli\"`` and ``\"%zi\"`` added."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:542

msgid ""

"Support width and precision formatter for ``\"%s\"``, ``\"%A\"``, "

"``\"%U\"``, ``\"%V\"``, ``\"%S\"``, ``\"%R\"`` added."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:549

msgid ""

"Identical to :c:func:`PyUnicode_FromFormat` except that it takes exactly two"

" arguments."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:556

msgid "Decode an encoded object *obj* to a Unicode object."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:558

msgid ""

":class:`bytes`, :class:`bytearray` and other :term:`bytes-like objects "

"<bytes-like object>` are decoded according to the given *encoding* and using"

" the error handling defined by *errors*. Both can be ``NULL`` to have the "

"interface use the default values (see :ref:`builtincodecs` for details)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:564

msgid ""

"All other objects, including Unicode objects, cause a :exc:`TypeError` to be"

" set."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:567

msgid ""

"The API returns ``NULL`` if there was an error. The caller is responsible "

"for decref'ing the returned objects."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:573

msgid "Return the length of the Unicode object, in code points."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:584

msgid ""

"Copy characters from one Unicode object into another. This function "

"performs character conversion when necessary and falls back to "

":c:func:`memcpy` if possible. Returns ``-1`` and sets an exception on "

"error, otherwise returns the number of copied characters."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:595

msgid ""

"Fill a string with a character: write *fill_char* into "

"``unicode[start:start+length]``."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:598

msgid ""

"Fail if *fill_char* is bigger than the string maximum character, or if the "

"string has more than 1 reference."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:601

msgid ""

"Return the number of written character, or return ``-1`` and raise an "

"exception on error."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:610

msgid ""

"Write a character to a string. The string must have been created through "

":c:func:`PyUnicode_New`. Since Unicode strings are supposed to be "

"immutable, the string must not be shared, or have been hashed yet."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:614

msgid ""

"This function checks that *unicode* is a Unicode object, that the index is "

"not out of bounds, and that the object can be modified safely (i.e. that it "

"its reference count is one)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:623

msgid ""

"Read a character from a string. This function checks that *unicode* is a "

"Unicode object and the index is not out of bounds, in contrast to the macro "

"version :c:func:`PyUnicode_READ_CHAR`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:633

msgid ""

"Return a substring of *str*, from character index *start* (included) to "

"character index *end* (excluded). Negative indices are not supported."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:642

msgid ""

"Copy the string *u* into a UCS4 buffer, including a null character, if "

"*copy_null* is set. Returns ``NULL`` and sets an exception on error (in "

"particular, a :exc:`SystemError` if *buflen* is smaller than the length of "

"*u*). *buffer* is returned on success."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:652

msgid ""

"Copy the string *u* into a new UCS4 buffer that is allocated using "

":c:func:`PyMem_Malloc`. If this fails, ``NULL`` is returned with a "

":exc:`MemoryError` set. The returned buffer always has an extra null code "

"point appended."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:661

msgid "Deprecated Py_UNICODE APIs"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:665

msgid ""

"These API functions are deprecated with the implementation of :pep:`393`. "

"Extension modules can continue using them, as they will not be removed in "

"Python 3.x, but need to be aware that their use can now cause performance "

"and memory hits."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:672

msgid ""

"Create a Unicode object from the Py_UNICODE buffer *u* of the given size. "

"*u* may be ``NULL`` which causes the contents to be undefined. It is the "

"user's responsibility to fill in the needed data. The buffer is copied into"

" the new object."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:677

msgid ""

"If the buffer is not ``NULL``, the return value might be a shared object. "

"Therefore, modification of the resulting Unicode object is only allowed when"

" *u* is ``NULL``."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:681

msgid ""

"If the buffer is ``NULL``, :c:func:`PyUnicode_READY` must be called once the"

" string content has been filled before using any of the access macros such "

"as :c:func:`PyUnicode_KIND`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:685

msgid ""

"Please migrate to using :c:func:`PyUnicode_FromKindAndData`, "

":c:func:`PyUnicode_FromWideChar` or :c:func:`PyUnicode_New`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:691

msgid ""

"Return a read-only pointer to the Unicode object's internal "

":c:type:`Py_UNICODE` buffer, or ``NULL`` on error. This will create the "

":c:type:`Py_UNICODE*` representation of the object if it is not yet "

"available. The buffer is always terminated with an extra null code point. "

"Note that the resulting :c:type:`Py_UNICODE` string may also contain "

"embedded null code points, which would cause the string to be truncated when"

" used in most C functions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:699

msgid ""

"Please migrate to using :c:func:`PyUnicode_AsUCS4`, "

":c:func:`PyUnicode_AsWideChar`, :c:func:`PyUnicode_ReadChar` or similar new "

"APIs."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:706

msgid ""

"Create a Unicode object by replacing all decimal digits in "

":c:type:`Py_UNICODE` buffer of the given *size* by ASCII digits 0--9 "

"according to their decimal value. Return ``NULL`` if an exception occurs."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:713

msgid ""

"Like :c:func:`PyUnicode_AsUnicode`, but also saves the :c:func:`Py_UNICODE` "

"array length (excluding the extra null terminator) in *size*. Note that the "

"resulting :c:type:`Py_UNICODE*` string may contain embedded null code "

"points, which would cause the string to be truncated when used in most C "

"functions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:724

msgid ""

"Create a copy of a Unicode string ending with a null code point. Return "

"``NULL`` and raise a :exc:`MemoryError` exception on memory allocation "

"failure, otherwise return a new allocated buffer (use :c:func:`PyMem_Free` "

"to free the buffer). Note that the resulting :c:type:`Py_UNICODE*` string "

"may contain embedded null code points, which would cause the string to be "

"truncated when used in most C functions."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:733

msgid ""

"Please migrate to using :c:func:`PyUnicode_AsUCS4Copy` or similar new APIs."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:738

msgid ""

"Return the size of the deprecated :c:type:`Py_UNICODE` representation, in "

"code units (this includes surrogate pairs as 2 units)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:741

msgid "Please migrate to using :c:func:`PyUnicode_GetLength`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:746

msgid ""

"Copy an instance of a Unicode subtype to a new true Unicode object if "

"necessary. If *obj* is already a true Unicode object (not a subtype), return"

" the reference with incremented refcount."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:750

msgid ""

"Objects other than Unicode or its subtypes will cause a :exc:`TypeError`."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:754

msgid "Locale Encoding"

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:756

msgid ""

"The current locale encoding can be used to decode text from the operating "

"system."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:763

msgid ""

"Decode a string from UTF-8 on Android, or from the current locale encoding "

"on other platforms. The supported error handlers are ``\"strict\"`` and "

"``\"surrogateescape\"`` (:pep:`383`). The decoder uses ``\"strict\"`` error "

"handler if *errors* is ``NULL``. *str* must end with a null character but "

"cannot contain embedded null characters."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:770

msgid ""

"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from "

":c:data:`Py_FileSystemDefaultEncoding` (the locale encoding read at Python "

"startup)."

msgstr ""

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:774

#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/c-api/unicode.rst:810

msgid "This function ignores the Python UTF-8 mode."