# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 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.14\n"

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

"POT-Creation-Date: 2026-10-17 13:50+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Last-Translator: python-doc bot, 2025\n"

"Language-Team: German (https://app.transifex.com/python-doc/teams/5390/de/)\n"

"Language: de\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#: ../../c-api/unicode.rst:6

msgid "Unicode Objects and Codecs"

msgstr "Unicode Objekte und Codecs"

#: ../../c-api/unicode.rst:12

msgid "Unicode Objects"

msgstr "Unicode Objekte"

#: ../../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 ""

"Seit der Umsetzung von :pep:`393` in Python 3.3 verwenden Unicode Objekte "

"intern eine Vielzahl von Repräsentationen, um die gesamte Bandbreite der "

"Unicode Zeichen verarbeiten zu können und dabei speichereffizient zu "

"bleiben. Es gibt Spezialfälle für Zeichenketten, deren Codepunkte alle unter "

"128, 256 oder 65536 liegen; andernfalls müssen Codepunkte unterhalb von "

"1114112 sein (gesamter Unicode Bereich)."

#: ../../c-api/unicode.rst:20

msgid ""

"UTF-8 representation is created on demand and cached in the Unicode object."

msgstr ""

#: ../../c-api/unicode.rst:24

msgid ""

"The internal buffer always includes an extra trailing null character for "

"compatibility with null terminated C strings. This extra character is not "

"counted in :c:func:`PyUnicode_GetLength` nor in the various *size* arguments "

"of the functions below."

msgstr ""

#: ../../c-api/unicode.rst:30

msgid ""

"The :c:type:`Py_UNICODE` representation has been removed since Python 3.12 "

"with deprecated APIs. See :pep:`623` for more information."

msgstr ""

#: ../../c-api/unicode.rst:36

msgid "Unicode Type"

msgstr ""

#: ../../c-api/unicode.rst:38

msgid ""

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

"in Python:"

msgstr ""

#: ../../c-api/unicode.rst:43

msgid ""

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

"It is exposed to Python code as :py:class:`str`."

msgstr ""

#: ../../c-api/unicode.rst:49

msgid ""

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

"iterator type. It is used to iterate over Unicode string objects."

msgstr ""

#: ../../c-api/unicode.rst:57

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

#: ../../c-api/unicode.rst:68

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-api/unicode.rst:75

msgid ""

"The structure of a particular object can be determined using the following "

"macros. The macros cannot fail; their behavior is undefined if their "

"argument is not a Python Unicode object."

msgstr ""

#: ../../c-api/unicode.rst:84

msgid "True if *o* uses the :c:struct:`PyCompactUnicodeObject` structure."

msgstr ""

#: ../../c-api/unicode.rst:91

msgid "True if *o* uses the :c:struct:`PyASCIIObject` structure."

msgstr ""

#: ../../c-api/unicode.rst:96

msgid ""

"The following APIs are C macros and static inlined functions for fast checks "

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

msgstr ""

#: ../../c-api/unicode.rst:101

msgid ""

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

"Unicode subtype. This function always succeeds."

msgstr ""

#: ../../c-api/unicode.rst:107

msgid ""

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

"a subtype. This function always succeeds."

msgstr ""

#: ../../c-api/unicode.rst:113

msgid ""

"Return the length of the Unicode string, in code points. *unicode* has to "

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

msgstr ""

#: ../../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 function."

msgstr ""

#: ../../c-api/unicode.rst:135

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

msgstr ""

#: ../../c-api/unicode.rst:139

msgid "``PyUnicode_WCHAR_KIND`` has been removed."

msgstr ""

#: ../../c-api/unicode.rst:145

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

"*unicode* has to be a Unicode object in the \"canonical\" representation "

"(not checked)."

msgstr ""

#: ../../c-api/unicode.rst:154

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:163

msgid ""

"Write the code point *value* to the given zero-based *index* in a string."

msgstr ""

#: ../../c-api/unicode.rst:165

msgid ""

"The *kind* value and *data* pointer must have been obtained from a string "

