stable.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:
# tomo, 2021
# Skydelta, 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:50+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/stable.rst:7
msgid "C API Stability"
msgstr "C API の安定性"

#: ../../c-api/stable.rst:9
msgid ""
"Unless documented otherwise, Python's C API is covered by the Backwards "
"Compatibility Policy, :pep:`387`. Most changes to it are source-compatible "
"(typically by only adding new API). Changing existing API or removing API is "
"only done after a deprecation period or to fix serious issues."
msgstr ""

#: ../../c-api/stable.rst:15
msgid ""
"CPython's Application Binary Interface (ABI) is forward- and backwards-"
"compatible across a minor release (if these are compiled the same way; see :"
"ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will "
"work on 3.10.8 and vice versa, but will need to be compiled separately for "
"3.9.x and 3.11.x."
msgstr ""

#: ../../c-api/stable.rst:21
msgid "There are two tiers of C API with different stability expectations:"
msgstr ""

#: ../../c-api/stable.rst:23
msgid ""
":ref:`Unstable API <unstable-c-api>`, may change in minor versions without a "
"deprecation period. It is marked by the ``PyUnstable`` prefix in names."
msgstr ""

#: ../../c-api/stable.rst:25
msgid ""
":ref:`Limited API <limited-c-api>`, is compatible across several minor "
"releases. When :c:macro:`Py_LIMITED_API` is defined, only this subset is "
"exposed from ``Python.h``."
msgstr ""

#: ../../c-api/stable.rst:29
msgid "These are discussed in more detail below."
msgstr ""

#: ../../c-api/stable.rst:31
msgid ""
"Names prefixed by an underscore, such as ``_Py_InternalState``, are private "
"API that can change without notice even in patch releases. If you need to "
"use this API, consider reaching out to `CPython developers <https://discuss."
"python.org/c/core-dev/c-api/30>`_ to discuss adding public API for your use "
"case."
msgstr ""

#: ../../c-api/stable.rst:40
msgid "Unstable C API"
msgstr ""

#: ../../c-api/stable.rst:44
msgid ""
"Any API named with the ``PyUnstable`` prefix exposes CPython implementation "
"details, and may change in every minor release (e.g. from 3.9 to 3.10) "
"without any deprecation warnings. However, it will not change in a bugfix "
"release (e.g. from 3.10.0 to 3.10.1)."
msgstr ""

#: ../../c-api/stable.rst:49
msgid ""
"It is generally intended for specialized, low-level tools like debuggers."
msgstr ""

#: ../../c-api/stable.rst:51
msgid ""
"Projects that use this API are expected to follow CPython development and "
"spend extra effort adjusting to changes."
msgstr ""

#: ../../c-api/stable.rst:56
msgid "Stable Application Binary Interface"
msgstr "安定 ABI (Stable Appliction Binary Interface)"

#: ../../c-api/stable.rst:58
msgid ""
"For simplicity, this document talks about *extensions*, but the Limited API "
"and Stable ABI work the same way for all uses of the API – for example, "
"embedding Python."
msgstr ""

#: ../../c-api/stable.rst:65
msgid "Limited C API"
msgstr ""

#: ../../c-api/stable.rst:67
msgid ""
"Python 3.2 introduced the *Limited API*, a subset of Python's C API. "
"Extensions that only use the Limited API can be compiled once and be loaded "
"on multiple versions of Python. Contents of the Limited API are :ref:`listed "
"below <limited-api-list>`."
msgstr ""

#: ../../c-api/stable.rst:74
msgid ""
"Define this macro before including ``Python.h`` to opt in to only use the "
"Limited API, and to select the Limited API version."
msgstr ""
"このマクロを ``Python.h`` をインクルードする前に定義することで、 Limited API "
"のみを使用することを選択し、 Limited API バージョンを選択することができます。"

#: ../../c-api/stable.rst:77
msgid ""
"Define ``Py_LIMITED_API`` to the value of :c:macro:`PY_VERSION_HEX` "
"corresponding to the lowest Python version your extension supports. The "
"extension will be ABI-compatible with all Python 3 releases from the "
"specified one onward, and can use Limited API introduced up to that version."
msgstr ""

#: ../../c-api/stable.rst:83
msgid ""
"Rather than using the ``PY_VERSION_HEX`` macro directly, hardcode a minimum "
"minor version (e.g. ``0x030A0000`` for Python 3.10) for stability when "
"compiling with future Python versions."
msgstr ""
"``PY_VERSION_HEX`` マクロを直接使うのではなく、将来の Python のバージョンでコ"
"ンパイルするときの安定性のために、最小のマイナーバージョン(例えば、 Python "
"3.10なら ``0x030A0000`` )をハードコードします。"

#: ../../c-api/stable.rst:87
msgid ""
"You can also define ``Py_LIMITED_API`` to ``3``. This works the same as "
"``0x03020000`` (Python 3.2, the version that introduced Limited API)."
msgstr ""
"また、 ``Py_LIMITED_API`` を ``3`` に定義することができます。これは "
"``0x03020000`` (Python 3.2, Limited API が導入されたバージョン)と同じように動"
"作します。"

