gcsupport.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2022
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-12-30 14:59+0000\n"
"PO-Revision-Date: 2022-11-05 17:21+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2022\n"
"Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/gcsupport.rst:6
msgid "Supporting Cyclic Garbage Collection"
msgstr "循環参照ガベージコレクションをサポートする"

#: ../../c-api/gcsupport.rst:8
msgid ""
"Python's support for detecting and collecting garbage which involves "
"circular references requires support from object types which are "
"\"containers\" for other objects which may also be containers.  Types which "
"do not store references to other objects, or which only store references to "
"atomic types (such as numbers or strings), do not need to provide any "
"explicit support for garbage collection."
msgstr ""
"Python が循環参照を含むガベージの検出とコレクションをサポートするには、他のオ"
"ブジェクトに対する \"コンテナ\" (他のオブジェクトには他のコンテナも含みます) "
"となるオブジェクト型によるサポートが必要です。他のオブジェクトに対する参照を"
"記憶しないオブジェクトや、(数値や文字列のような) アトム型 (atomic type) への"
"参照だけを記憶するような型では、ガベージコレクションに際して特別これといった"
"サポートを提供する必要はありません。"

#: ../../c-api/gcsupport.rst:15
msgid ""
"To create a container type, the :c:member:`~PyTypeObject.tp_flags` field of "
"the type object must include the :const:`Py_TPFLAGS_HAVE_GC` and provide an "
"implementation of the :c:member:`~PyTypeObject.tp_traverse` handler.  If "
"instances of the type are mutable, a :c:member:`~PyTypeObject.tp_clear` "
"implementation must also be provided."
msgstr ""
"コンテナ型を作るには、型オブジェクトの :c:member:`~PyTypeObject.tp_flags` "
"フィールドに :const:`Py_TPFLAGS_HAVE_GC` フラグが立っており、 :c:member:"
"`~PyTypeObject.tp_traverse` ハンドラの実装を提供しなければなりません。実装す"
"る型のインスタンスが変更可能な場合は、 :c:member:`~PyTypeObject.tp_clear` の"
"実装も提供しなければなりません。"

#: ../../c-api/gcsupport.rst:24
msgid ""
"Objects with a type with this flag set must conform with the rules "
"documented here.  For convenience these objects will be referred to as "
"container objects."
msgstr ""
"このフラグをセットした型のオブジェクトは、この節に述べた規則に適合しなければ"
"なりません。簡単のため、このフラグをセットした型のオブジェクトをコンテナオブ"
"ジェクトと呼びます。"

#: ../../c-api/gcsupport.rst:28
msgid "Constructors for container types must conform to two rules:"
msgstr ""
"コンテナ型のコンストラクタは以下の二つの規則に適合しなければなりません:"

#: ../../c-api/gcsupport.rst:30
msgid ""
"The memory for the object must be allocated using :c:func:`PyObject_GC_New` "
"or :c:func:`PyObject_GC_NewVar`."
msgstr ""
"オブジェクトのメモリは :c:func:`PyObject_GC_New` または :c:func:"
"`PyObject_GC_NewVar` で確保しなければなりません。"

#: ../../c-api/gcsupport.rst:33
msgid ""
"Once all the fields which may contain references to other containers are "
"initialized, it must call :c:func:`PyObject_GC_Track`."
msgstr ""
"他のコンテナへの参照が入るかもしれないフィールドが全て初期化されたら、すぐ"
"に :c:func:`PyObject_GC_Track` を呼び出さなければなりません。"

#: ../../c-api/gcsupport.rst:36
msgid ""
"Similarly, the deallocator for the object must conform to a similar pair of "
"rules:"
msgstr ""
"同様に、オブジェクトのメモリ解放関数も以下の二つの規則に適合しなければなりま"
"せん:"

#: ../../c-api/gcsupport.rst:39
msgid ""
"Before fields which refer to other containers are invalidated, :c:func:"
"`PyObject_GC_UnTrack` must be called."
msgstr ""
"他のコンテナを参照しているフィールドを無効化する前に、 :c:func:"
"`PyObject_GC_UnTrack` を呼び出さなければなりません。"