"using :c:func:`PyUnicode_KIND` and :c:func:`PyUnicode_DATA` respectively. "

"You must hold a reference to that string while calling :c:func:`!"

"PyUnicode_WRITE`. All requirements of :c:func:`PyUnicode_WriteChar` also "

"apply."

msgstr ""

#: ../../c-api/unicode.rst:171

msgid ""

"The function performs no checks for any of its requirements, and is intended "

"for usage in loops."

msgstr ""

#: ../../c-api/unicode.rst:179

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:184 ../../c-api/unicode.rst:198

msgid ""

"Accept reading the trailing null character at index :c:func:"

"`PyUnicode_GetLength`."

msgstr ""

#: ../../c-api/unicode.rst:192

msgid ""

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

"\"canonical\" representation. This is less efficient than :c:func:"

"`PyUnicode_READ` if you do multiple consecutive reads."

msgstr ""

#: ../../c-api/unicode.rst:206

msgid ""

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

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

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

msgstr ""

#: ../../c-api/unicode.rst:215

msgid ""

"Return ``1`` if the string is a valid identifier according to the language "

"definition, section :ref:`identifiers`. Return ``0`` otherwise."

msgstr ""

#: ../../c-api/unicode.rst:218

msgid ""

"The function does not call :c:func:`Py_FatalError` anymore if the string is "

"not ready."

msgstr ""

#: ../../c-api/unicode.rst:225

msgid ""

"Return true if the string only contains ASCII characters. Equivalent to :py:"

"meth:`str.isascii`."

msgstr ""

#: ../../c-api/unicode.rst:232

msgid "Unicode Character Properties"

msgstr ""

#: ../../c-api/unicode.rst:234

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

#: ../../c-api/unicode.rst:241

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:246

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:251

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:256

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:261

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:266

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

msgstr ""

#: ../../c-api/unicode.rst:271

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

msgstr ""

#: ../../c-api/unicode.rst:276

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

msgstr ""

#: ../../c-api/unicode.rst:281

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:286

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:291

msgid ""

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

"the sense of :meth:`str.isprintable`."

msgstr ""

#: ../../c-api/unicode.rst:295

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

msgstr ""

#: ../../c-api/unicode.rst:300

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

msgstr ""

#: ../../c-api/unicode.rst:305

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

msgstr ""

#: ../../c-api/unicode.rst:310

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

msgstr ""

#: ../../c-api/unicode.rst:315

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:321

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:327

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:331

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

msgstr ""

#: ../../c-api/unicode.rst:335

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

msgstr ""

#: ../../c-api/unicode.rst:339

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

msgstr ""

#: ../../c-api/unicode.rst:343

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

msgstr ""

#: ../../c-api/unicode.rst:347

msgid ""

"Return the high UTF-16 surrogate (``0xD800`` to ``0xDBFF``) for a Unicode "

"code point in the range ``[0x10000; 0x10FFFF]``."

msgstr ""

#: ../../c-api/unicode.rst:352

msgid ""

"Return the low UTF-16 surrogate (``0xDC00`` to ``0xDFFF``) for a Unicode "

"code point in the range ``[0x10000; 0x10FFFF]``."

msgstr ""

#: ../../c-api/unicode.rst:357

msgid ""

"Join two surrogate code points and return a single :c:type:`Py_UCS4` value. "

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

"surrogate pair. *high* must be in the range ``[0xD800; 0xDBFF]`` and *low* "

"must be in the range ``[0xDC00; 0xDFFF]``."

msgstr ""

#: ../../c-api/unicode.rst:364

msgid "Creating and accessing Unicode strings"

msgstr ""

#: ../../c-api/unicode.rst:366

msgid ""

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

"these APIs:"

msgstr ""

#: ../../c-api/unicode.rst:371

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

#: ../../c-api/unicode.rst:375

msgid "On error, set an exception and return ``NULL``."

msgstr ""

#: ../../c-api/unicode.rst:377

msgid ""

"After creation, the string can be filled by :c:func:`PyUnicode_WriteChar`, :"

