module.po

# 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:
# Akira inamori <akira.inamori@tf-ebina.com>, 2021
# Arihiro TAKASE, 2023
# tomo, 2023
# Nozomu Kaneko <nozom.kaneko@gmail.com>, 2023
# 石井明久, 2024
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-04-04 14:18+0000\n"
"PO-Revision-Date: 2021-06-28 00:49+0000\n"
"Last-Translator: 石井明久, 2024\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/module.rst:6
msgid "Module Objects"
msgstr "モジュールオブジェクト (module object)"

#: ../../c-api/module.rst:15
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python module type.  "
"This is exposed to Python programs as ``types.ModuleType``."
msgstr ""
"この :c:type:`PyTypeObject` のインスタンスは Python のモジュールオブジェクト"
"型を表現します。このオブジェクトは、Python プログラムには ``types."
"ModuleType``  として公開されています。"

#: ../../c-api/module.rst:21
msgid ""
"Return true if *p* is a module object, or a subtype of a module object. This "
"function always succeeds."
msgstr ""
"*p* がモジュールオブジェクトかモジュールオブジェクトのサブタイプであるときに"
"真を返します。この関数は常に成功します。"

#: ../../c-api/module.rst:27
msgid ""
"Return true if *p* is a module object, but not a subtype of :c:data:"
"`PyModule_Type`.  This function always succeeds."
msgstr ""
"*p* がモジュールオブジェクトで、かつ :c:data:`PyModule_Type` のサブタイプでな"
"いときに真を返します。この関数は常に成功します。"

#: ../../c-api/module.rst:40
msgid ""
"Return a new module object with :attr:`module.__name__` set to *name*. The "
"module's :attr:`!__name__`, :attr:`~module.__doc__`, :attr:`~module."
"__package__` and :attr:`~module.__loader__` attributes are filled in (all "
"but :attr:`!__name__` are set to ``None``). The caller is responsible for "
"setting a :attr:`~module.__file__` attribute."
msgstr ""

#: ../../c-api/module.rst:46 ../../c-api/module.rst:272
#: ../../c-api/module.rst:474
msgid "Return ``NULL`` with an exception set on error."
msgstr ""

#: ../../c-api/module.rst:50
msgid ""
":attr:`~module.__package__` and :attr:`~module.__loader__` are now set to "
"``None``."
msgstr ""

#: ../../c-api/module.rst:57
msgid ""
"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded "
"string instead of a Unicode object."
msgstr ""
":c:func:`PyModule_NewObject` に似ていますが、 name は Unicode オブジェクトで"
"はなく UTF-8 でエンコードされた文字列です。"

#: ../../c-api/module.rst:65
msgid ""
"Return the dictionary object that implements *module*'s namespace; this "
"object is the same as the :attr:`~object.__dict__` attribute of the module "
"object. If *module* is not a module object (or a subtype of a module "
"object), :exc:`SystemError` is raised and ``NULL`` is returned."
msgstr ""
"*module* の名前空間を実装する辞書オブジェクトを返します;\n"
"このオブジェクトは、モジュールオブジェクトの :attr:`~object.__dict__` 属性と"
"同じものです。\n"
"*module* がモジュールオブジェクト (もしくはモジュールオブジェクトのサブタイ"
"プ) でない場合は、 :exc:`SystemError` が送出され ``NULL`` が返されます。"

#: ../../c-api/module.rst:70
msgid ""
"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` "
"functions rather than directly manipulate a module's :attr:`~object."
"__dict__`."
msgstr ""
"拡張モジュールでは、モジュールの :attr:`~object.__dict__` を直接操作するより"
"も、 ``PyModule_*`` および ``PyObject_*`` 関数を使う方が推奨されます。"

#: ../../c-api/module.rst:81
msgid ""
"Return *module*'s :attr:`~module.__name__` value.  If the module does not "
"provide one, or if it is not a string, :exc:`SystemError` is raised and "
"``NULL`` is returned."
msgstr ""

#: ../../c-api/module.rst:90
msgid ""
"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to "
"``'utf-8'``."
msgstr ""
":c:func:`PyModule_GetNameObject` に似ていますが、 ``'utf-8'`` でエンコードさ"
"れた name を返します。"

#: ../../c-api/module.rst:95
msgid ""
"Return the \"state\" of the module, that is, a pointer to the block of "
"memory allocated at module creation time, or ``NULL``.  See :c:member:"
"`PyModuleDef.m_size`."
msgstr ""
"モジュールの \"state\"(モジュールを生成したタイミングで確保されるメモリブロッ"
"クへのポインター) か、なければ ``NULL`` を返します。 :c:member:`PyModuleDef."
"m_size` を参照してください。"

#: ../../c-api/module.rst:102
msgid ""
"Return a pointer to the :c:type:`PyModuleDef` struct from which the module "
"was created, or ``NULL`` if the module wasn't created from a definition."
msgstr ""
"モジュールが作られる元となった :c:type:`PyModuleDef` 構造体へのポインタを返し"
"ます。\n"
"モジュールが定義によって作られていなかった場合は ``NULL`` を返します。"

