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

#

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2026-09-23 06:17+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\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/bytes.rst:6

msgid "Bytes Objects"

msgstr ""

#: ../../c-api/bytes.rst:8

msgid ""

"These functions raise :exc:`TypeError` when expecting a bytes parameter and "

"called with a non-bytes parameter."

msgstr ""

#: ../../c-api/bytes.rst:13

msgid ""

"The internal buffer of :c:type:`PyBytesObject` always includes an extra "

"trailing null byte for compatibility with null terminated C strings. This "

"extra byte is not counted in :c:func:`PyBytes_Size` nor in the various "

"*length* and *size* arguments of the functions below."

msgstr ""

#: ../../c-api/bytes.rst:23

msgid "This subtype of :c:type:`PyObject` represents a Python bytes object."

msgstr ""

#: ../../c-api/bytes.rst:28

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python bytes type; it "

"is the same object as :class:`bytes` in the Python layer."

msgstr ""

#: ../../c-api/bytes.rst:34

msgid ""

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

#: ../../c-api/bytes.rst:40

msgid ""

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

#: ../../c-api/bytes.rst:46

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:53

msgid ""

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

msgstr ""

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

msgid ""

"Use the :c:type:`PyBytesWriter` API instead of "

"``PyBytes_FromStringAndSize(NULL, len)``."

msgstr ""

#: ../../c-api/bytes.rst:64

msgid ""

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

"allowed:"

msgstr ""

#: ../../c-api/bytes.rst:76

msgid "Format Characters"

msgstr ""

#: ../../c-api/bytes.rst:76

msgid "Type"

msgstr ""

#: ../../c-api/bytes.rst:76

msgid "Comment"

msgstr ""

#: ../../c-api/bytes.rst:78

msgid "``%%``"

msgstr ""

#: ../../c-api/bytes.rst:78

msgid "*n/a*"

msgstr ""

#: ../../c-api/bytes.rst:78

msgid "The literal % character."

msgstr ""

#: ../../c-api/bytes.rst:80

msgid "``%c``"

msgstr ""

#: ../../c-api/bytes.rst:80 ../../c-api/bytes.rst:83 ../../c-api/bytes.rst:101

#: ../../c-api/bytes.rst:104

msgid "int"

msgstr ""

#: ../../c-api/bytes.rst:80

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

msgstr ""

#: ../../c-api/bytes.rst:83

msgid "``%d``"

msgstr ""

#: ../../c-api/bytes.rst:83

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

msgstr ""

#: ../../c-api/bytes.rst:86

msgid "``%u``"

msgstr ""

#: ../../c-api/bytes.rst:86

msgid "unsigned int"

msgstr ""

#: ../../c-api/bytes.rst:86

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

msgstr ""

#: ../../c-api/bytes.rst:89

msgid "``%ld``"

msgstr ""

#: ../../c-api/bytes.rst:89

msgid "long"

msgstr ""

#: ../../c-api/bytes.rst:89

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

msgstr ""

#: ../../c-api/bytes.rst:92

msgid "``%lu``"

msgstr ""

#: ../../c-api/bytes.rst:92

msgid "unsigned long"

msgstr ""

#: ../../c-api/bytes.rst:92

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

msgstr ""

#: ../../c-api/bytes.rst:95

msgid "``%zd``"

msgstr ""

#: ../../c-api/bytes.rst:95

msgid ":c:type:` Py_ssize_t`"

msgstr ""

#: ../../c-api/bytes.rst:95

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

msgstr ""

#: ../../c-api/bytes.rst:98

msgid "``%zu``"

msgstr ""

#: ../../c-api/bytes.rst:98

msgid "size_t"

msgstr ""

#: ../../c-api/bytes.rst:98

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

msgstr ""

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

msgid "``%i``"

msgstr ""

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

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

msgstr ""

#: ../../c-api/bytes.rst:104

msgid "``%x``"

msgstr ""

#: ../../c-api/bytes.rst:104

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

msgstr ""

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

msgid "``%s``"

msgstr ""

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

msgid "const char\\*"

msgstr ""

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

msgid "A null-terminated C character array."

msgstr ""

#: ../../c-api/bytes.rst:110

msgid "``%p``"

msgstr ""

#: ../../c-api/bytes.rst:110

msgid "const void\\*"

msgstr ""

#: ../../c-api/bytes.rst:110

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/bytes.rst:119

msgid ""

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

msgid ""

"For integer specifiers (d, u, ld, lu, zd, zu, i, x): the 0-conversion flag "

"has effect even when a precision is given."

msgstr ""

#: ../../c-api/bytes.rst:128

msgid ""

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

"arguments."

msgstr ""

#: ../../c-api/bytes.rst:134

msgid ""

"Return the bytes representation of object *o* that implements the buffer "