"c:func:`PyUnicode_CopyCharacters`, :c:func:`PyUnicode_Fill`, :c:func:"

"`PyUnicode_WRITE` or similar. Since strings are supposed to be immutable, "

"take care to not “use” the result while it is being modified. In particular, "

"before it's filled with its final contents, a string:"

msgstr ""

#: ../../c-api/unicode.rst:384

msgid "must not be hashed,"

msgstr ""

#: ../../c-api/unicode.rst:385

msgid ""

"must not be :c:func:`converted to UTF-8 <PyUnicode_AsUTF8AndSize>`, or "

"another non-\"canonical\" representation,"

msgstr ""

#: ../../c-api/unicode.rst:387

msgid "must not have its reference count changed,"

msgstr ""

#: ../../c-api/unicode.rst:388

msgid "must not be shared with code that might do one of the above."

msgstr ""

#: ../../c-api/unicode.rst:390

msgid ""

"This list is not exhaustive. Avoiding these uses is your responsibility; "

"Python does not always check these requirements."

msgstr ""

#: ../../c-api/unicode.rst:393

msgid ""

"To avoid accidentally exposing a partially-written string object, prefer "

"using the :c:type:`PyUnicodeWriter` API, or one of the ``PyUnicode_From*`` "

"functions below."

msgstr ""

#: ../../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 ""

#: ../../c-api/unicode.rst:409

msgid ""

"If necessary, the input *buffer* is copied and transformed into the "

"canonical representation. For example, if the *buffer* is a UCS4 string (:c:"

"macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the UCS1 "

"range, it will be transformed into UCS1 (:c:macro:`PyUnicode_1BYTE_KIND`)."

msgstr ""

#: ../../c-api/unicode.rst:415

msgid ""

"All characters must be in range [U+0000; U+10ffff]. If *kind* is :c:macro:"

"`PyUnicode_4BYTE_KIND` and the string contains invalid characters, the "

"behavior is undefined."

msgstr ""

#: ../../c-api/unicode.rst:424

msgid ""

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

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

"object. The return value might be a shared object, i.e. modification of the "

"data is not allowed."

msgstr ""

#: ../../c-api/unicode.rst:430

msgid "This function raises :exc:`SystemError` when:"

msgstr ""

#: ../../c-api/unicode.rst:432

msgid "*size* < 0,"

msgstr ""

#: ../../c-api/unicode.rst:433

msgid "*str* is ``NULL`` and *size* > 0"

msgstr ""

#: ../../c-api/unicode.rst:435

msgid "*str* == ``NULL`` with *size* > 0 is not allowed anymore."

msgstr ""

#: ../../c-api/unicode.rst:441

msgid ""

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

"*str*."

msgstr ""

#: ../../c-api/unicode.rst:447

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

msgstr ""

#: ../../c-api/unicode.rst:453

msgid ""

"A conversion specifier contains two or more characters and has the following "

"components, which must occur in this order:"

msgstr ""

#: ../../c-api/unicode.rst:456

msgid "The ``'%'`` character, which marks the start of the specifier."

msgstr ""

#: ../../c-api/unicode.rst:458

msgid ""

"Conversion flags (optional), which affect the result of some conversion "

"types."

msgstr ""

#: ../../c-api/unicode.rst:461

msgid ""

"Minimum field width (optional). If specified as an ``'*'`` (asterisk), the "

"actual width is given in the next argument, which must be of type :c:expr:"

"`int`, and the object to convert comes after the minimum field width and "

"optional precision."

msgstr ""

#: ../../c-api/unicode.rst:466

msgid ""

"Precision (optional), given as a ``'.'`` (dot) followed by the precision. If "

"specified as ``'*'`` (an asterisk), the actual precision is given in the "

"next argument, which must be of type :c:expr:`int`, and the value to convert "

"comes after the precision."

msgstr ""

#: ../../c-api/unicode.rst:471

msgid "Length modifier (optional)."

msgstr ""

#: ../../c-api/unicode.rst:473

msgid "Conversion type."

msgstr ""

#: ../../c-api/unicode.rst:475