#: ../../c-api/module.rst:112
msgid ""
"Return the name of the file from which *module* was loaded using *module*'s :"
"attr:`~module.__file__` attribute.  If this is not defined, or if it is not "
"a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a "
"reference to a Unicode object."
msgstr ""

#: ../../c-api/module.rst:122
msgid ""
"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename "
"encoded to 'utf-8'."
msgstr ""
":c:func:`PyModule_GetFilenameObject` と似ていますが、 'utf-8' でエンコードさ"
"れたファイル名を返します。"

#: ../../c-api/module.rst:125
msgid ""
":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on "
"unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead."
msgstr ""
":c:func:`PyModule_GetFilename` はエンコードできないファイル名に対しては :exc:"
"`UnicodeEncodeError` を送出します。これの代わりに :c:func:"
"`PyModule_GetFilenameObject` を使用してください。"

#: ../../c-api/module.rst:133
msgid "Initializing C modules"
msgstr "Cモジュールの初期化"

#: ../../c-api/module.rst:135
msgid ""
"Modules objects are usually created from extension modules (shared libraries "
"which export an initialization function), or compiled-in modules (where the "
"initialization function is added using :c:func:`PyImport_AppendInittab`). "
"See :ref:`building` or :ref:`extending-with-embedding` for details."
msgstr ""
"通常、モジュールオブジェクトは拡張モジュール (初期化関数をエクスポートしてい"
"る共有ライブラリ) または組み込まれたモジュール (:c:func:"
"`PyImport_AppendInittab` を使って初期化関数が追加されているモジュール) から作"
"られます。\n"
"詳細については :ref:`building` または :ref:`extending-with-embedding` を見て"
"ください。"

#: ../../c-api/module.rst:140
msgid ""
"The initialization function can either pass a module definition instance to :"
"c:func:`PyModule_Create`, and return the resulting module object, or request "
"\"multi-phase initialization\" by returning the definition struct itself."
msgstr ""
"初期化関数は、モジュール定義のインスタンスを :c:func:`PyModule_Create` に渡し"
"て出来上がったモジュールオブジェクトを返してもよいですし、もしくは定義構造体"
"そのものを返し\"多段階初期化\"を要求しても構いません。"

#: ../../c-api/module.rst:146
msgid ""
"The module definition struct, which holds all information needed to create a "
"module object. There is usually only one statically initialized variable of "
"this type for each module."
msgstr ""
"モジュール定義構造体はモジュールオブジェクトを生成するのに必要なすべての情報"
"を保持します。\n"
"通常は、それぞれのモジュールごとに静的に初期化されたこの型の変数が1つだけ存在"
"します。"

