GitHub Viewer

# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-10-26 03:10+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/file.rst:6 msgid "File objects" msgstr "" #: ../../c-api/file.rst:10 msgid "" "These APIs are a minimal emulation of the Python 2 C API for built-in file " "objects, which used to rely on the buffered I/O (:c:expr:`FILE*`) support " "from the C standard library. In Python 3, files and streams use the new :" "mod:`io` module, which defines several layers over the low-level unbuffered " "I/O of the operating system. The functions described below are convenience " "C wrappers over these new APIs, and meant mostly for internal error " "reporting in the interpreter; third-party code is advised to access the :mod:" "`io` APIs instead." msgstr "" #: ../../c-api/file.rst:22 msgid "" "Create a Python file object from the file descriptor of an already opened " "file *fd*. The arguments *name*, *encoding*, *errors* and *newline* can be " "``NULL`` to use the defaults; *buffering* can be *-1* to use the default. " "*name* is ignored and kept for backward compatibility. Return ``NULL`` on " "failure. For a more comprehensive description of the arguments, please refer " "to the :func:`io.open` function documentation." msgstr "" #: ../../c-api/file.rst:31 msgid "" "Since Python streams have their own buffering layer, mixing them with OS-" "level file descriptors can produce various issues (such as unexpected " "ordering of data)." msgstr "" #: ../../c-api/file.rst:35 msgid "Ignore *name* attribute." msgstr "" #: ../../c-api/file.rst:41 msgid "" "Return the file descriptor associated with *p* as an :c:expr:`int`. If the " "object is an integer, its value is returned. If not, the object's :meth:" "`~io.IOBase.fileno` method is called if it exists; the method must return an " "integer, which is returned as the file descriptor value. Sets an exception " "and returns ``-1`` on failure." msgstr "" #: ../../c-api/file.rst:52 msgid "" "Equivalent to ``p.readline([n])``, this function reads one line from the " "object *p*. *p* may be a file object or any object with a :meth:`~io.IOBase." "readline` method. If *n* is ``0``, exactly one line is read, regardless of " "the length of the line. If *n* is greater than ``0``, no more than *n* " "bytes will be read from the file; a partial line can be returned. In both " "cases, an empty string is returned if the end of the file is reached " "immediately. If *n* is less than ``0``, however, one line is read " "regardless of length, but :exc:`EOFError` is raised if the end of the file " "is reached immediately." msgstr "" #: ../../c-api/file.rst:65 msgid "" "Read a line from the C stream *stream* into the buffer *buf*, like the C " "standard library function :c:func:`!fgets`, but treating all of ``\\n``, " "``\\r`` and ``\\r\\n`` as line endings (see :term:`universal newlines`). Any " "``\\r`` or ``\\r\\n`` read from the stream is stored in *buf* as a single " "``\\n``." msgstr "" #: ../../c-api/file.rst:71 msgid "" "At most ``n - 1`` characters are stored in *buf*; reading stops after a " "newline has been stored or when the end of the file is reached. The result " "is always null-terminated. *stream* should be opened in binary mode, so that " "the C library does not perform its own newline translation." msgstr "" #: ../../c-api/file.rst:77 msgid "" "Return *buf* on success. Return ``NULL`` if no characters could be read, " "because *stream* is at end of file, a read error occurred, or *n* is less " "than 2. Like :c:func:`!fgets`, this function does not distinguish between " "end of file and a read error, and it does not set an exception." msgstr "" #: ../../c-api/file.rst:83 msgid "*fobj* exists only for backward compatibility and must be ``NULL``." msgstr "" #: ../../c-api/file.rst:88 msgid "" "Overrides the normal behavior of :func:`io.open_code` to pass its parameter " "through the provided handler." msgstr "" #: ../../c-api/file.rst:91 msgid "The *handler* is a function of type:" msgstr "" #: ../../c-api/file.rst:96 msgid "" "Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, " "where *path* is guaranteed to be :c:type:`PyUnicodeObject`." msgstr "" #: ../../c-api/file.rst:100 msgid "" "The *userData* pointer is passed into the hook function. Since hook " "functions may be called from different runtimes, this pointer should not " "refer directly to Python state." msgstr "" #: ../../c-api/file.rst:104 msgid "" "As this hook is intentionally used during import, avoid importing new " "modules during its execution unless they are known to be frozen or available " "in ``sys.modules``." msgstr "" #: ../../c-api/file.rst:108 msgid "" "Once a hook has been set, it cannot be removed or replaced, and later calls " "to :c:func:`PyFile_SetOpenCodeHook` will fail. On failure, the function " "returns -1 and sets an exception if the interpreter has been initialized." msgstr "" #: ../../c-api/file.rst:112 msgid "This function is safe to call before :c:func:`Py_Initialize`." msgstr "" #: ../../c-api/file.rst:114 msgid "" "Raises an :ref:`auditing event ` ``setopencodehook`` with no " "arguments." msgstr "" #: ../../c-api/file.rst:121 msgid "" "Open *path* with the mode ``'rb'``. *path* must be a Python :class:`str` " "object. The behavior of this function may be overridden by :c:func:" "`PyFile_SetOpenCodeHook` to allow for some preprocessing of the text." msgstr "" #: ../../c-api/file.rst:126 msgid "This is analogous to :func:`io.open_code` in Python." msgstr "" #: ../../c-api/file.rst:128 msgid "" "On success, this function returns a :term:`strong reference` to a Python " "file object. On failure, this function returns ``NULL`` with an exception " "set." msgstr "" #: ../../c-api/file.rst:137 msgid "" "Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 encoded :c:" "expr:`const char*`." msgstr "" #: ../../c-api/file.rst:147 msgid "" "Write object *obj* to file object *p*. The only supported flag for *flags* " "is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is " "written instead of the :func:`repr`." msgstr "" #: ../../c-api/file.rst:151 msgid "If *obj* is ``NULL``, write the string ``\"\"``." msgstr "" #: ../../c-api/file.rst:153 msgid "" "Return ``0`` on success or ``-1`` on failure; the appropriate exception will " "be set." msgstr "" #: ../../c-api/file.rst:158 msgid "" "Write string *s* to file object *p*. Return ``0`` on success or ``-1`` on " "failure; the appropriate exception will be set." msgstr "" #: ../../c-api/file.rst:163 msgid "Soft-deprecated API" msgstr "" #: ../../c-api/file.rst:165 msgid "" "These are APIs that were included in Python's C API by mistake. They are " "documented solely for completeness; use other ``PyFile*`` APIs instead." msgstr "" #: ../../c-api/file.rst:172 msgid "" "Use :c:func:`PyFile_FromFd` with defaults (``fd, NULL, \"w\", -1, NULL, " "NULL, NULL, 0``) instead." msgstr "" #: ../../c-api/file.rst:179 msgid "" "Type of file-like objects used internally at Python startup when :py:mod:" "`io` is not yet available. Use Python :py:func:`open` or :c:func:" "`PyFile_FromFd` to create file objects instead." msgstr "" #: ../../c-api/file.rst:188 msgid "" "The string literal ``\"b\"``, used to open files in binary mode. Exposed for " "backwards compatibility only." msgstr "" #: ../../c-api/file.rst:8 msgid "object" msgstr "" #: ../../c-api/file.rst:8 msgid "file" msgstr "" #: ../../c-api/file.rst:50 msgid "EOFError (built-in exception)" msgstr "" #: ../../c-api/file.rst:145 msgid "Py_PRINT_RAW (C macro)" msgstr ""