python-docs-ja/c-api/import.po at 3.14 · python/python-docs-ja

572 lines (493 loc) · 22.8 KB
# 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
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-06-09 16:27+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"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/import.rst:6
msgid "Importing Modules"
msgstr "モジュールのインポート"
#: ../../c-api/import.rst:16
"This is a wrapper around :c:func:`PyImport_Import()` which takes a :c:expr:"
"`const char *` as an argument instead of a :c:expr:`PyObject *`."
#: ../../c-api/import.rst:24
"Import a module.  This is best described by referring to the built-in Python "
"function :func:`__import__`."
"モジュールをインポートします。モジュールのインポートについては組み込みの "
"Python 関数 :func:`__import__` を読むとよくわかります。"
#: ../../c-api/import.rst:27 ../../c-api/import.rst:43
"The return value is a new reference to the imported module or top-level "
"package, or ``NULL`` with an exception set on failure.  Like for :func:"
"`__import__`, the return value when a submodule of a package was requested "
"is normally the top-level package, unless a non-empty *fromlist* was given."
"戻り値は、インポートされたモジュールかトップレベルパッケージへの新しい参照"
"か、失敗した場合は例外を設定して ``NULL`` を返します。\n"
":func:`__import__` と同じように、パッケージのサブモジュールが要求されたとき"
"は、空でない *fromlist* を渡された時以外は、トップレベルのパッケージを返しま"
#: ../../c-api/import.rst:33
"Failing imports remove incomplete module objects, like with :c:func:"
"`PyImport_ImportModule`."
"インポートが失敗した場合は、:c:func:`PyImport_ImportModule` と同様に不完全な"
"モジュールのオブジェクトを削除します。"
#: ../../c-api/import.rst:39
"Import a module.  This is best described by referring to the built-in Python "
"function :func:`__import__`, as the standard :func:`__import__` function "
"calls this function directly."
"モジュールをインポートします。モジュールのインポートについては組み込みの "
"Python 関数 :func:`__import__` を読むとよく分かります。というのも、標準の :"
"func:`__import__`  はこの関数を直接呼び出しているからです。"
#: ../../c-api/import.rst:53
"Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is a "
"UTF-8 encoded string instead of a Unicode object."
":c:func:`PyImport_ImportModuleLevelObject` と似ていますが、name が Unicode オ"
"ブジェクトではなく UTF-8 でエンコードされた文字列である点で異なります。"
#: ../../c-api/import.rst:56
msgid "Negative values for *level* are no longer accepted."
msgstr "*level* にはもはや負の値は使用できません。"
#: ../../c-api/import.rst:61
"This is a higher-level interface that calls the current \"import hook "
"function\" (with an explicit *level* of 0, meaning absolute import).  It "
"invokes the :func:`__import__` function from the ``__builtins__`` of the "
"current globals.  This means that the import is done using whatever import "
"hooks are installed in the current environment."
"現在の \"インポートフック関数\" を呼び出すための高水準のインターフェースです "
"(*level* に 0 を明示すると、絶対インポートを意味します)。 この関数は現在のグ"
"ローバル変数辞書内の ``__builtins__`` から :func:`__import__` 関数を呼び出し"
"ます。すなわち、現在の環境にインストールされているインポートフック使ってイン"
"ポートを行います。"
#: ../../c-api/import.rst:67
msgid "This function always uses absolute imports."
msgstr "この関数は常に絶対インポートを使用します。"
#: ../../c-api/import.rst:72
"Reload a module.  Return a new reference to the reloaded module, or ``NULL`` "
"with an exception set on failure (the module still exists in this case)."
"モジュールを再ロード (reload) します。戻り値は再ロードしたモジュールかトップ"
"レベルパッケージへの新たな参照になります。\n"
"失敗した場合には例外をセットし、``NULL`` を返します (その場合でも、モジュール"
"は生成されている場合があります)。"
#: ../../c-api/import.rst:78
msgid "Return the module object corresponding to a module name."
#: ../../c-api/import.rst:80
"The *name* argument may be of the form ``package.module``. First check the "
"modules dictionary if there's one there, and if not, create a new one and "
"insert it in the modules dictionary."
#: ../../c-api/import.rst:84
"Return a :term:`strong reference` to the module on success. Return ``NULL`` "
"with an exception set on failure."
#: ../../c-api/import.rst:87
msgid "The module name *name* is decoded from UTF-8."
#: ../../c-api/import.rst:89
"This function does not load or import the module; if the module wasn't "
"already loaded, you will get an empty module object. Use :c:func:"
"`PyImport_ImportModule` or one of its variants to import a module. Package "
"structures implied by a dotted name for *name* are not created if not "
"already present."
#: ../../c-api/import.rst:100
"Similar to :c:func:`PyImport_AddModuleRef`, but return a :term:`borrowed "
"reference` and *name* is a Python :class:`str` object."
#: ../../c-api/import.rst:108
"Similar to :c:func:`PyImport_AddModuleRef`, but return a :term:`borrowed "
"reference`."
#: ../../c-api/import.rst:116
"Given a module name (possibly of the form ``package.module``) and a code "
"object read from a Python bytecode file or obtained from the built-in "
"function :func:`compile`, load the module.  Return a new reference to the "
"module object, or ``NULL`` with an exception set if an error occurred.  "
"*name* is removed from :data:`sys.modules` in error cases, even if *name* "
"was already in :data:`sys.modules` on entry to :c:func:"
"`PyImport_ExecCodeModule`.  Leaving incompletely initialized modules in :"
"data:`sys.modules` is dangerous, as imports of such modules have no way to "
"know that the module object is an unknown (and probably damaged with respect "
"to the module author's intents) state."
#: ../../c-api/import.rst:126
"The module's :attr:`~module.__spec__` and :attr:`~module.__loader__` will be "
"set, if not set already, with the appropriate values.  The spec's loader "
"will be set to the module's :attr:`!__loader__` (if set) and to an instance "
"of :class:`~importlib.machinery.SourceFileLoader` otherwise."
#: ../../c-api/import.rst:131
"The module's :attr:`~module.__file__` attribute will be set to the code "
"object's :attr:`~codeobject.co_filename`."
#: ../../c-api/import.rst:134
"This function will reload the module if it was already imported.  See :c:"
"func:`PyImport_ReloadModule` for the intended way to reload a module."
"この関数は、すでにインポートされているモジュールの場合には再ロードを行いま"
"す。意図的にモジュールの再ロードを行う方法は :c:func:`PyImport_ReloadModule` "
"を参照してください。"
#: ../../c-api/import.rst:137
"If *name* points to a dotted name of the form ``package.module``, any "
"package structures not already created will still not be created."
"*name* が ``package.module`` 形式のドット名表記であった場合、まだ作成されてい"
"ないパッケージ構造はその作成されないままになります。"
#: ../../c-api/import.rst:140
"See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:"
"`PyImport_ExecCodeModuleWithPathnames`."
":c:func:`PyImport_ExecCodeModuleEx` と :c:func:"
"`PyImport_ExecCodeModuleWithPathnames` も参照してください。"
#: ../../c-api/import.rst:143
"The setting of ``__cached__`` and :attr:`~module.__loader__` is deprecated. "
"See :class:`~importlib.machinery.ModuleSpec` for alternatives."
#: ../../c-api/import.rst:148
msgid "``__cached__`` is no longer set."
#: ../../c-api/import.rst:154
"Like :c:func:`PyImport_ExecCodeModule`, but the :attr:`~module.__file__` "
"attribute of the module object is set to *pathname* if it is non-``NULL``."
#: ../../c-api/import.rst:157
msgid "See also :c:func:`PyImport_ExecCodeModuleWithPathnames`."
msgstr ":c:func:`PyImport_ExecCodeModuleWithPathnames` も参照してください。"
#: ../../c-api/import.rst:162
"Like :c:func:`PyImport_ExecCodeModuleEx`, but the path to any compiled file "
"via *cpathname* is used appropriately when non-``NULL``.  Of the three "
"functions, this is the preferred one to use."
#: ../../c-api/import.rst:168
"Setting ``__cached__`` is deprecated. See :class:`~importlib.machinery."
"ModuleSpec` for alternatives."
#: ../../c-api/import.rst:172
msgid "``__cached__`` no longer set."
#: ../../c-api/import.rst:178
"Like :c:func:`PyImport_ExecCodeModuleObject`, but *name*, *pathname* and "
"*cpathname* are UTF-8 encoded strings. Attempts are also made to figure out "
"what the value for *pathname* should be from *cpathname* if the former is "
"set to ``NULL``."
":c:func:`PyImport_ExecCodeModuleObject` と似ていますが、 *name* と "
"*pathname*、 *cpathname* が UTF-8 でエンコードされた文字列である点が異なりま"
"す。もし *pathname* が ``NULL`` の場合、*cpathname* から、*pathname* どのよう"
"な値になるべきかを知る試みもなされます。"
#: ../../c-api/import.rst:184
"Uses :func:`!imp.source_from_cache` in calculating the source path if only "
"the bytecode path is provided."
#: ../../c-api/import.rst:187
msgid "No longer uses the removed :mod:`!imp` module."
#: ../../c-api/import.rst:193
"Return the magic number for Python bytecode files (a.k.a. :file:`.pyc` "
"file). The magic number should be present in the first four bytes of the "
"bytecode file, in little-endian byte order. Returns ``-1`` on error."
"Python バイトコードファイル (別名 :file:`.pyc` ファイル) のマジックナンバーを"
"返します。マジックナンバーはバイトコードファイルの最初の4バイトに、リトルエン"
"ディアンバイトオーダーで現れるべきです。エラーの場合は ``-1`` を返します。"
#: ../../c-api/import.rst:197
msgid "Return value of ``-1`` upon failure."
msgstr "失敗した場合は ``-1`` の値を返します。"
#: ../../c-api/import.rst:203
"Return the magic tag string for :pep:`3147` format Python bytecode file "
"names.  Keep in mind that the value at ``sys.implementation.cache_tag`` is "
"authoritative and should be used instead of this function."
"マジックタグ文字列を Python バイトコードファイル名の :pep:`3147` フォーマット"
"で返します。``sys.implementation.cache_tag`` の値が信頼でき、かつこの関数の代"
"わりに使用すべきであることを肝に命じましょう。"
#: ../../c-api/import.rst:211
"Return the dictionary used for the module administration (a.k.a. ``sys."
"modules``).  Note that this is a per-interpreter variable."
"モジュール管理のための辞書 (いわゆる ``sys.modules``)を返します。この辞書はイ"
"ンタプリタごとに一つだけある変数なので注意してください。"
#: ../../c-api/import.rst:216
"Return the already imported module with the given name.  If the module has "
"not been imported yet then returns ``NULL`` but does not set an error.  "
"Returns ``NULL`` and sets an error if the lookup failed."
"与えられた名前の既にインポート済みのモジュールを返します。\n"
"モジュールがインポートされていなかった場合は、 ``NULL`` を返しますが、エラー"
"はセットしません。\n"
"モジュールの検索に失敗した場合は、 ``NULL`` を返し、エラーをセットします。"
#: ../../c-api/import.rst:224
"Return a finder object for a :data:`sys.path`/:attr:`!pkg.__path__` item "
"*path*, possibly by fetching it from the :data:`sys.path_importer_cache` "
"dict.  If it wasn't yet cached, traverse :data:`sys.path_hooks` until a hook "
"is found that can handle the path item.  Return ``None`` if no hook could; "
"this tells our caller that the :term:`path based finder` could not find a "
"finder for this path item. Cache the result in :data:`sys."
"path_importer_cache`. Return a new reference to the finder object."
#: ../../c-api/import.rst:235
"Load a frozen module named *name*.  Return ``1`` for success, ``0`` if the "
"module is not found, and ``-1`` with an exception set if the initialization "
"failed.  To access the imported module on a successful load, use :c:func:"
"`PyImport_ImportModule`.  (Note the misnomer --- this function would reload "
"the module if it was already imported.)"
"*name* という名前のフリーズ (freeze) されたモジュールをロードします。成功する"
"と ``1`` を、モジュールが見つからなかった場合には ``0`` を、初期化が失敗した"
"場合には例外をセットして ``-1`` を返します。ロードに成功したモジュールにアク"
"セスするには :c:func:`PyImport_ImportModule` を使ってください。 (Note この関"
"数はいささか誤解を招く名前です --- この関数はモジュールがすでにインポートされ"
"ていたらリロードしてしまいます。)"
#: ../../c-api/import.rst:243
msgid "The ``__file__`` attribute is no longer set on the module."
msgstr "``__file__`` 属性はもうモジュールにセットされません。"
#: ../../c-api/import.rst:249
"Similar to :c:func:`PyImport_ImportFrozenModuleObject`, but the name is a "
"UTF-8 encoded string instead of a Unicode object."
":c:func:`PyImport_ImportFrozenModuleObject` と似ていますが、name は UTF-8 で"
"エンコードされた文字列の代わりに、 Unicode オブジェクトを使用する点が異なりま"
#: ../../c-api/import.rst:257
"This is the structure type definition for frozen module descriptors, as "
"generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the "
"Python source distribution).  Its definition, found in :file:`Include/import."
":program:`freeze` ユーティリティが生成するようなフリーズ化モジュールデスクリ"
"プタの構造体型定義です。 (Python ソース配布物の :file:`Tools/freeze/` を参照"
"してください) この構造体の定義は :file:`Include/import.h` にあり、以下のよう"
"になっています::"
#: ../../c-api/import.rst:262
"struct _frozen {\n"
"    const char *name;\n"
"    const unsigned char *code;\n"
"    int size;\n"
"    bool is_package;\n"
#: ../../c-api/import.rst:269
"The new ``is_package`` field indicates whether the module is a package or "
"not. This replaces setting the ``size`` field to a negative value."
#: ../../c-api/import.rst:275
"This pointer is initialized to point to an array of :c:struct:`_frozen` "
"records, terminated by one whose members are all ``NULL`` or zero.  When a "
"frozen module is imported, it is searched in this table.  Third-party code "
"could play tricks with this to provide a dynamically created collection of "
"frozen modules."
"このポインタは :c:struct:`_frozen` のレコードからなり、終端の要素のメンバが "
"``NULL`` かゼロになっているような配列を指すよう初期化されます。\n"
"フリーズされたモジュールをインポートするとき、このテーブルを検索します。\n"
"サードパーティ製のコードからこのポインタに仕掛けを講じて、動的に生成されたフ"
"リーズ化モジュールの集合を提供するようにできます。"
#: ../../c-api/import.rst:283
"Add a single module to the existing table of built-in modules.  This is a "
"convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning "
"``-1`` if the table could not be extended.  The new module can be imported "
"by the name *name*, and uses the function *initfunc* as the initialization "
"function called on the first attempted import.  This should be called "
"before :c:func:`Py_Initialize`."
"既存の組み込みモジュールテーブルに単一のモジュールを追加します。この関数は利"
"便性を目的とした :c:func:`PyImport_ExtendInittab` のラッパー関数で、テーブル"
"が拡張できないときには ``-1`` を返します。新たなモジュールは *name* でイン"
"ポートでき、最初にインポートを試みた際に呼び出される関数として *initfunc* を"
"使います。 :c:func:`Py_Initialize` よりも前に呼び出さなければなりません。"
#: ../../c-api/import.rst:293
"Structure describing a single entry in the list of built-in modules. "
"Programs which embed Python may use an array of these structures in "
"conjunction with :c:func:`PyImport_ExtendInittab` to provide additional "
"built-in modules. The structure consists of two members:"
#: ../../c-api/import.rst:301
msgid "The module name, as an ASCII encoded string."
#: ../../c-api/import.rst:305
msgid "Initialization function for a module built into the interpreter."
#: ../../c-api/import.rst:310
"Add a collection of modules to the table of built-in modules.  The *newtab* "
"array must end with a sentinel entry which contains ``NULL`` for the :c:"
"member:`~_inittab.name` field; failure to provide the sentinel value can "
"result in a memory fault. Returns ``0`` on success or ``-1`` if insufficient "
"memory could be allocated to extend the internal table.  In the event of "
"failure, no modules are added to the internal table.  This must be called "
"before :c:func:`Py_Initialize`."
#: ../../c-api/import.rst:317
"If Python is initialized multiple times, :c:func:`PyImport_AppendInittab` "
"or :c:func:`PyImport_ExtendInittab` must be called before each Python "
"initialization."
"Python が複数回初期化される場合、:c:func:`PyImport_AppendInittab` または :c:"
"func:`PyImport_ExtendInittab` は、それぞれの初期化の前に呼び出される必要があ"
#: ../../c-api/import.rst:324
"The table of built-in modules used by Python initialization. Do not use this "
"directly; use :c:func:`PyImport_AppendInittab` and :c:func:"
"`PyImport_ExtendInittab` instead."
#: ../../c-api/import.rst:331
msgid "Import the module *mod_name* and get its attribute *attr_name*."
#: ../../c-api/import.rst:333
msgid "Names must be Python :class:`str` objects."
#: ../../c-api/import.rst:335
"Helper function combining :c:func:`PyImport_Import` and :c:func:"
"`PyObject_GetAttr`. For example, it can raise :exc:`ImportError` if the "
"module is not found, and :exc:`AttributeError` if the attribute doesn't "
#: ../../c-api/import.rst:344 ../../c-api/import.rst:364
"Similar to :c:func:`PyImport_ImportModuleAttr`, but names are UTF-8 encoded "
"strings instead of Python :class:`str` objects."
#: ../../c-api/import.rst:351
msgid "Gets the current lazy imports mode."
#: ../../c-api/import.rst:357
"Return a :term:`strong reference` to the current lazy imports filter, or "
"``NULL`` if none exists. This function always succeeds."
#: ../../c-api/import.rst:367
msgid "This function always returns ``0``."
#: ../../c-api/import.rst:373
"Sets the current lazy imports filter. The *filter* should be a callable that "
"will receive ``(importing_module_name, imported_module_name, [fromlist])`` "
"when an import can potentially be lazy. The ``imported_module_name`` value "
"is the resolved module name, so ``lazy from .spam import eggs`` passes "
"``package.spam``. The callable must return ``True`` if the import should be "
"lazy and ``False`` otherwise."
#: ../../c-api/import.rst:380
msgid "Return ``0`` on success and ``-1`` with an exception set otherwise."
#: ../../c-api/import.rst:386
msgid "Enumeration of possible lazy import modes."
#: ../../c-api/import.rst:390
msgid "Respect the ``lazy`` keyword in source code. This is the default mode."
#: ../../c-api/import.rst:394
msgid "Make all imports lazy by default."
#: ../../c-api/import.rst:400
"This function is a building block that enables embedders to implement the :"
"py:meth:`~importlib.abc.Loader.create_module` step of custom static "
"extension importers (e.g. of statically-linked extensions)."
#: ../../c-api/import.rst:404
msgid "*spec* must be a :class:`~importlib.machinery.ModuleSpec` object."
#: ../../c-api/import.rst:406
"*initfunc* must be an :ref:`initialization function <extension-export-"
"hook>`, the same as for :c:func:`PyImport_AppendInittab`."
#: ../../c-api/import.rst:409
"On success, create and return a module object. This module will not be "
"initialized; call :c:func:`PyModule_Exec` to initialize it. (Custom "
"importers should do this in their :py:meth:`~importlib.abc.Loader."
"exec_module` method.)"
#: ../../c-api/import.rst:415
msgid "On error, return NULL with an exception set."
#: ../../c-api/import.rst:11
msgid "package variable"
#: ../../c-api/import.rst:11
msgid "__all__"
msgstr "__all__"
#: ../../c-api/import.rst:11
msgid "__all__ (package variable)"
#: ../../c-api/import.rst:11
msgid "modules (in module sys)"
msgstr "modules (in module sys)"
#: ../../c-api/import.rst:22 ../../c-api/import.rst:114
msgid "built-in function"
msgstr "組み込み関数"
#: ../../c-api/import.rst:22
msgid "__import__"
msgstr "__import__"
#: ../../c-api/import.rst:114
msgid "compile"
msgstr "コンパイル"
#: ../../c-api/import.rst:255
msgid "freeze utility"
msgstr "凍結ユーティリティ"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

import.po

Latest commit

History

import.po

File metadata and controls
