function.po

# 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
# Inada Naoki <songofacandy@gmail.com>, 2026
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-29 19:20+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: Inada Naoki <songofacandy@gmail.com>, 2026\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/function.rst:6
msgid "Function Objects"
msgstr "Function オブジェクト"

#: ../../c-api/function.rst:10
msgid "There are a few functions specific to Python functions."
msgstr "Functionオブジェクト固有の関数はわずかです。"

#: ../../c-api/function.rst:15
msgid "The C structure used for functions."
msgstr "関数に使われるCの構造体。"

#: ../../c-api/function.rst:22
msgid ""
"This is an instance of :c:type:`PyTypeObject` and represents the Python "
"function type.  It is exposed to Python programmers as ``types."
"FunctionType``."
msgstr ""
":c:type:`PyTypeObject` 型のインスタンスで、 Python の関数型を表します。これ"
"は Python プログラムに ``types.FunctionType`` として公開されています。"

#: ../../c-api/function.rst:28
msgid ""
"Return true if *o* is a function object (has type :c:data:"
"`PyFunction_Type`). The parameter must not be ``NULL``.  This function "
"always succeeds."
msgstr ""
"*o* が関数オブジェクト (:c:data:`PyFunction_Type` 型である) 場合に真を返しま"
"す。パラメータは ``NULL`` にできません。この関数は常に成功します。"

#: ../../c-api/function.rst:34
msgid ""
"Return a new function object associated with the code object *code*. "
"*globals* must be a dictionary with the global variables accessible to the "
"function."
msgstr ""
"コードオブジェクト *code* に関連付けられた新しい関数オブジェクトを返します。"
"*globals* はこの関数からアクセスできるグローバル変数の辞書でなければなりませ"
"ん。"

#: ../../c-api/function.rst:37
msgid ""
"The function's docstring and name are retrieved from the code object. :attr:"
"`~function.__module__` is retrieved from *globals*. The argument defaults, "
"annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` "
"is set to the same value as the code object's :attr:`~codeobject."
"co_qualname` field."
msgstr ""
"関数のドキュメント文字列と名前はコードオブジェクトから取得されます。\n"
":attr:`~function.__module__` は *globals* から取得されます。\n"
"引数のデフォルト値やアノテーション、クロージャは ``NULL`` に設定されます。 :"
"attr:`~function.__qualname__` はコードオブジェクトの :attr:`~codeobject."
"co_qualname` フィールドと同じ値に設定されます。"

#: ../../c-api/function.rst:46
msgid ""
"As :c:func:`PyFunction_New`, but also allows setting the function object's :"
"attr:`~function.__qualname__` attribute. *qualname* should be a unicode "
"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set "
"to the same value as the code object's :attr:`~codeobject.co_qualname` field."
msgstr ""
":c:func:`PyFunction_New` に似ていますが、関数オブジェクトの :attr:`~function."
"__qualname__` 属性に値をセットできます。\n"
"*qualname* はユニコードオブジェクトか ``NULL`` でなくてはなりません。"
"``NULL`` だった場合、 :attr:`!__qualname__` 属性にはコードオブジェクトの :"
"attr:`~codeobject.co_qualname` フィールドと同じ値がセットされます。"

#: ../../c-api/function.rst:57
msgid "Return the code object associated with the function object *op*."
msgstr "関数オブジェクト *op* に関連付けられたコードオブジェクトを返します。"

#: ../../c-api/function.rst:62
msgid "Return the globals dictionary associated with the function object *op*."
msgstr "関数オブジェクト *op* に関連付けられたglobals辞書を返します。"

msgid ""
"Return a :term:`borrowed reference` to the :attr:`~function.__module__` "
"attribute of the :ref:`function object <user-defined-funcs>` *op*. It can be "
"*NULL*."
msgstr ""
":ref:`関数オブジェクト <user-defined-funcs>` ``op`` の :attr:`~function."
"__module__` 属性への :term:`借用参照 <borrowed reference>` を返します。\n"
"``NULL`` の場合もあります。"

msgid ""
"This is normally a :class:`string <str>` containing the module name, but can "
"be set to any other object by Python code."
msgstr ""
"通常はモジュール名を含む :class:`文字列 <str>` ですが、Python コードで任意の"
"別のオブジェクトに設定できます。"

#: ../../c-api/function.rst:77
msgid ""
"Return the argument default values of the function object *op*. This can be "
"a tuple of arguments or ``NULL``."
msgstr ""
"関数オブジェクト *op* の引数のデフォルト値を返します。\n"
"引数のタプルか ``NULL`` になります。"

#: ../../c-api/function.rst:83
msgid ""
"Set the argument default values for the function object *op*. *defaults* "
"must be ``Py_None`` or a tuple."
msgstr ""
"関数オブジェクト *op* の引数のデフォルト値を設定します。\n"
"*defaults* は ``Py_None`` かタプルでなければいけません。"

#: ../../c-api/function.rst:86 ../../c-api/function.rst:125
#: ../../c-api/function.rst:139
msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."
msgstr "失敗した時は、 :exc:`SystemError` を発生させ、 ``-1`` を返します。"