#: ../../c-api/module.rst:152
msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`."
msgstr ""
"このメンバーは常に :c:macro:`PyModuleDef_HEAD_INIT` で初期化してください。"

#: ../../c-api/module.rst:156
msgid "Name for the new module."
msgstr "新しいモジュールの名前。"

#: ../../c-api/module.rst:160
msgid ""
"Docstring for the module; usually a docstring variable created with :c:macro:"
"`PyDoc_STRVAR` is used."
msgstr ""
"モジュールの docstring。たいてい docstring は :c:macro:`PyDoc_STRVAR` を利用"
"して生成されます。"

#: ../../c-api/module.rst:165
msgid ""
"Module state may be kept in a per-module memory area that can be retrieved "
"with :c:func:`PyModule_GetState`, rather than in static globals. This makes "
"modules safe for use in multiple sub-interpreters."
msgstr ""
"モジュールの状態は、静的なグローバルな領域ではなく :c:func:"
"`PyModule_GetState` で取得できるモジュールごとのメモリ領域に保持されているこ"
"とがあります。\n"
"これによってモジュールは複数のサブ・インタプリターで安全に使えます。"

#: ../../c-api/module.rst:169
msgid ""
"This memory area is allocated based on *m_size* on module creation, and "
"freed when the module object is deallocated, after the :c:member:"
"`~PyModuleDef.m_free` function has been called, if present."
msgstr ""
"このメモリ領域は *m_size* に基づいてモジュール作成時に確保され、モジュールオ"
"ブジェクトが破棄されるときに、 :c:member:`~PyModuleDef.m_free` 関数があればそ"
"れが呼ばれた後で解放されます。"

#: ../../c-api/module.rst:173
msgid ""
"Setting ``m_size`` to ``-1`` means that the module does not support sub-"
"interpreters, because it has global state."
msgstr ""
"``m_size`` に ``-1`` を設定すると、そのモジュールはグローバルな状態を持つため"
"にサブ・インタープリターをサポートしていないということになります。"

#: ../../c-api/module.rst:176
msgid ""
"Setting it to a non-negative value means that the module can be re-"
"initialized and specifies the additional amount of memory it requires for "
"its state. Non-negative ``m_size`` is required for multi-phase "
"initialization."
msgstr ""
"``m_size`` を非負の値に設定すると、モジュールは再初期化でき、その状態のために"
"必要となる追加のメモリ量を指定できるということになります。\n"
"非負の ``m_size`` は多段階初期化で必要になります。"

#: ../../c-api/module.rst:181
msgid "See :PEP:`3121` for more details."
msgstr "詳細は :PEP:`3121` を参照。"

#: ../../c-api/module.rst:185
msgid ""
"A pointer to a table of module-level functions, described by :c:type:"
"`PyMethodDef` values.  Can be ``NULL`` if no functions are present."
msgstr ""
":c:type:`PyMethodDef` で定義される、モジュールレベル関数のテーブルへのポイン"
"ター。関数が存在しない場合は ``NULL`` を設定することが可能。"

#: ../../c-api/module.rst:190
msgid ""
"An array of slot definitions for multi-phase initialization, terminated by a "
"``{0, NULL}`` entry. When using single-phase initialization, *m_slots* must "
"be ``NULL``."
msgstr ""
"多段階初期化のためのスロット定義の配列で、 ``{0, NULL}`` 要素が終端となりま"
"す。\n"
"一段階初期化を使うときは、 *m_slots* は ``NULL`` でなければなりません。"

#: ../../c-api/module.rst:196
msgid ""
"Prior to version 3.5, this member was always set to ``NULL``, and was "
"defined as:"
msgstr ""
"バージョン 3.5 より前は、このメンバは常に ``NULL`` に設定されていて、次のもの"
"として定義されていました:"

#: ../../c-api/module.rst:203
msgid ""
"A traversal function to call during GC traversal of the module object, or "
"``NULL`` if not needed."
msgstr ""
"GC走査がモジュールオブジェクトを走査する際に呼び出される走査関数。必要ない場"
"合は ``NULL``."

#: ../../c-api/module.rst:206 ../../c-api/module.rst:221
#: ../../c-api/module.rst:242
msgid ""
"This function is not called if the module state was requested but is not "
"allocated yet. This is the case immediately after the module is created and "
"before the module is executed (:c:data:`Py_mod_exec` function). More "
"precisely, this function is not called if :c:member:`~PyModuleDef.m_size` is "
"greater than 0 and the module state (as returned by :c:func:"
"`PyModule_GetState`) is ``NULL``."
msgstr ""

#: ../../c-api/module.rst:213 ../../c-api/module.rst:234
#: ../../c-api/module.rst:249
msgid "No longer called before the module state is allocated."
msgstr ""

#: ../../c-api/module.rst:218
msgid ""
"A clear function to call during GC clearing of the module object, or "
"``NULL`` if not needed."
msgstr ""
"GCがこのモジュールオブジェクトをクリアーする時に呼び出されるクリアー関数。必"
"要ない場合は、``NULL``."

#: ../../c-api/module.rst:228
msgid ""
"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called "
"before a module is deallocated. For example, when reference counting is "
"enough to determine that an object is no longer used, the cyclic garbage "
"collector is not involved and :c:member:`~PyModuleDef.m_free` is called "
"directly."
msgstr ""

#: ../../c-api/module.rst:239
msgid ""
"A function to call during deallocation of the module object, or ``NULL`` if "
"not needed."
msgstr ""
"GCがこのモジュールオブジェクトを解放するときに呼び出される関数。必要ない場合"
"は ``NULL``."

#: ../../c-api/module.rst:253
msgid "Single-phase initialization"
msgstr "一段階初期化"

#: ../../c-api/module.rst:255
msgid ""
"The module initialization function may create and return the module object "
"directly. This is referred to as \"single-phase initialization\", and uses "
"one of the following two module creation functions:"
msgstr ""
"モジュールの初期化関数が直接モジュールオブジェクトを生成して返す場合がありま"
"す。\n"
"これは\"一段階初期化\"と呼ばれ、次の2つのモジュール生成関数のどちらか1つを使"
"います:"

#: ../../c-api/module.rst:261
msgid ""
"Create a new module object, given the definition in *def*.  This behaves "
"like :c:func:`PyModule_Create2` with *module_api_version* set to :c:macro:"
"`PYTHON_API_VERSION`."
msgstr ""

#: ../../c-api/module.rst:268
msgid ""
"Create a new module object, given the definition in *def*, assuming the API "
"version *module_api_version*.  If that version does not match the version of "
"the running interpreter, a :exc:`RuntimeWarning` is emitted."
msgstr ""
"APIバージョンを *module_api_version* として *def* での定義に従って新しいモ"
"ジュールオブジェクトを生成します。\n"
"もし指定されたバージョンが実行しているインタープリターのバージョンと異なる場"
"合は、 :exc:`RuntimeWarning` を発生させます。"

#: ../../c-api/module.rst:276
msgid ""
"Most uses of this function should be using :c:func:`PyModule_Create` "
"instead; only use this if you are sure you need it."
msgstr ""
"ほとんどの場合、この関数ではなく :c:func:`PyModule_Create` を利用するべきで"
"す。この関数は、この関数の必要性を理解しているときにだけ利用してください。"

#: ../../c-api/module.rst:279
msgid ""
"Before it is returned from in the initialization function, the resulting "
"module object is typically populated using functions like :c:func:"
"`PyModule_AddObjectRef`."
msgstr ""
"モジュールオブジェクトが初期化関数から返される前に、たいていは :c:func:"
"`PyModule_AddObjectRef` などの関数を使ってモジュールオブジェクトにメンバを所"
"属させます。"

#: ../../c-api/module.rst:285
msgid "Multi-phase initialization"
msgstr "多段階初期化"

#: ../../c-api/module.rst:287
msgid ""
"An alternate way to specify extensions is to request \"multi-phase "
"initialization\". Extension modules created this way behave more like Python "
"modules: the initialization is split between the *creation phase*, when the "
"module object is created, and the *execution phase*, when it is populated. "
"The distinction is similar to the :py:meth:`!__new__` and :py:meth:`!"
"__init__` methods of classes."
msgstr ""