#: ../../c-api/gcsupport.rst:42
msgid ""
"The object's memory must be deallocated using :c:func:`PyObject_GC_Del`."
msgstr ""
"オブジェクトのメモリは :c:func:`PyObject_GC_Del` で解放しなければなりません。"

#: ../../c-api/gcsupport.rst:45
msgid ""
"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least a :"
"c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from its "
"subclass or subclasses."
msgstr ""

#: ../../c-api/gcsupport.rst:49
msgid ""
"When calling :c:func:`PyType_Ready` or some of the APIs that indirectly call "
"it like :c:func:`PyType_FromSpecWithBases` or :c:func:`PyType_FromSpec` the "
"interpreter will automatically populate the :c:member:`~PyTypeObject."
"tp_flags`, :c:member:`~PyTypeObject.tp_traverse` and :c:member:"
"`~PyTypeObject.tp_clear` fields if the type inherits from a class that "
"implements the garbage collector protocol and the child class does *not* "
"include the :const:`Py_TPFLAGS_HAVE_GC` flag."
msgstr ""

#: ../../c-api/gcsupport.rst:59
msgid ""
"Analogous to :c:func:`PyObject_New` but for container objects with the :"
"const:`Py_TPFLAGS_HAVE_GC` flag set."
msgstr ""
":c:func:`PyObject_New` に似ていますが、 :const:`Py_TPFLAGS_HAVE_GC` のセット"
"されたコンテナオブジェクト用です。"

#: ../../c-api/gcsupport.rst:65
msgid ""
"Analogous to :c:func:`PyObject_NewVar` but for container objects with the :"
"const:`Py_TPFLAGS_HAVE_GC` flag set."
msgstr ""
":c:func:`PyObject_NewVar` に似ていますが、 :const:`Py_TPFLAGS_HAVE_GC` のセッ"
"トされたコンテナオブジェクト用です。"

#: ../../c-api/gcsupport.rst:71
msgid ""
"Resize an object allocated by :c:func:`PyObject_NewVar`.  Returns the "
"resized object or ``NULL`` on failure.  *op* must not be tracked by the "
"collector yet."
msgstr ""
":c:func:`PyObject_NewVar` が確保したオブジェクトのメモリをリサイズします。\n"
"リサイズされたオブジェクトを返します。失敗すると ``NULL`` を返します。\n"
"*op* はコレクタに追跡されていてはなりません。"

#: ../../c-api/gcsupport.rst:77
msgid ""
"Adds the object *op* to the set of container objects tracked by the "
"collector.  The collector can run at unexpected times so objects must be "
"valid while being tracked.  This should be called once all the fields "
"followed by the :c:member:`~PyTypeObject.tp_traverse` handler become valid, "
"usually near the end of the constructor."
msgstr ""
"オブジェクト *op* を、コレクタによって追跡されるオブジェクトの集合に追加しま"
"す。コレクタは何回動くのかは予想できないので、追跡されている間はオブジェクト"
"は正しい状態でいなければなりません。 :c:member:`~PyTypeObject.tp_traverse` の"
"対象となる全てのフィールドが正しい状態になってすぐに、たいていはコンストラク"
"タの末尾付近で、呼び出すべきです。"

#: ../../c-api/gcsupport.rst:86
msgid ""
"Returns non-zero if the object implements the garbage collector protocol, "
"otherwise returns 0."
msgstr ""

#: ../../c-api/gcsupport.rst:89
msgid ""
"The object cannot be tracked by the garbage collector if this function "
"returns 0."
msgstr ""

#: ../../c-api/gcsupport.rst:94
msgid ""
"Returns 1 if the object type of *op* implements the GC protocol and *op* is "
"being currently tracked by the garbage collector and 0 otherwise."
msgstr ""

#: ../../c-api/gcsupport.rst:97
msgid "This is analogous to the Python function :func:`gc.is_tracked`."
msgstr ""

#: ../../c-api/gcsupport.rst:104
msgid ""
"Returns 1 if the object type of *op* implements the GC protocol and *op* has "
"been already finalized by the garbage collector and 0 otherwise."
msgstr ""