msgid "Set the vectorcall field of a given function object *func*."
msgstr ""
"指定された関数オブジェクト ``func`` の vectorcall フィールドを設定します。"

msgid ""
"Warning: extensions using this API must preserve the behavior of the "
"unaltered (default) vectorcall function!"
msgstr ""
"警告: この API を使う拡張は、変更前の (デフォルトの) vectorcall 関数の動作を"
"維持しなければなりません。"

msgid ""
"Return the keyword-only argument default values of the function object *op*. "
"This can be a dictionary of arguments or ``NULL``."
msgstr ""
"関数オブジェクト ``op`` のキーワード専用引数のデフォルト値を返します。\n"
"引数の辞書、または ``NULL`` です。"

msgid ""
"Set the keyword-only argument default values of the function object *op*. "
"*defaults* must be a dictionary of keyword-only arguments or ``Py_None``."
msgstr ""
"関数オブジェクト ``op`` のキーワード専用引数のデフォルト値を設定します。\n"
"``defaults`` はキーワード専用引数の辞書、または ``Py_None`` でなければなりま"
"せん。"

msgid ""
"This function returns ``0`` on success, and returns ``-1`` with an exception "
"set on failure."
msgstr ""
"成功した場合は ``0`` を返し、失敗した場合は例外を設定して ``-1`` を返します。"

#: ../../c-api/function.rst:116
msgid ""
"Return the closure associated with the function object *op*. This can be "
"``NULL`` or a tuple of cell objects."
msgstr ""
"関数オブジェクト *op* に設定されたクロージャを返します。\n"
"``NULL`` か cell オブジェクトのタプルです。"

#: ../../c-api/function.rst:122
msgid ""
"Set the closure associated with the function object *op*. *closure* must be "
"``Py_None`` or a tuple of cell objects."
msgstr ""
"関数オブジェクト *op* にクロージャを設定します。\n"
"*closure* は、``Py_None`` もしくは cell オブジェクトのタプルでなければなりま"
"せん。"

#: ../../c-api/function.rst:130
msgid ""
"Return the annotations of the function object *op*. This can be a mutable "
"dictionary or ``NULL``."
msgstr ""
"関数オブジェクト *op* のアノテーションを返します。\n"
"返り値は修正可能な辞書か ``NULL`` になります。"

#: ../../c-api/function.rst:136
msgid ""
"Set the annotations for the function object *op*. *annotations* must be a "
"dictionary or ``Py_None``."
msgstr ""
"関数オブジェクト *op* のアノテーションを設定します。\n"
"*annotations* は辞書か、``Py_None`` でなければなりません。"

msgid ""
"These functions are similar to their ``PyFunction_Get*`` counterparts, but "
"do not do type checking. Passing anything other than an instance of :c:data:"
"`PyFunction_Type` is undefined behavior."
msgstr ""
"これらの関数は、対応する ``PyFunction_Get*`` 関数と同様ですが、型のチェックを"
"行いません。\n"
":c:data:`PyFunction_Type` のインスタンス以外を渡すと、動作は未定義です。"

msgid ""
"Register *callback* as a function watcher for the current interpreter. "
"Return an ID which may be passed to :c:func:`PyFunction_ClearWatcher`. In "
"case of error (e.g. no more watcher IDs available), return ``-1`` and set an "
"exception."
msgstr ""
"現在のインタープリタの関数ウォッチャーとして ``callback`` を登録します。\n"
":c:func:`PyFunction_ClearWatcher` に渡せる ID を返します。\n"
"エラーの場合 (例えば利用可能なウォッチャー ID がない場合) は、例外を設定して "
"``-1`` を返します。"

msgid ""
"Clear watcher identified by *watcher_id* previously returned from :c:func:"
"`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on "
"success, or ``-1`` and set an exception on error (e.g.  if the given "
"*watcher_id* was never registered.)"
msgstr ""
"現在のインタープリタについて、:c:func:`PyFunction_AddWatcher` が以前返した "
"``watcher_id`` で識別されるウォッチャーを解除します。\n"
"成功した場合は ``0`` を返します。\n"
"エラーの場合 (例えば指定した ``watcher_id`` が登録されていない場合) は、例外"
"を設定して ``-1`` を返します。"

msgid "Enumeration of possible function watcher events:"
msgstr "関数ウォッチャーで発生し得るイベントの列挙型。"

msgid "``PyFunction_EVENT_CREATE``"
msgstr "``PyFunction_EVENT_CREATE``"

msgid "``PyFunction_EVENT_DESTROY``"
msgstr "``PyFunction_EVENT_DESTROY``"

msgid "``PyFunction_EVENT_MODIFY_CODE``"
msgstr "``PyFunction_EVENT_MODIFY_CODE``"

msgid "``PyFunction_EVENT_MODIFY_DEFAULTS``"
msgstr "``PyFunction_EVENT_MODIFY_DEFAULTS``"

msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"
msgstr "``PyFunction_EVENT_MODIFY_KWDEFAULTS``"