msgid "The conversion flag characters are:"

msgstr ""

#: ../../c-api/unicode.rst:480

msgid "Flag"

msgstr ""

#: ../../c-api/unicode.rst:480

msgid "Meaning"

msgstr ""

#: ../../c-api/unicode.rst:482

msgid "``0``"

msgstr ""

#: ../../c-api/unicode.rst:482

msgid "The conversion will be zero padded for numeric values."

msgstr ""

#: ../../c-api/unicode.rst:484

msgid "``-``"

msgstr ""

#: ../../c-api/unicode.rst:484

msgid ""

"The converted value is left adjusted (overrides the ``0`` flag if both are "

"given)."

msgstr ""

#: ../../c-api/unicode.rst:488

msgid ""

"The length modifiers for following integer conversions (``d``, ``i``, ``o``, "

"``u``, ``x``, or ``X``) specify the type of the argument (:c:expr:`int` by "

"default):"

msgstr ""

#: ../../c-api/unicode.rst:495

msgid "Modifier"

msgstr ""

#: ../../c-api/unicode.rst:495

msgid "Types"

msgstr ""

#: ../../c-api/unicode.rst:497

msgid "``l``"

msgstr ""

#: ../../c-api/unicode.rst:497

msgid ":c:expr:`long` or :c:expr:`unsigned long`"

msgstr ""

#: ../../c-api/unicode.rst:499

msgid "``ll``"

msgstr ""

#: ../../c-api/unicode.rst:499

msgid ":c:expr:`long long` or :c:expr:`unsigned long long`"

msgstr ""

#: ../../c-api/unicode.rst:501

msgid "``j``"

msgstr ""

#: ../../c-api/unicode.rst:501

msgid ":c:type:`intmax_t` or :c:type:`uintmax_t`"

msgstr ""

#: ../../c-api/unicode.rst:503

msgid "``z``"

msgstr ""

#: ../../c-api/unicode.rst:503

msgid ":c:type:`size_t` or :c:type:`ssize_t`"

msgstr ""

#: ../../c-api/unicode.rst:505

msgid "``t``"

msgstr ""

#: ../../c-api/unicode.rst:505

msgid ":c:type:`ptrdiff_t`"

msgstr ""

#: ../../c-api/unicode.rst:508

msgid ""

"The length modifier ``l`` for following conversions ``s`` or ``V`` specify "

"that the type of the argument is :c:expr:`const wchar_t*`."

msgstr ""

#: ../../c-api/unicode.rst:511

msgid "The conversion specifiers are:"

msgstr ""

#: ../../c-api/unicode.rst:517

msgid "Conversion Specifier"

msgstr ""

#: ../../c-api/unicode.rst:518

msgid "Type"

msgstr ""

#: ../../c-api/unicode.rst:519

msgid "Comment"

msgstr ""

#: ../../c-api/unicode.rst:521

msgid "``%``"

msgstr ""

#: ../../c-api/unicode.rst:522

msgid "*n/a*"

msgstr ""

#: ../../c-api/unicode.rst:523

msgid "The literal ``%`` character."

msgstr ""

#: ../../c-api/unicode.rst:525

msgid "``d``, ``i``"

msgstr ""

#: ../../c-api/unicode.rst:526 ../../c-api/unicode.rst:530

#: ../../c-api/unicode.rst:534 ../../c-api/unicode.rst:538

#: ../../c-api/unicode.rst:542

msgid "Specified by the length modifier"

msgstr ""

#: ../../c-api/unicode.rst:527

msgid "The decimal representation of a signed C integer."

msgstr ""

#: ../../c-api/unicode.rst:529

msgid "``u``"

msgstr ""

#: ../../c-api/unicode.rst:531

msgid "The decimal representation of an unsigned C integer."

msgstr ""

#: ../../c-api/unicode.rst:533

msgid "``o``"

msgstr ""

#: ../../c-api/unicode.rst:535

msgid "The octal representation of an unsigned C integer."

msgstr ""

#: ../../c-api/unicode.rst:537

msgid "``x``"

msgstr ""