#: ../../c-api/module.rst:294
msgid ""
"Unlike modules created using single-phase initialization, these modules are "
"not singletons: if the *sys.modules* entry is removed and the module is re-"
"imported, a new module object is created, and the old module is subject to "
"normal garbage collection -- as with Python modules. By default, multiple "
"modules created from the same definition should be independent: changes to "
"one should not affect the others. This means that all state should be "
"specific to the module object (using e.g. using :c:func:"
"`PyModule_GetState`), or its contents (such as the module's :attr:`~object."
"__dict__` or individual classes created with :c:func:`PyType_FromSpec`)."
msgstr ""

#: ../../c-api/module.rst:304
msgid ""
"All modules created using multi-phase initialization are expected to "
"support :ref:`sub-interpreters <sub-interpreter-support>`. Making sure "
"multiple modules are independent is typically enough to achieve this."
msgstr ""
"多段階初期化を使って生成される全てのモジュールは :ref:`サブ・インタプリター "
"<sub-interpreter-support>` をサポートすることが求められます。\n"
"複数のモジュールが独立していることを保証するのには、たいていはこのサポートを"
"するだけで十分です。"

#: ../../c-api/module.rst:308
msgid ""
"To request multi-phase initialization, the initialization function "
"(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :"
"c:member:`~PyModuleDef.m_slots`. Before it is returned, the ``PyModuleDef`` "
"instance must be initialized with the following function:"
msgstr ""
"多段階初期化を要求するために、初期化関数 (PyInit_modulename) は空でない :c:"
"member:`~PyModuleDef.m_slots` を持つ :c:type:`PyModuleDef` を返します。\n"
"これを返す前に、 ``PyModuleDef`` インスタンスは次の関数で初期化されなくてはい"
"けません:"

#: ../../c-api/module.rst:315
msgid ""
"Ensures a module definition is a properly initialized Python object that "
"correctly reports its type and reference count."
msgstr ""
"モジュール定義が型と参照カウントを正しく報告する、適切に初期化された Python "
"オブジェクトであること保証します。"

#: ../../c-api/module.rst:318
msgid "Returns *def* cast to ``PyObject*``, or ``NULL`` if an error occurred."
msgstr ""
"``PyObject*`` にキャストされた *def* を返します。エラーが発生した場合 "
"``NULL`` を返します。"

#: ../../c-api/module.rst:322
msgid ""
"The *m_slots* member of the module definition must point to an array of "
"``PyModuleDef_Slot`` structures:"
msgstr ""
"モジュール定義の *m_slots* メンバは ``PyModuleDef_Slot`` 構造体の配列を指さな"
"ければなりません:"

#: ../../c-api/module.rst:329
msgid "A slot ID, chosen from the available values explained below."
msgstr "スロット ID で、以下で説明されている利用可能な値から選ばれます。"

#: ../../c-api/module.rst:333
msgid "Value of the slot, whose meaning depends on the slot ID."
msgstr "スロットの値で、意味はスロット ID に依存します。"

#: ../../c-api/module.rst:337
msgid "The *m_slots* array must be terminated by a slot with id 0."
msgstr "*m_slots* 配列はID 0 のスロットで終端されていなければなりません。"

#: ../../c-api/module.rst:339
msgid "The available slot types are:"
msgstr "利用可能なスロットの型は以下です:"

#: ../../c-api/module.rst:343
msgid ""
"Specifies a function that is called to create the module object itself. The "
"*value* pointer of this slot must point to a function of the signature:"
msgstr ""
"モジュールオブジェクト自身を生成するために呼ばれる関数を指定します。\n"
"このスロットの *value* ポインタは次のシグネチャを持つ関数を指していなくてはい"
"けません:"

#: ../../c-api/module.rst:350
msgid ""
"The function receives a :py:class:`~importlib.machinery.ModuleSpec` "
"instance, as defined in :PEP:`451`, and the module definition. It should "
"return a new module object, or set an error and return ``NULL``."
msgstr ""
":PEP:`451` で定義された :py:class:`~importlib.machinery.ModuleSpec` インスタ"
"ンスと、モジュール定義を受け取る関数です。\n"
"これは新しいモジュールオブジェクトを返すか、エラーを設定して ``NULL`` を返す"
"べきです。"

#: ../../c-api/module.rst:355
msgid ""
"This function should be kept minimal. In particular, it should not call "
"arbitrary Python code, as trying to import the same module again may result "
"in an infinite loop."
msgstr ""
"この関数は最小限に留めておくべきです。\n"
"特に任意のPythonコードを呼び出すべきではなく、同じモジュールをインポートしよ"
"うとすると無限ループに陥るでしょう。"

