Merge 3.11 into 3.10

github-actions · github-actions · commit 72fbdfef5474 · 2023-05-03T23:51:45.000Z
diff --git a/c-api/buffer.po b/c-api/buffer.po
@@ -770,6 +770,10 @@ msgid ""
 "the exporter cannot provide a buffer of the exact type, it MUST raise :c:"
 "data:`PyExc_BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``."
 msgstr ""
+"*exporter* に *flags* で指定された方法で *view* を埋めるように要求します。\n"
+"もし exporter が指定されたとおりにバッファを提供できない場合、 :c:data:"
+"`PyExc_BufferError` を送出し、 ``view->obj`` を ``NULL`` に設定した上で、 "
+"``-1`` を返さなければなりません。"
 
 #: ../../c-api/buffer.rst:444
 msgid ""
@@ -778,6 +782,11 @@ msgid ""
 "redirect requests to a single object, ``view->obj`` MAY refer to this object "
 "instead of *exporter* (See :ref:`Buffer Object Structures <buffer-structs>`)."
 msgstr ""
+"成功したときは、 *view* を埋め、 ``view->obj`` に *exporter* への新しい参照を"
+"設定し、0を返します。チェイン状のバッファプロバイダがリクエストを単一のオブ"
+"ジェクトにリダイレクトするケースでは、 ``view->obj`` は *exporter* の代わりに"
+"このオブジェクトを参照します (:ref:`バッファオブジェクト構造体 <buffer-"
+"structs>` を参照してください)。"
 
 #: ../../c-api/buffer.rst:449
 msgid ""
@@ -798,6 +807,9 @@ msgid ""
 ">obj``. This function MUST be called when the buffer is no longer being "
 "used, otherwise reference leaks may occur."
 msgstr ""
+"バッファ *view* を解放し、 ``view->obj`` の参照カウントを1つ減らします。\n"
+"この関数はバッファが使われることがなくなったときに呼び出さなければならず、そ"
+"うしないと参照のリークが起こり得ます。"
 
 #: ../../c-api/buffer.rst:461
 msgid ""
@@ -897,6 +909,10 @@ msgid ""
 "Otherwise, raise :c:data:`PyExc_BufferError`, set ``view->obj`` to ``NULL`` "
 "and return ``-1``;"
 msgstr ""
+"成功したときは、 ``view->obj`` に *exporter* への新しい参照を設定し、 0 を返"
+"します。\n"
+"失敗したときは、 :c:data:`PyExc_BufferError` を送出し、 ``view->obj`` に "
+"``NULL`` を設定し、 ``-1`` を返します;"
 
 #: ../../c-api/buffer.rst:523
 msgid ""
diff --git a/c-api/call.po b/c-api/call.po
@@ -24,7 +24,7 @@ msgstr ""
 
 #: ../../c-api/call.rst:6
 msgid "Call Protocol"
-msgstr "Call Protocol"
+msgstr "Call プロトコル"
 
 #: ../../c-api/call.rst:8
 msgid ""
@@ -396,6 +396,9 @@ msgid ""
 "*args* must not be *NULL*; use an empty tuple if no arguments are needed. If "
 "no named arguments are needed, *kwargs* can be *NULL*."
 msgstr ""
+"*args* は *NULL* であってはならず、引数を必要としない場合は空のタプルを使って"
+"ください。\n"
+"*kwargs* は *NULL* でも構いません。"
 
 #: ../../c-api/call.rst:227 ../../c-api/call.rst:239 ../../c-api/call.rst:250
 #: ../../c-api/call.rst:261 ../../c-api/call.rst:273 ../../c-api/call.rst:293
@@ -456,6 +459,9 @@ msgid ""
 "Note that if you only pass :c:expr:`PyObject *` args, :c:func:"
 "`PyObject_CallFunctionObjArgs` is a faster alternative."
 msgstr ""