"protocol."

msgstr ""

#: ../../c-api/bytes.rst:138

msgid ""

"If the object implements the buffer protocol, then the buffer must not be "

"mutated while the bytes object is being created."

msgstr ""

#: ../../c-api/bytes.rst:144

msgid "Return the length of the bytes in bytes object *o*."

msgstr ""

#: ../../c-api/bytes.rst:149

msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."

msgstr ""

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

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:166

msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."

msgstr ""

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

msgid ""

"Return the null-terminated contents of the object *obj* through the output "

"variables *buffer* and *length*. Returns ``0`` on success."

msgstr ""

#: ../../c-api/bytes.rst:175

msgid ""

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

"raised."

msgstr ""

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

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:186

msgid ""

"Previously, :exc:`TypeError` was raised when embedded null bytes were "

"encountered in the bytes object."

msgstr ""

#: ../../c-api/bytes.rst:193

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:201 ../../c-api/bytes.rst:211

msgid ""

"If *newpart* implements the buffer protocol, then the buffer must not be "

"mutated while the new bytes object is being created."

msgstr ""

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

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:217

msgid "Similar to ``sep.join(iterable)`` in Python."

msgstr ""

#: ../../c-api/bytes.rst:219

msgid ""

"*sep* must be Python :class:`bytes` object. (Note that :c:func:"

"`PyUnicode_Join` accepts ``NULL`` separator and treats it as a space, "

"whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)"

msgstr ""

#: ../../c-api/bytes.rst:224

msgid ""

"*iterable* must be an iterable object yielding objects that implement the :"

"ref:`buffer protocol <bufferobjects>`."

msgstr ""

#: ../../c-api/bytes.rst:227

msgid ""

"On success, return a new :class:`bytes` object. On error, set an exception "

"and return ``NULL``."

msgstr ""

#: ../../c-api/bytes.rst:233

msgid ""

"If *iterable* objects implement the buffer protocol, then the buffers must "

"not be mutated while the new bytes object is being created."

msgstr ""

#: ../../c-api/bytes.rst:238

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:249

msgid "Use the :c:type:`PyBytesWriter` API instead."

msgstr ""

#: ../../c-api/bytes.rst:255

msgid ""

"Get the string representation of *bytes*. This function is currently used to "

"implement :meth:`!bytes.__repr__` in Python."

msgstr ""

#: ../../c-api/bytes.rst:258

msgid ""

"This function does not do type checking; it is undefined behavior to pass "

"*bytes* as a non-bytes object or ``NULL``."

msgstr ""

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

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:267

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:274

msgid ""

"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* "

"must be the size of *s*."

msgstr ""

#: ../../c-api/bytes.rst:277

msgid ""

"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. "

"If *errors* is ``NULL``, then ``\"strict\"`` is used by default."

msgstr ""

#: ../../c-api/bytes.rst:280

msgid ""

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

msgstr ""

#: ../../c-api/bytes.rst:284

msgid "*unicode* and *recode_encoding* are now unused."

msgstr ""

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

msgid "PyBytesWriter"

msgstr ""

#: ../../c-api/bytes.rst:293

msgid ""

"The :c:type:`PyBytesWriter` API can be used to create a Python :class:"

"`bytes` object."

msgstr ""

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

msgid "A bytes writer instance."

msgstr ""

#: ../../c-api/bytes.rst:302

msgid ""

"The API is **not thread safe**: a writer should only be used by a single "

"thread at the same time."

msgstr ""

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

msgid ""

"The instance must be destroyed by :c:func:`PyBytesWriter_Finish` on success, "

"or :c:func:`PyBytesWriter_Discard` on error."

msgstr ""

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

msgid "Create, Finish, Discard"

msgstr ""

#: ../../c-api/bytes.rst:314

msgid "Create a :c:type:`PyBytesWriter` to write *size* bytes."

msgstr ""

#: ../../c-api/bytes.rst:316

msgid ""

"If *size* is greater than zero, allocate *size* bytes, and set the writer "

"size to *size*. The caller is responsible to write *size* bytes using :c:"

"func:`PyBytesWriter_GetData`. This function does not overallocate."

msgstr ""

#: ../../c-api/bytes.rst:321 ../../c-api/bytes.rst:450

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

msgstr ""

#: ../../c-api/bytes.rst:323 ../../c-api/bytes.rst:426

msgid "*size* must be positive or zero."

msgstr ""

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

msgid ""

"Finish a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."

msgstr ""

#: ../../c-api/bytes.rst:330

msgid ""

"On success, return a Python :class:`bytes` object. On error, set an "

"exception and return ``NULL``."

msgstr ""

#: ../../c-api/bytes.rst:333

msgid ""

"The writer instance is invalid after the call in any case. No API can be "