msgid "``PyFunction_EVENT_MODIFY_QUALNAME``"
msgstr "``PyFunction_EVENT_MODIFY_QUALNAME``"

msgid ""
"Apply the macro *V* to each suffix of :c:type:`PyFunction_WatchEvent` "
"constants. Currently expands to ``V(CREATE) V(DESTROY) V(MODIFY_CODE) "
"V(MODIFY_DEFAULTS) V(MODIFY_KWDEFAULTS) V(MODIFY_QUALNAME)``. The macro *V* "
"must accept one event name and supply any punctuation needed between "
"expansions."
msgstr ""
":c:type:`PyFunction_WatchEvent` 定数の各接尾辞にマクロ ``V`` を適用します。\n"
"現在は ``V(CREATE) V(DESTROY) V(MODIFY_CODE) V(MODIFY_DEFAULTS) "
"V(MODIFY_KWDEFAULTS) V(MODIFY_QUALNAME)`` に展開されます。\n"
"マクロ ``V`` は一つのイベント名を受け取り、展開結果の間に必要な区切り記号を補"
"う必要があります。"

msgid "Type of a function watcher callback function."
msgstr "関数ウォッチャーのコールバック関数の型。"

msgid ""
"If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` "
"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:"
"`borrowed reference` to the new value that is about to be stored in *func* "
"for the attribute that is being modified."
msgstr ""
"``event`` が ``PyFunction_EVENT_CREATE`` または ``PyFunction_EVENT_DESTROY`` "
"の場合、``new_value`` は ``NULL`` です。\n"
"それ以外の場合、``new_value`` は ``func`` の変更対象の属性に格納しようとして"
"いる新しい値への :term:`借用参照 <borrowed reference>` です。"

msgid ""
"The callback may inspect but must not modify *func*; doing so could have "
"unpredictable effects, including infinite recursion."
msgstr ""
"コールバックは ``func`` を調べても構いませんが、変更してはいけません。\n"
"変更すると、無限再帰など予測できない結果を招く可能性があります。"

msgid ""
"If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked "
"after *func* has been fully initialized. Otherwise, the callback is invoked "
"before the modification to *func* takes place, so the prior state of *func* "
"can be inspected. The runtime is permitted to optimize away the creation of "
"function objects when possible. In such cases no event will be emitted. "
"Although this creates the possibility of an observable difference of runtime "
"behavior depending on optimization decisions, it does not change the "
"semantics of the Python code being executed."
msgstr ""
"``event`` が ``PyFunction_EVENT_CREATE`` の場合、コールバックは ``func`` の初"
"期化がすべて完了した後で呼び出されます。\n"
"それ以外の場合は ``func`` を変更する前に呼び出されるので、変更前の状態を調べ"
"られます。\n"
"ランタイムは、可能であれば最適化によって関数オブジェクトの作成を省略しても構"
"いません。\n"
"その場合、イベントは発生しません。\n"
"このため、最適化の判断によって観測できる実行時の動作に違いが生じる可能性はあ"
"りますが、実行される Python コードの意味は変わりません。"

msgid ""
"If *event* is ``PyFunction_EVENT_DESTROY``, taking a reference in the "
"callback to the about-to-be-destroyed function will resurrect it, preventing "
"it from being freed at this time. When the resurrected object is destroyed "
"later, any watcher callbacks active at that time will be called again."
msgstr ""
"``event`` が ``PyFunction_EVENT_DESTROY`` の場合、コールバック内で破棄されよ"
"うとしている関数への参照を取得すると、その関数が復活し、この時点での解放を防"
"ぎます。\n"
"復活したオブジェクトが後で破棄されるときは、その時点で有効なウォッチャーの"
"コールバックが再び呼び出されます。"

msgid ""
"If the callback sets an exception, it must return ``-1``; this exception "
"will be printed as an unraisable exception using :c:func:"
"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
msgstr ""
"コールバックが例外を設定した場合は ``-1`` を返す必要があります。\n"
"その例外は、:c:func:`PyErr_WriteUnraisable` を使って送出できない例外として表"
"示されます。\n"
"それ以外の場合は ``0`` を返してください。"

msgid ""
"There may already be a pending exception set on entry to the callback. In "
"this case, the callback should return ``0`` with the same exception still "
"set. This means the callback may not call any other API that can set an "
"exception unless it saves and clears the exception state first, and restores "
"it before returning."
msgstr ""
"コールバックに入る時点で、すでに処理待ちの例外が設定されている場合がありま"
"す。\n"
"その場合、コールバックは同じ例外を設定したまま ``0`` を返すべきです。\n"
"そのため、例外を設定し得る別の API を呼び出す場合は、まず例外の状態を保存して"
"クリアし、戻る前に復元する必要があります。"

#: ../../c-api/function.rst:8
msgid "object"
msgstr "object"

#: ../../c-api/function.rst:8
msgid "function"
msgstr "関数"

#: ../../c-api/function.rst:20
msgid "MethodType (in module types)"
msgstr "MethodType (in module types)"