iframe-proxy | Sunbelt Computer Software

158 lines (137 loc) · 5.31 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, 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
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-02-14 14:17+0000\n"
"PO-Revision-Date: 2021-06-28 00:48+0000\n"
"Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/fa/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: fa\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../c-api/file.rst:6
msgid "File Objects"
#: ../../c-api/file.rst:10
"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."
#: ../../c-api/file.rst:22
"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."
#: ../../c-api/file.rst:31
"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)."
#: ../../c-api/file.rst:35
msgid "Ignore *name* attribute."
#: ../../c-api/file.rst:41
"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."
#: ../../c-api/file.rst:52
"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."
#: ../../c-api/file.rst:65
"Overrides the normal behavior of :func:`io.open_code` to pass its parameter "
"through the provided handler."
#: ../../c-api/file.rst:68
msgid "The *handler* is a function of type:"
#: ../../c-api/file.rst:73
"Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, "
"where *path* is guaranteed to be :c:type:`PyUnicodeObject`."
#: ../../c-api/file.rst:77
"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."
#: ../../c-api/file.rst:81
"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``."
#: ../../c-api/file.rst:85
"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."
#: ../../c-api/file.rst:89
msgid "This function is safe to call before :c:func:`Py_Initialize`."
#: ../../c-api/file.rst:91
"Raises an :ref:`auditing event <auditing>` ``setopencodehook`` with no "
"arguments."
#: ../../c-api/file.rst:101
"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`.  Return ``0`` on success or ``-1`` on "
"failure; the appropriate exception will be set."
#: ../../c-api/file.rst:109
"Write string *s* to file object *p*.  Return ``0`` on success or ``-1`` on "
"failure; the appropriate exception will be set."
#: ../../c-api/file.rst:8
msgid "object"
#: ../../c-api/file.rst:8
msgid "file"
#: ../../c-api/file.rst:50
msgid "EOFError (built-in exception)"
#: ../../c-api/file.rst:99
msgid "Py_PRINT_RAW (C macro)"
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

file.po

Latest commit

History

file.po

File metadata and controls