+":c:expr:`PyObject *` args だけを引数に渡す場合は、 :c:func:"
+"`PyObject_CallFunctionObjArgs` がより速い方法であることを覚えておいてくださ"
+"い。 "
 
 #: ../../c-api/call.rst:281
 msgid "The type of *format* was changed from ``char *``."
@@ -467,6 +473,10 @@ msgid ""
 "arguments.  The C arguments are described by a :c:func:`Py_BuildValue` "
 "format string that should produce a tuple."
 msgstr ""
+"オブジェクト *obj* の *name* という名前のメソッドを、いくつかの C 引数ととも"
+"に呼び出します。\n"
+"C 引数はタプルを生成する :c:func:`Py_BuildValue` 形式のフォーマット文字列で記"
+"述されています。"
 
 #: ../../c-api/call.rst:291
 msgid "The format can be *NULL*, indicating that no arguments are provided."
@@ -483,6 +493,9 @@ msgid ""
 "Note that if you only pass :c:expr:`PyObject *` args, :c:func:"
 "`PyObject_CallMethodObjArgs` is a faster alternative."
 msgstr ""
+":c:expr:`PyObject *` args だけを引数に渡す場合は、 :c:func:"
+"`PyObject_CallMethodObjArgs` がより速い方法であることを覚えておいてくださ"
+"い。 "
 
 #: ../../c-api/call.rst:302
 msgid "The types of *name* and *format* were changed from ``char *``."
@@ -494,6 +507,9 @@ msgid ""
 "`PyObject *` arguments.  The arguments are provided as a variable number of "
 "parameters followed by *NULL*."
 msgstr ""
+"呼び出し可能な Python オブジェクト *callable* を可変数個の :c:expr:`PyObject "
+"*` 引数とともに呼び出します。引数列は末尾に *NULL* がついた可変数個のパラメタ"
+"として与えます。"
 
 #: ../../c-api/call.rst:315
 msgid ""
@@ -508,6 +524,10 @@ msgid ""
 "number of :c:expr:`PyObject *` arguments.  The arguments are provided as a "
 "variable number of parameters followed by *NULL*."
 msgstr ""
+"Python オブジェクト *obj* のメソッドを呼び出します、メソッド名は Python 文字"
+"列オブジェクト *name* で与えます。可変数個の :c:expr:`PyObject *` 引数と共に"
+"呼び出されます. 引数列は末尾に *NULL* がついた可変数個のパラメタとして与えま"
+"す。"
 
 #: ../../c-api/call.rst:332
 msgid ""
diff --git a/c-api/mapping.po b/c-api/mapping.po
@@ -42,6 +42,12 @@ msgid ""
 "determine what type of keys the class supports. This function always "
 "succeeds."
 msgstr ""
+"オブジェクトがマップ型プロトコルを提供しているか、スライスをサポートしている"
+"場合は ``1`` を、そうでない場合は ``0`` を返します。\n"
+":meth:`__getitem__` メソッドを持つ Python クラスについては ``1`` を返すのに注"
+"意してください。そうなる理由は、一般的にはクラスがどの種類のキーをサポートし"
+"ているかを判別するのが不可能だからです。\n"
+"この関数は常に成功します。"
 
 #: ../../c-api/mapping.rst:25
 msgid ""
diff --git a/c-api/number.po b/c-api/number.po
@@ -86,6 +86,11 @@ msgid ""
 "point value when passed two integers.  This is the equivalent of the Python "
 "expression ``o1 / o2``."
 msgstr ""
+"成功すると、数学的な *o1* の *o2* による除算値に対する妥当な近似 (reasonable "
+"approximation) を返し、失敗すると ``NULL`` を返します。全ての実数を 2 を基数"
+"として表現するのは不可能なため、二進の浮動小数点数は \"近似値\" しか表現でき"
+"ません。このため、戻り値も近似になります。この関数に二つの整数を渡した際、浮"
+"動小数点の値を返すことがあります。Python の式 ``o1 / o2`` と同じです。"
 
 #: ../../c-api/number.rst:61
 msgid ""
