# 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-04-23 15:47+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\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 ""
"これらの API は、 Python 2 の組み込みのファイルオブジェクトの C API を最低限"
"エミュレートするためのものです。それらは、標準 C ライブラリでサポートされてい"
"るバッファ付き I/O (:c:expr:`FILE*`) に頼るために使われます。 Python 3 では、"
"ファイルとストリームは新しい :mod:`io` モジュールを使用され、そこに OS の低レ"
"ベルなバッファ付き I/O の上にいくつかの層が定義されています。下で解説されてい"
"る関数は、それらの新しい API の便利な C ラッパーであり、インタプリタでの内部"
"的なエラー通知に向いています; サードパーティーのコードは代わりに :mod:`io` "
"の API を使うことが推奨されます。"

#: ../../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 ""
"既に開かれているファイル *fd* のファイルディスクリプタから Python のファイル"
"オブジェクトを作成します。\n"
"引数 *name* 、 *encoding* 、 *errors* 、 *newline* には、デフォルトの値とし"
"て ``NULL`` が使えます。\n"
"*buffering* には *-1* を指定してデフォルトの値を使うことができます。\n"
"*name* は無視されるのですが、後方互換性のために残されています。\n"
"失敗すると ``NULL`` を返します。\n"
"より包括的な引数の解説は、 :func:`io.open` 関数のドキュメントを参照してくださ"
"い。"

#: ../../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 ""
"Python ストリームは自身のバッファリング層を持つため、ファイル記述子のOSレベル"
"のバッファリングと併用すると、様々な問題 (予期せぬデータ順) などを引き起こし"
"ます。"

#: ../../c-api/file.rst:35
msgid "Ignore *name* attribute."
msgstr "*name* 属性の無視。"

#: ../../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 ""
"*p* に関連づけられる ファイルディスクリプタを :c:expr:`int` として返します。"
"オブジェクトが整数なら、その値を返します。 整数でない場合、オブジェクトに :"
"meth:`~io.IOBase.fileno` メソッドがあれば呼び出します; このメソッドの返り値"
"は、ファイル記述子の値として返される整数でなければなりません。失敗すると例外"
"を設定して ``-1`` を返します。"

#: ../../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 ""
"``p.readline([n])`` と同じで、この関数はオブジェクト *p* の各行を読み出しま"
"す。 *p* はファイルオブジェクトか、 :meth:`~io.IOBase.readline` メソッドを持"
"つ何らかのオブジェクトでかまいません。 *n* が ``0`` の場合、行の長さに関係な"
"く正確に 1 行だけ読み出します。 *n* が ``0`` より大きければ、 *n* バイト以上"
"のデータは読み出しません; 従って、行の一部だけが返される場合があります。 どち"
"らの場合でも、読み出し後すぐにファイルの終端に到達した場合には空文字列を 返し"
"ます。 *n* が ``0`` より小さければ、長さに関わらず 1 行だけを 読み出します"
"が、すぐにファイルの終端に到達した場合には :exc:`EOFError` を送出します。"

#: ../../c-api/file.rst:65
msgid ""
"Overrides the normal behavior of :func:`io.open_code` to pass its parameter "
"through the provided handler."
msgstr ""
":func:`io.open_code` の通常の振る舞いを上書きして、そのパラメーターを提供され"
"たハンドラで渡します。"

#: ../../c-api/file.rst:68
msgid "The *handler* is a function of type:"
msgstr "ハンドラーは次の型の関数です。"

#: ../../c-api/file.rst:73
msgid ""
"Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, "
"where *path* is guaranteed to be :c:type:`PyUnicodeObject`."
msgstr ""
":c:expr:`PyObject *(\\*)(PyObject *path, void *userData)` と等価で、 *path* "
"は :c:type:`PyUnicodeObject` であることが保証されています。"

#: ../../c-api/file.rst:77
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 ""
"*userData* ポインタはフック関数に渡されます。\n"
"フック関数は別なランタイムから呼び出されるかもしれないので、このポインタは直"
"接 Python の状態を参照すべきではありません。"

#: ../../c-api/file.rst:81
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 ""
"このフック関数はインポート中に使われることを意図しているため、モジュールが "
"frozen なモジュールであるか ``sys.modules`` にある利用可能なモジュールである"
"ことが分かっている場合を除いては、フック関数の実行中に新しいモジュールをイン"
"ポートするのは避けてください。"

#: ../../c-api/file.rst:85
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:func:"
"`PyFile_SetOpenCodeHook` の呼び出しは失敗します。\n"
"この関数が失敗したときは、インタープリタが初期化されていた場合、 -1 を返して"
"例外をセットします。"

#: ../../c-api/file.rst:89
msgid "This function is safe to call before :c:func:`Py_Initialize`."
msgstr "この関数は :c:func:`Py_Initialize` より前に呼び出しても安全です。"

#: ../../c-api/file.rst:91
msgid ""
"Raises an :ref:`auditing event <auditing>` ``setopencodehook`` with no "
"arguments."
msgstr ""
"引数無しで :ref:`監査イベント <auditing>` ``setopencodehook`` を送出します。 "

#: ../../c-api/file.rst:98
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:103
msgid "This is analogous to :func:`io.open_code` in Python."
msgstr ""

#: ../../c-api/file.rst:105
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:114
msgid ""
"Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 encoded :c:"
"expr:`const char*`."
msgstr ""

#: ../../c-api/file.rst:124
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:128
msgid "If *obj* is ``NULL``, write the string ``\"<NULL>\"``."
msgstr ""

#: ../../c-api/file.rst:130
msgid ""
"Return ``0`` on success or ``-1`` on failure; the appropriate exception will "
"be set."
msgstr ""

#: ../../c-api/file.rst:135
msgid ""
"Write string *s* to file object *p*.  Return ``0`` on success or ``-1`` on "
"failure; the appropriate exception will be set."
msgstr ""
"文字列 *s* をファイルオブジェクト *p* に書き出します。成功した場合には ``0`` "
"を返し、失敗すると ``-1`` を返して適切な例外をセットします。"

#: ../../c-api/file.rst:140
msgid "Soft-deprecated API"
msgstr ""

#: ../../c-api/file.rst:144
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:150
msgid ""
"Use :c:func:`PyFile_FromFd` with defaults (``fd, NULL, \"w\", -1, NULL, "
"NULL, NULL, 0``) instead."
msgstr ""

#: ../../c-api/file.rst:154
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:8
msgid "object"
msgstr "object"

#: ../../c-api/file.rst:8
msgid "file"
msgstr "ファイル"

#: ../../c-api/file.rst:50
msgid "EOFError (built-in exception)"
msgstr "EOFError (組み込み例外)"

#: ../../c-api/file.rst:122
msgid "Py_PRINT_RAW (C macro)"
msgstr "Py_PRINT_RAW (Cのマクロ)"