#: ../../c-api/module.rst:359
msgid ""
"Multiple ``Py_mod_create`` slots may not be specified in one module "
"definition."
msgstr ""
"複数の ``Py_mod_create`` スロットを1つのモジュール定義に設定しない方がよいで"
"す。"

#: ../../c-api/module.rst:362
msgid ""
"If ``Py_mod_create`` is not specified, the import machinery will create a "
"normal module object using :c:func:`PyModule_New`. The name is taken from "
"*spec*, not the definition, to allow extension modules to dynamically adjust "
"to their place in the module hierarchy and be imported under different names "
"through symlinks, all while sharing a single module definition."
msgstr ""
"``Py_mod_create`` が設定されていない場合は、インポート機構は :c:func:"
"`PyModule_New` を使って通常のモジュールオブジェクトを生成します。\n"
"モジュールの名前は定義ではなく *spec* から取得され、これによって拡張モジュー"
"ルが動的にモジュール階層における位置を調整できたり、シンボリックリンクを通し"
"て同一のモジュール定義を共有しつつ別の名前でインポートできたりします。"

#: ../../c-api/module.rst:368
msgid ""
"There is no requirement for the returned object to be an instance of :c:type:"
"`PyModule_Type`. Any type can be used, as long as it supports setting and "
"getting import-related attributes. However, only ``PyModule_Type`` instances "
"may be returned if the ``PyModuleDef`` has non-``NULL`` ``m_traverse``, "
"``m_clear``, ``m_free``; non-zero ``m_size``; or slots other than "
"``Py_mod_create``."
msgstr ""
"返されるオブジェクトが :c:type:`PyModule_Type` のインスタンスである必要はあり"
"ません。\n"
"インポートに関連する属性の設定と取得ができる限りは、どんな型でも使えます。\n"
"しかし、 ``PyModuleDef`` が ``NULL`` でない ``m_traverse``, ``m_clear``, "
"``m_free`` 、もしくはゼロでない ``m_size`` 、もしくは ``Py_mod_create`` 以外"
"のスロットを持つ場合は、 ``PyModule_Type`` インスタンスのみが返されるでしょ"
"う。"

#: ../../c-api/module.rst:377
msgid ""
"Specifies a function that is called to *execute* the module. This is "
"equivalent to executing the code of a Python module: typically, this "
"function adds classes and constants to the module. The signature of the "
"function is:"
msgstr ""
"モジュールを *実行する* ときに呼ばれる関数を指定します。\n"
"これはPythonモジュールのコードを実行するのと同等です:\n"
"この関数はたいていはクラスと定数をモジュールにします。\n"
"この関数のシグネチャは以下です:"

#: ../../c-api/module.rst:386
msgid ""
"If multiple ``Py_mod_exec`` slots are specified, they are processed in the "
"order they appear in the *m_slots* array."
msgstr ""
"複数の ``Py_mod_exec`` スロットが設定されていた場合は、 *m_slots* 配列に現れ"
"た順に処理されていきます。"

#: ../../c-api/module.rst:391 ../../c-api/module.rst:424
msgid "Specifies one of the following values:"
msgstr ""

#: ../../c-api/module.rst:397
msgid "The module does not support being imported in subinterpreters."
msgstr ""

#: ../../c-api/module.rst:401
msgid ""
"The module supports being imported in subinterpreters, but only when they "
"share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)"
msgstr ""

#: ../../c-api/module.rst:407
msgid ""
"The module supports being imported in subinterpreters, even when they have "
"their own GIL. (See :ref:`isolating-extensions-howto`.)"
msgstr ""

#: ../../c-api/module.rst:411
msgid ""
"This slot determines whether or not importing this module in a "
"subinterpreter will fail."
msgstr ""

#: ../../c-api/module.rst:414
msgid ""
"Multiple ``Py_mod_multiple_interpreters`` slots may not be specified in one "
"module definition."
msgstr ""

#: ../../c-api/module.rst:417
msgid ""
"If ``Py_mod_multiple_interpreters`` is not specified, the import machinery "
"defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``."
msgstr ""

#: ../../c-api/module.rst:430
msgid ""
"The module depends on the presence of the global interpreter lock (GIL), and "
"may access global state without synchronization."
msgstr ""

#: ../../c-api/module.rst:435
msgid "The module is safe to run without an active GIL."
msgstr ""

#: ../../c-api/module.rst:437
msgid ""
"This slot is ignored by Python builds not configured with :option:`--disable-"
"gil`.  Otherwise, it determines whether or not importing this module will "
"cause the GIL to be automatically enabled. See :ref:`whatsnew313-free-"
"threaded-cpython` for more detail."
msgstr ""

#: ../../c-api/module.rst:442
msgid ""
"Multiple ``Py_mod_gil`` slots may not be specified in one module definition."
msgstr ""

#: ../../c-api/module.rst:444
msgid ""
"If ``Py_mod_gil`` is not specified, the import machinery defaults to "
"``Py_MOD_GIL_USED``."
msgstr ""