#: ../../c-api/unicode.rst:539

msgid "The hexadecimal representation of an unsigned C integer (lowercase)."

msgstr ""

#: ../../c-api/unicode.rst:541

msgid "``X``"

msgstr ""

#: ../../c-api/unicode.rst:543

msgid "The hexadecimal representation of an unsigned C integer (uppercase)."

msgstr ""

#: ../../c-api/unicode.rst:545

msgid "``c``"

msgstr ""

#: ../../c-api/unicode.rst:546

msgid ":c:expr:`int`"

msgstr ""

#: ../../c-api/unicode.rst:547

msgid "A single character."

msgstr ""

#: ../../c-api/unicode.rst:549

msgid "``s``"

msgstr ""

#: ../../c-api/unicode.rst:550

msgid ":c:expr:`const char*` or :c:expr:`const wchar_t*`"

msgstr ""

#: ../../c-api/unicode.rst:551

msgid "A null-terminated C character array."

msgstr ""

#: ../../c-api/unicode.rst:553

msgid "``p``"

msgstr ""

#: ../../c-api/unicode.rst:554

msgid ":c:expr:`const void*`"

msgstr ""

#: ../../c-api/unicode.rst:555

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-api/unicode.rst:560

msgid "``A``"

msgstr ""

#: ../../c-api/unicode.rst:561 ../../c-api/unicode.rst:565

#: ../../c-api/unicode.rst:575 ../../c-api/unicode.rst:579

#: ../../c-api/unicode.rst:583 ../../c-api/unicode.rst:588

msgid ":c:expr:`PyObject*`"

msgstr ""

#: ../../c-api/unicode.rst:562

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

msgstr ""

#: ../../c-api/unicode.rst:564

msgid "``U``"

msgstr ""

#: ../../c-api/unicode.rst:566

msgid "A Unicode object."

msgstr ""

#: ../../c-api/unicode.rst:568

msgid "``V``"

msgstr ""

#: ../../c-api/unicode.rst:569

msgid ":c:expr:`PyObject*`, :c:expr:`const char*` or :c:expr:`const wchar_t*`"

msgstr ""

#: ../../c-api/unicode.rst:570

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

#: ../../c-api/unicode.rst:574

msgid "``S``"

msgstr ""

#: ../../c-api/unicode.rst:576

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

msgstr ""

#: ../../c-api/unicode.rst:578

msgid "``R``"

msgstr ""

#: ../../c-api/unicode.rst:580

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

msgstr ""

#: ../../c-api/unicode.rst:582

msgid "``T``"

msgstr ""

#: ../../c-api/unicode.rst:584

msgid ""

"Get the fully qualified name of an object type; call :c:func:"

"`PyType_GetFullyQualifiedName`."

msgstr ""

#: ../../c-api/unicode.rst:587

msgid "``#T``"

msgstr ""

#: ../../c-api/unicode.rst:589

msgid ""

"Similar to ``T`` format, but use a colon (``:``) as separator between the "

"module name and the qualified name."

msgstr ""

#: ../../c-api/unicode.rst:592

msgid "``N``"

msgstr ""

#: ../../c-api/unicode.rst:593 ../../c-api/unicode.rst:598

msgid ":c:expr:`PyTypeObject*`"

msgstr ""

#: ../../c-api/unicode.rst:594

msgid ""

"Get the fully qualified name of a type; call :c:func:"

"`PyType_GetFullyQualifiedName`."

msgstr ""

#: ../../c-api/unicode.rst:597

msgid "``#N``"

msgstr ""

#: ../../c-api/unicode.rst:599

msgid ""

"Similar to ``N`` format, but use a colon (``:``) as separator between the "

"module name and the qualified name."

msgstr ""

#: ../../c-api/unicode.rst:603

msgid ""

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

"precision formatter unit is number of bytes or :c:type:`wchar_t` items (if "

"the length modifier ``l`` is used) 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 ""

#: ../../c-api/unicode.rst:611

msgid ""

"Unlike to C :c:func:`printf` the ``0`` flag has effect even when a precision "