#: ../../c-api/stable.rst:94
msgid "Stable ABI"
msgstr "Stable ABI"

#: ../../c-api/stable.rst:96
msgid ""
"To enable this, Python provides a *Stable ABI*: a set of symbols that will "
"remain ABI-compatible across Python 3.x versions."
msgstr ""

#: ../../c-api/stable.rst:101
msgid ""
"The Stable ABI prevents ABI issues, like linker errors due to missing "
"symbols or data corruption due to changes in structure layouts or function "
"signatures. However, other changes in Python can change the *behavior* of "
"extensions. See Python's Backwards Compatibility Policy (:pep:`387`) for "
"details."
msgstr ""

#: ../../c-api/stable.rst:107
msgid ""
"The Stable ABI contains symbols exposed in the :ref:`Limited API <limited-c-"
"api>`, but also other ones – for example, functions necessary to support "
"older versions of the Limited API."
msgstr ""

#: ../../c-api/stable.rst:111
msgid ""
"On Windows, extensions that use the Stable ABI should be linked against "
"``python3.dll`` rather than a version-specific library such as ``python39."
"dll``."
msgstr ""
"Windows では、 Stable ABI を使用する拡張機能は、 ``python39.dll`` のような"
"バージョン固有のライブラリではなく、 ``python3.dll`` に対してリンクする必要が"
"あります。"

#: ../../c-api/stable.rst:115
msgid ""
"On some platforms, Python will look for and load shared library files named "
"with the ``abi3`` tag (e.g. ``mymodule.abi3.so``). It does not check if such "
"extensions conform to a Stable ABI. The user (or their packaging tools) need "
"to ensure that, for example, extensions built with the 3.10+ Limited API are "
"not installed for lower versions of Python."
msgstr ""
"いくつかのプラットフォームでは、 Python は ``abi3`` タグで名付けられた共有ラ"
"イブラリファイルを探して読み込みます(例: ``mymodule.abi3.so``)。このような拡"
"張モジュールが Stable ABI に適合しているかどうかはチェックされません。ユー"
"ザー(またはそのパッケージングツール)は、たとえば 3.10+ Limited API でビルドさ"
"れた拡張モジュールが、それ以下のバージョンの Python にインストールされないこ"
"とを確認する必要があります。"

#: ../../c-api/stable.rst:122
msgid ""
"All functions in the Stable ABI are present as functions in Python's shared "
"library, not solely as macros. This makes them usable from languages that "
"don't use the C preprocessor."
msgstr ""
"Stable ABI に含まれるすべての関数は、マクロとしてだけでなく、 Python の共有ラ"
"イブラリの関数として存在します。そのため、Cプリプロセッサを使用しない言語から"
"使用することができます。"

#: ../../c-api/stable.rst:128
msgid "Limited API Scope and Performance"
msgstr "APIスコープとパフォーマンスの制限"

#: ../../c-api/stable.rst:130
msgid ""
"The goal for the Limited API is to allow everything that is possible with "
"the full C API, but possibly with a performance penalty."
msgstr ""
"Limited API の目標は、フル C API で可能なすべてのことを実現することですが、お"
"そらく性能上の制約があります。"

#: ../../c-api/stable.rst:133
msgid ""
"For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro "
"variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it "
"can rely on version-specific implementation details of the list object."
msgstr ""
"例えば、 :c:func:`PyList_GetItem` は利用可能ですが、その “unsafe” マクロの変"
"種 :c:func:`PyList_GET_ITEM` は利用できません。このマクロは、リストオブジェク"
"トのバージョン固有の実装の詳細に依存することができるため、より高速に処理する"
"ことができます。"

#: ../../c-api/stable.rst:138
msgid ""
"Without ``Py_LIMITED_API`` defined, some C API functions are inlined or "
"replaced by macros. Defining ``Py_LIMITED_API`` disables this inlining, "
"allowing stability as Python's data structures are improved, but possibly "
"reducing performance."
msgstr ""
"``Py_LIMITED_API`` を定義しないと、いくつかの C API 関数がインライン化された"
"り、マクロに置き換わったりします。``Py_LIMITED_API`` を定義すると、このインラ"
"イン化が無効になり、 Python のデータ構造が改善されても安定した動作が可能にな"
"りますが、性能が低下する可能性があります。"

#: ../../c-api/stable.rst:143
msgid ""
"By leaving out the ``Py_LIMITED_API`` definition, it is possible to compile "
"a Limited API extension with a version-specific ABI. This can improve "
"performance for that Python version, but will limit compatibility. Compiling "
"with ``Py_LIMITED_API`` will then yield an extension that can be distributed "
"where a version-specific one is not available – for example, for prereleases "
"of an upcoming Python version."
msgstr ""
"``Py_LIMITED_API`` の定義を省くことで、 Limited API 拡張をバージョン固有の "
"ABI でコンパイルすることが可能です。これにより、その Python のバージョンでパ"
"フォーマンスを向上させることができますが、互換性は制限されます。"
"``Py_LIMITED_API`` でコンパイルすると、バージョンに依存しない拡張機能が利用で"
"きない場合、例えば、次期 Python バージョンのプレリリースに対応した拡張モ"
"ジュールを配布することができるようになります。"