"called on the writer after :c:func:`PyBytesWriter_Finish`."

msgstr ""

#: ../../c-api/bytes.rst:338

msgid ""

"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer to *size* "

"bytes before creating the :class:`bytes` object."

msgstr ""

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

msgid ""

"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer using *buf* "

"pointer before creating the :class:`bytes` object."

msgstr ""

#: ../../c-api/bytes.rst:346

msgid ""

"Set an exception and return ``NULL`` if *buf* pointer is outside the "

"internal buffer bounds."

msgstr ""

#: ../../c-api/bytes.rst:349 ../../c-api/bytes.rst:454

msgid "Function pseudo-code::"

msgstr ""

#: ../../c-api/bytes.rst:351

msgid ""

"Py_ssize_t size = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"

"return PyBytesWriter_FinishWithSize(writer, size);"

msgstr ""

#: ../../c-api/bytes.rst:356

msgid ""

"Discard a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."

msgstr ""

#: ../../c-api/bytes.rst:358

msgid "Do nothing if *writer* is ``NULL``."

msgstr ""

#: ../../c-api/bytes.rst:360

msgid ""

"The writer instance is invalid after the call. No API can be called on the "

"writer after :c:func:`PyBytesWriter_Discard`."

msgstr ""

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

msgid "High-level API"

msgstr ""

#: ../../c-api/bytes.rst:368

msgid ""

"Grow the *writer* internal buffer by *size* bytes, write *size* bytes of "

"*bytes* at the *writer* end, and add *size* to the *writer* size."

msgstr ""

#: ../../c-api/bytes.rst:372

msgid ""

"If *size* is equal to ``-1``, call ``strlen(bytes)`` to get the string "

"length."

msgstr ""

#: ../../c-api/bytes.rst:375 ../../c-api/bytes.rst:384

#: ../../c-api/bytes.rst:423 ../../c-api/bytes.rst:436

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

msgstr ""

#: ../../c-api/bytes.rst:380

msgid ""

"Similar to :c:func:`PyBytes_FromFormat`, but write the output directly at "

"the writer end. Grow the writer internal buffer on demand. Then add the "

"written size to the writer size."

msgstr ""

#: ../../c-api/bytes.rst:389

msgid "Getters"

msgstr ""

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

msgid "Get the writer size."

msgstr ""

#: ../../c-api/bytes.rst:395

msgid ""

"The function does not invalidate pointers returned by :c:func:"

"`PyBytesWriter_GetData`."

msgstr ""

#: ../../c-api/bytes.rst:398 ../../c-api/bytes.rst:408

msgid "The function cannot fail."

msgstr ""

#: ../../c-api/bytes.rst:402

msgid "Get the writer data: start of the internal buffer."

msgstr ""

#: ../../c-api/bytes.rst:404

msgid ""

"The pointer remains valid until a :c:type:`PyBytesWriter` function other "

"than :c:func:`PyBytesWriter_GetData` or :c:func:`PyBytesWriter_GetSize` is "

"called on *writer*."

msgstr ""

#: ../../c-api/bytes.rst:412

msgid "Low-level API"

msgstr ""

#: ../../c-api/bytes.rst:416

msgid ""

"Resize the writer to *size* bytes. It can be used to enlarge or to shrink "

"the writer. This function typically overallocates to achieve amortized "

"performance when resizing multiple times."

msgstr ""

#: ../../c-api/bytes.rst:421 ../../c-api/bytes.rst:434

msgid "Newly allocated bytes are left uninitialized."

msgstr ""

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

msgid ""

"Resize the writer by adding *grow* bytes to the current writer size. This "

"function typically overallocates to achieve amortized performance when "

"resizing multiple times."

msgstr ""

#: ../../c-api/bytes.rst:439

msgid "*size* can be negative to shrink the writer."

msgstr ""

#: ../../c-api/bytes.rst:443

msgid ""

"Similar to :c:func:`PyBytesWriter_Grow`, but update also the *buf* pointer."

msgstr ""

#: ../../c-api/bytes.rst:446

msgid ""

"The *buf* pointer is moved if the internal buffer is moved in memory. The "

"*buf* relative position within the internal buffer is left unchanged."

msgstr ""

#: ../../c-api/bytes.rst:452

msgid "*buf* must not be ``NULL``."

msgstr ""

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

msgid ""

"Py_ssize_t pos = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"

"if (PyBytesWriter_Grow(writer, size) < 0) {\n"

" return NULL;\n"

"}\n"

"return (char*)PyBytesWriter_GetData(writer) + pos;"

msgstr ""

#: ../../c-api/bytes.rst:18

msgid "object"

msgstr ""

#: ../../c-api/bytes.rst:18

msgid "bytes"

msgstr ""