#: ../../c-api/module.rst:449
msgid "See :PEP:`489` for more details on multi-phase initialization."
msgstr "多段階初期化についてより詳しくは :PEP:`489` を見てください。"

#: ../../c-api/module.rst:452
msgid "Low-level module creation functions"
msgstr "低水準モジュール作成関数"

#: ../../c-api/module.rst:454
msgid ""
"The following functions are called under the hood when using multi-phase "
"initialization. They can be used directly, for example when creating module "
"objects dynamically. Note that both ``PyModule_FromDefAndSpec`` and "
"``PyModule_ExecDef`` must be called to fully initialize a module."
msgstr ""
"以下の関数は、多段階初期化を使うときに裏側で呼び出されます。\n"
"例えばモジュールオブジェクトを動的に生成するときに、これらの関数を直接使えま"
"す。\n"
"``PyModule_FromDefAndSpec`` および ``PyModule_ExecDef`` のどちらも、呼び出し"
"た後にはモジュールが完全に初期化されていなければなりません。"

#: ../../c-api/module.rst:461
msgid ""
"Create a new module object, given the definition in *def* and the ModuleSpec "
"*spec*.  This behaves like :c:func:`PyModule_FromDefAndSpec2` with "
"*module_api_version* set to :c:macro:`PYTHON_API_VERSION`."
msgstr ""

#: ../../c-api/module.rst:469
msgid ""
"Create a new module object, given the definition in *def* and the ModuleSpec "
"*spec*, assuming the API version *module_api_version*. If that version does "
"not match the version of the running interpreter, a :exc:`RuntimeWarning` is "
"emitted."
msgstr ""
"APIバージョンを *module_api_version* として、 *def* と ModuleSpec オブジェク"
"トの *spec* で定義されたとおりに新しいモジュールオブジェクトを生成します。\n"
"もし指定されたバージョンが実行しているインタープリターのバージョンと異なる場"
"合は、 :exc:`RuntimeWarning` を発生させます。"

#: ../../c-api/module.rst:478
msgid ""
"Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` "
"instead; only use this if you are sure you need it."
msgstr ""
"ほとんどの場合、この関数ではなく :c:func:`PyModule_FromDefAndSpec` を利用する"
"べきです。\n"
"この関数は、この関数の必要性を理解しているときにだけ利用してください。"

#: ../../c-api/module.rst:485
msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*."
msgstr ""
"*def* で与えられた任意の実行スロット (:c:data:`Py_mod_exec`) を実行します。"

#: ../../c-api/module.rst:491
msgid ""
"Set the docstring for *module* to *docstring*. This function is called "
"automatically when creating a module from ``PyModuleDef``, using either "
"``PyModule_Create`` or ``PyModule_FromDefAndSpec``."
msgstr ""
"*module* の docstring を *docstring* に設定します。\n"
"この関数は、 ``PyModuleDef`` から ``PyModule_Create`` もしくは "
"``PyModule_FromDefAndSpec`` を使ってモジュールを生成するときに自動的に呼び出"
"されます。"

#: ../../c-api/module.rst:500
msgid ""
"Add the functions from the ``NULL`` terminated *functions* array to "
"*module*. Refer to the :c:type:`PyMethodDef` documentation for details on "
"individual entries (due to the lack of a shared module namespace, module "
"level \"functions\" implemented in C typically receive the module as their "
"first parameter, making them similar to instance methods on Python classes). "
"This function is called automatically when creating a module from "
"``PyModuleDef``, using either ``PyModule_Create`` or "
"``PyModule_FromDefAndSpec``."
msgstr ""
"終端が ``NULL`` になっている *functions* 配列にある関数を *module* に追加しま"
"す。\n"
":c:type:`PyMethodDef` 構造体の個々のエントリについては PyMethodDef の説明を参"
"照してください (モジュールの名前空間が共有されていないので、 C で実装されたモ"
"ジュールレベル \"関数\" はたいていモジュールを1つ目の引数として受け取り、 "
"Python クラスのインスタンスメソッドに似た形にします)。\n"
"この関数は、 ``PyModuleDef`` から ``PyModule_Create`` もしくは "
"``PyModule_FromDefAndSpec`` を使ってモジュールを生成するときに自動的に呼び出"
"されます。"

#: ../../c-api/module.rst:512
msgid "Support functions"
msgstr "サポート関数"

#: ../../c-api/module.rst:514
msgid ""
"The module initialization function (if using single phase initialization) or "
"a function called from a module execution slot (if using multi-phase "
"initialization), can use the following functions to help initialize the "
"module state:"
msgstr ""
"モジュールの初期化関数 (一段階初期化を使う場合) 、あるいはモジュールの実行ス"
"ロットから呼び出される関数 (多段階初期化を使う場合) は次の関数を使うと、モ"
"ジュールの state の初期化を簡単にできます:"

#: ../../c-api/module.rst:521
msgid ""
"Add an object to *module* as *name*.  This is a convenience function which "
"can be used from the module's initialization function."
msgstr ""
"*module* にオブジェクトを *name* として追加します。\n"
"この関数はモジュールの初期化関数から利用される便利関数です。"