#: ../../c-api/stable.rst:152
msgid "Limited API Caveats"
msgstr "制限付きAPIの注意点"

#: ../../c-api/stable.rst:154
msgid ""
"Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee "
"that code conforms to the :ref:`Limited API <limited-c-api>` or the :ref:"
"`Stable ABI <stable-abi>`. ``Py_LIMITED_API`` only covers definitions, but "
"an API also includes other issues, such as expected semantics."
msgstr ""

#: ../../c-api/stable.rst:159
msgid ""
"One issue that ``Py_LIMITED_API`` does not guard against is calling a "
"function with arguments that are invalid in a lower Python version. For "
"example, consider a function that starts accepting ``NULL`` for an argument. "
"In Python 3.9, ``NULL`` now selects a default behavior, but in Python 3.8, "
"the argument will be used directly, causing a ``NULL`` dereference and "
"crash. A similar argument works for fields of structs."
msgstr ""
"``Py_LIMITED_API`` が防げない問題の1つは、 Python の下位バージョンでは無効な"
"引数を持つ関数を呼び出すことです。例えば、引数に ``NULL`` を受け取る関数を考"
"えてみましょう。Python 3.9 では ``NULL`` はデフォルトの挙動を選択しますが、"
"Python 3.8 ではこの引数は直接使用され、 ``NULL`` の参照外れを起こしクラッシュ"
"します。同様の引数は、構造体のフィールドに対しても機能します。"

#: ../../c-api/stable.rst:166
msgid ""
"Another issue is that some struct fields are currently not hidden when "
"``Py_LIMITED_API`` is defined, even though they're part of the Limited API."
msgstr ""
"もう一つの問題は、一部の構造体フィールドがLimited APIの一部であるにもかかわら"
"ず、 ``Py_LIMITED_API`` が定義されたときに現在非表示になっていないことです。"

#: ../../c-api/stable.rst:169
msgid ""
"For these reasons, we recommend testing an extension with *all* minor Python "
"versions it supports, and preferably to build with the *lowest* such version."
msgstr ""
"これらの理由から、私たちは拡張モジュールがサポートする *すべての* マイナーな "
"Python バージョンでテストすること、そしてできれば *最も低い* バージョンでビル"
"ドすることを推奨します。"

#: ../../c-api/stable.rst:172
msgid ""
"We also recommend reviewing documentation of all used API to check if it is "
"explicitly part of the Limited API. Even with ``Py_LIMITED_API`` defined, a "
"few private declarations are exposed for technical reasons (or even "
"unintentionally, as bugs)."
msgstr ""
"また、使用するすべての API のドキュメントを確認し、それが明示的に Limited "
"API の一部であるかどうかをチェックすることをお勧めします。``Py_LIMITED_API`` "
"が定義されていても、技術的な理由で(あるいはバグとして意図せず)いくつかのプラ"
"イベート宣言が公開されることがあります。"

#: ../../c-api/stable.rst:177
msgid ""
"Also note that the Limited API is not necessarily stable: compiling with "
"``Py_LIMITED_API`` with Python 3.8 means that the extension will run with "
"Python 3.12, but it will not necessarily *compile* with Python 3.12. In "
"particular, parts of the Limited API may be deprecated and removed, provided "
"that the Stable ABI stays stable."
msgstr ""
"Python 3.8 で ``Py_LIMITED_API`` をコンパイルすると、その拡張モジュールは "
"Python 3.12 で動作しますが、必ずしも Python 3.12 で *コンパイル* できるとは限"
"らないことに注意してください。特に、Limited API の一部は、 Stable ABI が安定"
"している限り、非推奨で削除されるかもしれません。"

#: ../../c-api/stable.rst:187
msgid "Platform Considerations"
msgstr "プラットフォームで考慮すべき点"

#: ../../c-api/stable.rst:189
msgid ""
"ABI stability depends not only on Python, but also on the compiler used, "
"lower-level libraries and compiler options. For the purposes of the :ref:"
"`Stable ABI <stable-abi>`, these details define a “platform”. They usually "
"depend on the OS type and processor architecture"
msgstr ""

#: ../../c-api/stable.rst:194
msgid ""
"It is the responsibility of each particular distributor of Python to ensure "
"that all Python versions on a particular platform are built in a way that "
"does not break the Stable ABI. This is the case with Windows and macOS "
"releases from ``python.org`` and many third-party distributors."
msgstr ""
"特定のプラットフォーム上のすべての Python バージョンが安定版 ABI を破壊しない"
"方法でビルドされていることを保証するのは、 Python の各特定配布者の責任です。"
"これは ``python.org`` や多くのサードパーティーの配布元からの Windows と "
"macOS のリリースの場合です。"

#: ../../c-api/stable.rst:204
msgid "Contents of Limited API"
msgstr "限定版APIの内容"

#: ../../c-api/stable.rst:207
msgid ""
"Currently, the :ref:`Limited API <limited-c-api>` includes the following "
"items:"
msgstr ""

#: ../../c-api/stable.rst:42
msgid "PyUnstable"
msgstr ""