#: ../../c-api/gcsupport.rst:107
msgid "This is analogous to the Python function :func:`gc.is_finalized`."
msgstr ""

#: ../../c-api/gcsupport.rst:114
msgid ""
"Releases memory allocated to an object using :c:func:`PyObject_GC_New` or :c:"
"func:`PyObject_GC_NewVar`."
msgstr ""
":c:func:`PyObject_GC_New` や :c:func:`PyObject_GC_NewVar` を使って確保された"
"メモリを解放します。"

#: ../../c-api/gcsupport.rst:120
msgid ""
"Remove the object *op* from the set of container objects tracked by the "
"collector.  Note that :c:func:`PyObject_GC_Track` can be called again on "
"this object to add it back to the set of tracked objects.  The deallocator (:"
"c:member:`~PyTypeObject.tp_dealloc` handler) should call this for the object "
"before any of the fields used by the :c:member:`~PyTypeObject.tp_traverse` "
"handler become invalid."
msgstr ""
"オブジェクト *op* を、コレクタによって追跡されるオブジェクトの集合から除去し"
"ます。このオブジェクトに対して :c:func:`PyObject_GC_Track` を再度呼び出して、"
"追跡されるオブジェクトの集合に戻すことも可能です。 :c:member:`~PyTypeObject."
"tp_traverse` ハンドラの対象となるフィールドが正しくない状態になる前に、デアロ"
"ケータ (:c:member:`~PyTypeObject.tp_dealloc` ハンドラ) はオブジェクトに対し"
"て、この関数を呼び出すべきです。"

#: ../../c-api/gcsupport.rst:129
msgid ""
"The :c:func:`_PyObject_GC_TRACK` and :c:func:`_PyObject_GC_UNTRACK` macros "
"have been removed from the public C API."
msgstr ""
":c:func:`_PyObject_GC_TRACK` マクロと :c:func:`_PyObject_GC_UNTRACK` マクロは"
"公開 C API から外されました。"

#: ../../c-api/gcsupport.rst:132
msgid ""
"The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function "
"parameter of this type:"
msgstr ""
":c:member:`~PyTypeObject.tp_traverse` ハンドラはこの型の関数パラメータを受け"
"取ります:"

#: ../../c-api/gcsupport.rst:137
msgid ""
"Type of the visitor function passed to the :c:member:`~PyTypeObject."
"tp_traverse` handler. The function should be called with an object to "
"traverse as *object* and the third parameter to the :c:member:`~PyTypeObject."
"tp_traverse` handler as *arg*.  The Python core uses several visitor "
"functions to implement cyclic garbage detection; it's not expected that "
"users will need to write their own visitor functions."
msgstr ""
":c:member:`~PyTypeObject.tp_traverse` ハンドラに渡されるビジター関数 "
"(visitor function) の型です。この関数は、探索するオブジェクトを *object* とし"
"て、  :c:member:`~PyTypeObject.tp_traverse` ハンドラの第 3 引数を *arg* とし"
"て呼び出します。 Python のコアはいくつかのビジター関数を使って、ゴミとなった"
"循環参照を検出する仕組みを実装します; ユーザが自身のためにビジター関数を書く"
"必要が出てくることはないでしょう。"

#: ../../c-api/gcsupport.rst:144
msgid ""
"The :c:member:`~PyTypeObject.tp_traverse` handler must have the following "
"type:"
msgstr ""
":c:member:`~PyTypeObject.tp_traverse` ハンドラは次の型を持っていなければなり"
"ません:"

#: ../../c-api/gcsupport.rst:149
msgid ""
"Traversal function for a container object.  Implementations must call the "
"*visit* function for each object directly contained by *self*, with the "
"parameters to *visit* being the contained object and the *arg* value passed "
"to the handler.  The *visit* function must not be called with a ``NULL`` "
"object argument.  If *visit* returns a non-zero value that value should be "
"returned immediately."
msgstr ""
"コンテナオブジェクトのためのトラバーサル関数 (traversal function) です。\n"
"実装では、*self* に直接入っている各オブジェクトに対して *visit*  関数を呼び出"
"さなければなりません。\n"
"このとき、*visit* へのパラメタはコンテナに入っている各オブジェクトと、このハ"
"ンドラに渡された *arg* の値です。\n"
"*visit* 関数は ``NULL`` オブジェクトを引数に渡して呼び出してはなりません。\n"
"*visit* が非ゼロの値を返す場合、エラーが発生し、戻り値をそのまま返すようにし"
"なければなりません。"