#: ../../c-api/module.rst:524
msgid ""
"On success, return ``0``. On error, raise an exception and return ``-1``."
msgstr ""
"成功すると ``0`` を返し、エラーになると例外を送出して ``-1`` を返します。"

#: ../../c-api/module.rst:526 ../../c-api/module.rst:577
#: ../../c-api/module.rst:604
msgid "Example usage::"
msgstr "使用例::"

#: ../../c-api/module.rst:528
msgid ""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
"    PyObject *obj = PyLong_FromLong(value);\n"
"    if (obj == NULL) {\n"
"        return -1;\n"
"    }\n"
"    int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
"    Py_DECREF(obj);\n"
"    return res;\n"
" }"
msgstr ""

#: ../../c-api/module.rst:540
msgid ""
"To be convenient, the function accepts ``NULL`` *value* with an exception "
"set. In this case, return ``-1`` and just leave the raised exception "
"unchanged."
msgstr ""

#: ../../c-api/module.rst:544
msgid ""
"The example can also be written without checking explicitly if *obj* is "
"``NULL``::"
msgstr ""
"この例は、明示的に *obj* が ``NULL`` であることを確認せずに書くこともできま"
"す::"

#: ../../c-api/module.rst:547
msgid ""
"static int\n"
"add_spam(PyObject *module, int value)\n"
"{\n"
"    PyObject *obj = PyLong_FromLong(value);\n"
"    int res = PyModule_AddObjectRef(module, \"spam\", obj);\n"
"    Py_XDECREF(obj);\n"
"    return res;\n"
" }"
msgstr ""

#: ../../c-api/module.rst:556
msgid ""
"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this "
"case, since *obj* can be ``NULL``."
msgstr ""
"この場合は、 *obj* が ``NULL`` でありうるため、 ``Py_DECREF()`` の代わりに "
"``Py_XDECREF()`` を呼び出す必要があることに注意してください。"

#: ../../c-api/module.rst:559
msgid ""
"The number of different *name* strings passed to this function should be "
"kept small, usually by only using statically allocated strings as *name*. "
"For names that aren't known at compile time, prefer calling :c:func:"
"`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more "
"details, see :c:func:`PyUnicode_InternFromString`, which may be used "
"internally to create a key object."
msgstr ""

#: ../../c-api/module.rst:572
msgid ""
"Similar to :c:func:`PyModule_AddObjectRef`, but \"steals\" a reference to "
"*value*. It can be called with a result of function that returns a new "
"reference without bothering to check its result or even saving it to a "
"variable."
msgstr ""

#: ../../c-api/module.rst:579
msgid ""
"if (PyModule_Add(module, \"spam\", PyBytes_FromString(value)) < 0) {\n"
"    goto error;\n"
"}"
msgstr ""

#: ../../c-api/module.rst:588
msgid ""
"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to "
"*value* on success (if it returns ``0``)."
msgstr ""

#: ../../c-api/module.rst:591
msgid ""
"The new :c:func:`PyModule_Add` or :c:func:`PyModule_AddObjectRef` functions "
"are recommended, since it is easy to introduce reference leaks by misusing "
"the :c:func:`PyModule_AddObject` function."
msgstr ""

#: ../../c-api/module.rst:598
msgid ""
"Unlike other functions that steal references, ``PyModule_AddObject()`` only "
"releases the reference to *value* **on success**."
msgstr ""

#: ../../c-api/module.rst:601
msgid ""
"This means that its return value must be checked, and calling code must :c:"
"func:`Py_XDECREF` *value* manually on error."
msgstr ""

#: ../../c-api/module.rst:606
msgid ""
"PyObject *obj = PyBytes_FromString(value);\n"
"if (PyModule_AddObject(module, \"spam\", obj) < 0) {\n"
"    // If 'obj' is not NULL and PyModule_AddObject() failed,\n"
"    // 'obj' strong reference must be deleted with Py_XDECREF().\n"
"    // If 'obj' is NULL, Py_XDECREF() does nothing.\n"
"    Py_XDECREF(obj);\n"
"    goto error;\n"
"}\n"
"// PyModule_AddObject() stole a reference to obj:\n"
"// Py_XDECREF(obj) is not needed here."
msgstr ""

#: ../../c-api/module.rst:619
msgid ":c:func:`PyModule_AddObject` is :term:`soft deprecated`."
msgstr ""

#: ../../c-api/module.rst:624
msgid ""
"Add an integer constant to *module* as *name*.  This convenience function "
"can be used from the module's initialization function. Return ``-1`` with an "
"exception set on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:628
msgid ""
"This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:"
"func:`PyModule_AddObjectRef`; see their documentation for details."
msgstr ""

#: ../../c-api/module.rst:634
msgid ""
"Add a string constant to *module* as *name*.  This convenience function can "
"be used from the module's initialization function.  The string *value* must "
"be ``NULL``-terminated. Return ``-1`` with an exception set on error, ``0`` "
"on success."
msgstr ""

#: ../../c-api/module.rst:639
msgid ""
"This is a convenience function that calls :c:func:"
"`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their "
"documentation for details."
msgstr ""