@@ -249,6 +254,12 @@ msgid ""
 "*o1* supports it. This is the equivalent of the Python statement ``o1 /= "
 "o2``."
 msgstr ""
+"成功すると、数学的な *o1* の *o2* による除算値に対する妥当な近似 (reasonable "
+"approximation) を返し、失敗すると ``NULL`` を返します。全ての実数を 2 を基数"
+"として表現するのは不可能なため、二進の浮動小数点数は \"近似値\" しか表現でき"
+"ません。このため、戻り値も近似になります。この関数に二つの整数を渡した際、浮"
+"動小数点の値を返すことがあります。*o1* が *in-place* 演算をサポートする場合、"
+"in-place 演算を行います。Python の文 ``o1 /= o2`` と同じです。"
 
 #: ../../c-api/number.rst:188
 msgid ""
@@ -378,6 +389,8 @@ msgid ""
 "interpreted as an integer.  If the call fails, an exception is raised and "
 "``-1`` is returned."
 msgstr ""
+"*o* を整数として解釈可能だった場合、:c:type:`Py_ssize_t` 型の値に変換して返し"
+"ます。呼び出しが失敗したら、例外が送出され、 ``-1`` が返されます。"
 
 #: ../../c-api/number.rst:279
 msgid ""
@@ -388,10 +401,19 @@ msgid ""
 "exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` for a "
 "negative integer or ``PY_SSIZE_T_MAX`` for a positive integer."
 msgstr ""
+"もし *o* がPythonのintに変換できたのに、:c:type:`Py_ssize_t` への変換が :exc:"
+"`OverflowError` になる場合は、 *exc* 引数で渡された型 (普通は :exc:"
+"`IndexError` か :exc:`OverflowError`) の例外を送出します。もし、 *exc* が "
+"``NULL`` なら、例外はクリアされて、値が負の場合は ``PY_SSIZE_T_MIN`` へ、正の"
+"場合は ``PY_SSIZE_T_MAX`` へと制限されます。"
 
 #: ../../c-api/number.rst:289
 msgid ""
 "Returns ``1`` if *o* is an index integer (has the ``nb_index`` slot of the "
 "``tp_as_number`` structure filled in), and ``0`` otherwise. This function "
 "always succeeds."
 msgstr ""
+"*o* がインデックス整数である場合 (``tp_as_number`` 構造体の ``nb_index`` ス"
+"ロットが埋まっている場合) に ``1`` を返し、そうでない場合に ``0`` を返しま"
+"す。\n"
+"この関数は常に成功します。"
diff --git a/c-api/object.po b/c-api/object.po
@@ -152,8 +152,8 @@ msgid ""
 "If *v* is ``NULL``, the attribute is deleted, but this feature is deprecated "
 "in favour of using :c:func:`PyObject_DelAttrString`."
 msgstr ""
-"*v* が ``NULL`` のとき、アトリビュートは削除されます。この機能は :c:func:"
-"`PyObject_DelAttrString` のため、非推奨となっています。"
+"*v* が ``NULL`` の場合は属性が削除されますが、この機能は非推奨であり :c:func:"
+"`PyObject_DelAttrString` を使うのが望ましいです。"
 
 #: ../../c-api/object.rst:102
 msgid ""
@@ -392,6 +392,8 @@ msgid ""
 "The return type is now Py_hash_t.  This is a signed integer the same size "
 "as :c:type:`Py_ssize_t`."
 msgstr ""
+"返り値の型が Py_hash_t になりました。この型は、 :c:type:`Py_ssize_t` と同じサ"
+"イズをもつ符号付き整数です。"
 
 #: ../../c-api/object.rst:266
 msgid ""
@@ -433,6 +435,12 @@ msgid ""
 "which returns a pointer of type :c:expr:`PyTypeObject*`, except when the "
 "incremented reference count is needed."
 msgstr ""