#: ../../c-api/gcsupport.rst:156
msgid ""
"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:"
"func:`Py_VISIT` macro is provided.  In order to use this macro, the :c:"
"member:`~PyTypeObject.tp_traverse` implementation must name its arguments "
"exactly *visit* and *arg*:"
msgstr ""
":c:member:`~PyTypeObject.tp_traverse` ハンドラを簡潔に書くために、 :c:func:"
"`Py_VISIT` マクロが提供されています。このマクロを使うためには、 :c:member:"
"`~PyTypeObject.tp_traverse` の実装関数の引数は、一文字も違わず *visit* と "
"*arg* でなければなりません:"

#: ../../c-api/gcsupport.rst:163
msgid ""
"If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and "
"*arg*.  If *visit* returns a non-zero value, then return it. Using this "
"macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::"
msgstr ""
"*o* が ``NULL`` でなければ、 *o* と *arg* を引数にして *visit* コールバックを"
"呼び出します。\n"
"*visit* がゼロでない値を返した場合、その値を返します。\n"
"このマクロを使うと、 :c:member:`~PyTypeObject.tp_traverse` ハンドラは次のよう"
"になります::"

#: ../../c-api/gcsupport.rst:176
msgid ""
"The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:"
"`inquiry` type, or ``NULL`` if the object is immutable."
msgstr ""
":c:member:`~PyTypeObject.tp_clear` ハンドラは :c:type:`inquiry` 型であるか、"
"オブジェクトが不変 (immutable) な場合は ``NULL`` でなければなりません。"

#: ../../c-api/gcsupport.rst:182
msgid ""
"Drop references that may have created reference cycles.  Immutable objects "
"do not have to define this method since they can never directly create "
"reference cycles.  Note that the object must still be valid after calling "
"this method (don't just call :c:func:`Py_DECREF` on a reference).  The "
"collector will call this method if it detects that this object is involved "
"in a reference cycle."
msgstr ""
"循環参照を形成しているとおぼしき参照群を放棄します。変更不可能なオブジェクト"
"は循環参照を直接形成することが決してないので、この関数を定義する必要はありま"
"せん。このメソッドを呼び出した後でもオブジェクトは有効なままでなければならな"
"いので注意してください (参照に対して :c:func:`Py_DECREF` を呼ぶだけにしないで"
"ください)。ガベージコレクタは、オブジェクトが循環参照を形成していることを検出"
"した際にこのメソッドを呼び出します。"

#: ../../c-api/gcsupport.rst:191
msgid "Controlling the Garbage Collector State"
msgstr ""

#: ../../c-api/gcsupport.rst:193
msgid ""
"The C-API provides the following functions for controlling garbage "
"collection runs."
msgstr ""

#: ../../c-api/gcsupport.rst:198
msgid ""
"Perform a full garbage collection, if the garbage collector is enabled. "
"(Note that :func:`gc.collect` runs it unconditionally.)"
msgstr ""

#: ../../c-api/gcsupport.rst:201
msgid ""
"Returns the number of collected + unreachable objects which cannot be "
"collected. If the garbage collector is disabled or already collecting, "
"returns ``0`` immediately. Errors during garbage collection are passed to :"
"data:`sys.unraisablehook`. This function does not raise exceptions."
msgstr ""

#: ../../c-api/gcsupport.rst:211
msgid ""
"Enable the garbage collector: similar to :func:`gc.enable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""

#: ../../c-api/gcsupport.rst:219
msgid ""
"Disable the garbage collector: similar to :func:`gc.disable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""

#: ../../c-api/gcsupport.rst:227
msgid ""
"Query the state of the garbage collector: similar to :func:`gc.isenabled`. "
"Returns the current state, 0 for disabled and 1 for enabled."
msgstr ""