python-docs-fa/c-api/file.po at 3.14 · python/python-docs-fa

116 lines (85 loc) · 5.81 KB
# 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:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-18 04:30+0000\n"
"PO-Revision-Date: 2021-06-28 00:48+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n"
"Language: fa\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"
msgid "File objects"
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."
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."
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)."
msgid "Ignore *name* attribute."
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."
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."
msgid "Overrides the normal behavior of :func:`io.open_code` to pass its parameter through the provided handler."
msgid "The *handler* is a function of type:"
msgid "Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, where *path* is guaranteed to be :c:type:`PyUnicodeObject`."
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."
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``."
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."
msgid "This function is safe to call before :c:func:`Py_Initialize`."
msgid "Raises an :ref:`auditing event <auditing>` ``setopencodehook`` with no arguments."
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."
msgid "This is analogous to :func:`io.open_code` in Python."
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."
msgid "Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 encoded :c:expr:`const char*`."
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`."
msgid "If *obj* is ``NULL``, write the string ``\"<NULL>\"``."
msgid "Return ``0`` on success or ``-1`` on failure; the appropriate exception will be set."
msgid "Write string *s* to file object *p*.  Return ``0`` on success or ``-1`` on failure; the appropriate exception will be set."
msgid "Soft-deprecated API"
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."
msgid "Use :c:func:`PyFile_FromFd` with defaults (``fd, NULL, \"w\", -1, NULL, NULL, NULL, 0``) instead."
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."
msgid "object"
msgid "file"
msgid "EOFError (built-in exception)"
msgid "Py_PRINT_RAW (C macro)"
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

file.po

Latest commit

History

file.po

File metadata and controls