"is given for integer conversions (``d``, ``i``, ``u``, ``o``, ``x``, or "

"``X``)."

msgstr ""

#: ../../c-api/unicode.rst:615

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

msgstr ""

#: ../../c-api/unicode.rst:618

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

msgstr ""

#: ../../c-api/unicode.rst:621

msgid ""

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

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

msgstr ""

#: ../../c-api/unicode.rst:625

msgid ""

"Support for conversion specifiers ``o`` and ``X``. Support for length "

"modifiers ``j`` and ``t``. Length modifiers are now applied to all integer "

"conversions. Length modifier ``l`` is now applied to conversion specifiers "

"``s`` and ``V``. Support for variable width and precision ``*``. Support for "

"flag ``-``."

msgstr ""

#: ../../c-api/unicode.rst:633

msgid ""

"An unrecognized format character now sets a :exc:`SystemError`. In previous "

"versions it caused all the rest of the format string to be copied as-is to "

"the result string, and any extra arguments discarded."

msgstr ""

#: ../../c-api/unicode.rst:637

msgid "Support for ``%T``, ``%#T``, ``%N`` and ``%#N`` formats added."

msgstr ""

#: ../../c-api/unicode.rst:643

msgid ""

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

"arguments."

msgstr ""

#: ../../c-api/unicode.rst:649

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 "

"a new :term:`strong reference` to the object."

msgstr ""

#: ../../c-api/unicode.rst:653

msgid ""

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

msgstr ""

#: ../../c-api/unicode.rst:658

msgid "Create a Unicode Object from the given Unicode code point *ordinal*."

msgstr ""

#: ../../c-api/unicode.rst:660

msgid ""

"The ordinal must be in ``range(0x110000)``. A :exc:`ValueError` is raised in "

"the case it is not."

msgstr ""

#: ../../c-api/unicode.rst:667

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

msgstr ""

#: ../../c-api/unicode.rst:669

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

#: ../../c-api/unicode.rst:675

msgid ""

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

"set."

msgstr ""

#: ../../c-api/unicode.rst:678

msgid ""

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

"for decref'ing the returned objects."

msgstr ""

#: ../../c-api/unicode.rst:684

msgid ""

"Append the string *right* to the end of *p_left*. *p_left* must point to a :"

"term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` "

"releases (\":term:`steals <steal>`\") this reference."

msgstr ""

#: ../../c-api/unicode.rst:689

msgid "On error, set *\\*p_left* to ``NULL`` and set an exception."

msgstr ""

#: ../../c-api/unicode.rst:691

msgid "On success, set *\\*p_left* to a new strong reference to the result."

msgstr ""

#: ../../c-api/unicode.rst:696

msgid ""

"The function is similar to :c:func:`PyUnicode_Append`, with the only "

"difference being that it decrements the reference count of *right* by one."

msgstr ""

#: ../../c-api/unicode.rst:702

msgid ""

"Return a mapping suitable for decoding a custom single-byte encoding. Given "

"a Unicode string *string* of up to 256 characters representing an encoding "

"table, returns either a compact internal mapping object or a dictionary "

"mapping character ordinals to byte values. Raises a :exc:`TypeError` and "

"return ``NULL`` on invalid input."

msgstr ""

#: ../../c-api/unicode.rst:713

msgid ""

"Return the name of the default string encoding, ``\"utf-8\"``. See :func:"

"`sys.getdefaultencoding`."

msgstr ""

#: ../../c-api/unicode.rst:716

msgid ""

"The returned string does not need to be freed, and is valid until "

"interpreter shutdown."

msgstr ""

#: ../../c-api/unicode.rst:722

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

msgstr ""

#: ../../c-api/unicode.rst:724

msgid "On error, set an exception and return ``-1``."

msgstr ""

#: ../../c-api/unicode.rst:728

msgid "The length does not count the trailing null character."

msgstr ""

#: ../../c-api/unicode.rst:739

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

#: ../../c-api/unicode.rst:744 ../../c-api/unicode.rst:774

#: ../../c-api/unicode.rst:794