+"*o* が ``NULL`` でない場合、オブジェクト *o* のオブジェクト型に相当する型オブ"
+"ジェクトを返します。失敗すると :exc:`SystemError` を送出して ``NULL`` を返し"
+"ます。 Python の式 ``type(o)`` と同じです。  この関数は戻り値の参照カウントを"
+"インクリメントします。参照カウントのインクリメントが必要でない限り、:c:expr:"
+"`PyTypeObject*` 型のポインタを返す :c:func:`Py_TYPE()` 関数の代わりに使う理由"
+"は全くありません。"
 
 #: ../../c-api/object.rst:301
 msgid ""
@@ -459,6 +467,10 @@ msgid ""
 "equivalent to the Python expression ``operator.length_hint(o, "
 "defaultvalue)``."
 msgstr ""
+"オブジェクト *o* の概算の長さを返します。\n"
+"最初に実際の長さを、次に :meth:`~object.__length_hint__` を使って概算の長さ"
+"を、そして最後にデフォルトの値を返そうとします。\n"
+"この関数は Python の式 ``operator.length_hint(o, defaultvalue)`` と同じです。"
 
 #: ../../c-api/object.rst:327
 msgid ""
diff --git a/c-api/sequence.po b/c-api/sequence.po
@@ -34,6 +34,13 @@ msgid ""
 "general it is impossible to determine what type of keys the class supports.  "
 "This function always succeeds."
 msgstr ""
+"オブジェクトがシーケンス型プロトコルを提供している場合は ``1`` を、そうでない"
+"場合は ``0`` を返します。\n"
+":meth:`__getitem__` メソッドを持つ Python クラスについては、それらが :class:"
+"`dict` のサブクラスでない限り、 ``1`` を返すのに注意してください。そうなる理"
+"由は、一般的にはクラスがどの種類のキーをサポートしているかを判別するのが不可"
+"能だからです。 \n"
+"この関数は常に成功します。"
 
 #: ../../c-api/sequence.rst:23
 msgid ""
@@ -114,6 +121,8 @@ msgid ""
 "If *v* is ``NULL``, the element is deleted, but this feature is deprecated "
 "in favour of using :c:func:`PySequence_DelItem`."
 msgstr ""
+"*v* が ``NULL`` の場合はその要素が削除されますが、この機能は非推奨であり、 :"
+"c:func:`PyObject_DelAttr` を使うのが望ましいです。"
 
 #: ../../c-api/sequence.rst:78
 msgid ""
@@ -230,6 +239,10 @@ msgid ""
 "`PySequence_Fast_GET_SIZE` is faster because it can assume *o* is a list or "
 "tuple."
 msgstr ""
+"*o* が ``NULL`` でなく、 :c:func:`PySequence_Fast` が返したオブジェクトである"
+"と仮定して、 *o* の長さを返します。 *o* のサイズは :c:func:`PySequence_Size` "
+"を呼び出しても得られますが、 :c:func:`PySequence_Fast_GET_SIZE` の方が *o* を"
+"リストかタプルであると仮定して処理するため、より高速です。"
 
 #: ../../c-api/sequence.rst:157
 msgid ""
diff --git a/c-api/type.po b/c-api/type.po
@@ -63,6 +63,10 @@ msgid ""
 "flag bits are guaranteed to be stable across Python releases, but access to :"
 "c:member:`~PyTypeObject.tp_flags` itself is not part of the limited API."
 msgstr ""
+"*type* のメンバーである :c:member:`~PyTypeObject.tp_flags` を返します。この関"
+"数は基本的に ``Py_LIMITED_API`` を定義して使うことを想定しています。それぞれ"
+"のフラグはpythonの異なるリリースで安定していることが保証されていますが、 :c:"
+"member:`~PyTypeObject.tp_flags` 自体は限定されたAPIの一部ではありません。"
 
 #: ../../c-api/type.rst:49
 msgid "The return type is now ``unsigned long`` rather than ``long``."