#: ../../c-api/module.rst:646
msgid ""
"Add an int constant to *module*. The name and the value are taken from "
"*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int "
"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` "
"with an exception set on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:654
msgid "Add a string constant to *module*."
msgstr "文字列定数を *module* に追加します。"

#: ../../c-api/module.rst:658
msgid ""
"Add a type object to *module*. The type object is finalized by calling "
"internally :c:func:`PyType_Ready`. The name of the type object is taken from "
"the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return "
"``-1`` with an exception set on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:668
msgid ""
"Indicate that *module* does or does not support running without the global "
"interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. "
"It must be called during *module*'s initialization function. If this "
"function is not called during module initialization, the import machinery "
"assumes the module does not support running without the GIL. This function "
"is only available in Python builds configured with :option:`--disable-gil`. "
"Return ``-1`` with an exception set on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:681
msgid "Module lookup"
msgstr "モジュール検索"

#: ../../c-api/module.rst:683
msgid ""
"Single-phase initialization creates singleton modules that can be looked up "
"in the context of the current interpreter. This allows the module object to "
"be retrieved later with only a reference to the module definition."
msgstr ""
"一段階初期化は、現在のインタプリタのコンテキストから探せるシングルトンのモ"
"ジュールを生成します。\n"
"これによって、後からモジュール定義への参照だけでモジュールオブジェクトが取得"
"できます。"

#: ../../c-api/module.rst:687
msgid ""
"These functions will not work on modules created using multi-phase "
"initialization, since multiple such modules can be created from a single "
"definition."
msgstr ""
"多段階初期化を使うと単一の定義から複数のモジュールが作成できるので、これらの"
"関数は多段階初期化を使って作成されたモジュールには使えません。"

#: ../../c-api/module.rst:692
msgid ""
"Returns the module object that was created from *def* for the current "
"interpreter. This method requires that the module object has been attached "
"to the interpreter state with :c:func:`PyState_AddModule` beforehand. In "
"case the corresponding module object is not found or has not been attached "
"to the interpreter state yet, it returns ``NULL``."
msgstr ""
"現在のインタプリタの *def* から作られたモジュールオブジェクトを返します。この"
"メソッドの前提条件として、前もって :c:func:`PyState_AddModule` でインタプリタ"
"の state にモジュールオブジェクトを連結しておくことを要求します。対応するモ"
"ジュールオブジェクトが見付からない、もしくは事前にインタプリタの state に連結"
"されていない場合は、 ``NULL`` を返します。"

#: ../../c-api/module.rst:699
msgid ""
"Attaches the module object passed to the function to the interpreter state. "
"This allows the module object to be accessible via :c:func:"
"`PyState_FindModule`."
msgstr ""
"関数に渡されたモジュールオブジェクトを、インタプリタの state に連結します。こ"
"の関数を使うことで :c:func:`PyState_FindModule` からモジュールオブジェクトに"
"アクセスできるようになります。"

#: ../../c-api/module.rst:702
msgid "Only effective on modules created using single-phase initialization."
msgstr "一段階初期化を使って作成されたモジュールにのみ有効です。"

#: ../../c-api/module.rst:704
msgid ""
"Python calls ``PyState_AddModule`` automatically after importing a module, "
"so it is unnecessary (but harmless) to call it from module initialization "
"code. An explicit call is needed only if the module's own init code "
"subsequently calls ``PyState_FindModule``. The function is mainly intended "
"for implementing alternative import mechanisms (either by calling it "
"directly, or by referring to its implementation for details of the required "
"state updates)."
msgstr ""

#: ../../c-api/module.rst:712 ../../c-api/module.rst:723
msgid "The caller must hold the GIL."
msgstr "呼び出し側はGILを獲得しなければなりません。"

#: ../../c-api/module.rst:714
msgid "Return ``-1`` with an exception set on error, ``0`` on success."
msgstr ""

#: ../../c-api/module.rst:720
msgid ""
"Removes the module object created from *def* from the interpreter state. "
"Return ``-1`` with an exception set on error, ``0`` on success."
msgstr ""

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

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

#: ../../c-api/module.rst:13
msgid "ModuleType (in module types)"
msgstr "ModuleType (in module types)"

#: ../../c-api/module.rst:33 ../../c-api/module.rst:77
msgid "__name__ (module attribute)"
msgstr "__name__ (モジュール属性)"

#: ../../c-api/module.rst:33
msgid "__doc__ (module attribute)"
msgstr "__doc__ (モジュール属性)"

#: ../../c-api/module.rst:33 ../../c-api/module.rst:108
msgid "__file__ (module attribute)"
msgstr "__file__ (モジュール属性)"

#: ../../c-api/module.rst:33
msgid "__package__ (module attribute)"
msgstr ""

#: ../../c-api/module.rst:33
msgid "__loader__ (module attribute)"
msgstr ""

#: ../../c-api/module.rst:63
msgid "__dict__ (module attribute)"
msgstr "__dict__ (モジュール属性)"

#: ../../c-api/module.rst:77 ../../c-api/module.rst:108
msgid "SystemError (built-in exception)"
msgstr "SystemError (組み込み例外)"