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

742 lines (656 loc) · 31.3 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-08-29 17:28+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/veryhigh.rst:8
msgid "The Very High Level Layer"
msgstr "超高水準レイヤ"
#: ../../c-api/veryhigh.rst:10
"The functions in this chapter will let you execute Python source code given "
"in a file or a buffer, but they will not let you interact in a more detailed "
"way with the interpreter."
"この章の関数を使うとファイルまたはバッファにある Python ソースコードを実行で"
"きますが、より詳細なやり取りをインタプリタとすることはできないでしょう。"
#: ../../c-api/veryhigh.rst:14
"Several of these functions accept a start symbol from the grammar as a "
"parameter.  The available start symbols are :c:data:`Py_eval_input`, :c:data:"
"`Py_file_input`, :c:data:`Py_single_input`, and :c:data:"
"`Py_func_type_input`.  These are described following the functions which "
"accept them as parameters."
#: ../../c-api/veryhigh.rst:20
"Note also that several of these functions take :c:expr:`FILE*` parameters.  "
"One particular issue which needs to be handled carefully is that the :c:type:"
"`FILE` structure for different C libraries can be different and "
"incompatible.  Under Windows (at least), it is possible for dynamically "
"linked extensions to actually use different libraries, so care should be "
"taken that :c:expr:`FILE*` parameters are only passed to these functions if "
"it is certain that they were created by the same library that the Python "
"runtime is using."
#: ../../c-api/veryhigh.rst:31
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
"下記の :c:func:`PyRun_AnyFileExFlags` の *closeit* を ``0`` に、 *flags* を "
"``NULL`` にして単純化したインターフェースです。"
#: ../../c-api/veryhigh.rst:37
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving the *closeit* argument set to ``0``."
"下記の :c:func:`PyRun_AnyFileExFlags` の *closeit* を ``0`` にして単純化した"
"インターフェースです。"
#: ../../c-api/veryhigh.rst:43
"This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, "
"leaving the *flags* argument set to ``NULL``."
"下記の :c:func:`PyRun_AnyFileExFlags` の *flags* を ``NULL`` にして単純化した"
"インターフェースです。"
#: ../../c-api/veryhigh.rst:49
"If *fp* refers to a file associated with an interactive device (console or "
"terminal input or Unix pseudo-terminal), return the value of :c:func:"
"`PyRun_InteractiveLoop`, otherwise return the result of :c:func:"
"`PyRun_SimpleFile`.  *filename* is decoded from the filesystem encoding (:"
"func:`sys.getfilesystemencoding`).  If *filename* is ``NULL``, this function "
"uses ``\"???\"`` as the filename. If *closeit* is true, the file is closed "
"before ``PyRun_SimpleFileExFlags()`` returns."
"*fp* が対話的デバイス (コンソールや端末入力あるいは Unix 仮想端末) と関連づけ"
"られたファイルを参照している場合は、 :c:func:`PyRun_InteractiveLoop` の値を返"
"します。それ以外の場合は、 :c:func:`PyRun_SimpleFile` の結果を返します。 "
"*filename* はファイルシステムのエンコーディング (:func:`sys."
"getfilesystemencoding`) でデコードされます。 *filename* が ``NULL`` ならば、"
"この関数はファイル名として ``\"???\"`` を使います。*closeit* が真なら、ファイ"
"ルは ``PyRun_SimpleFileExFlags()`` が処理を戻す前に閉じられます。"
#: ../../c-api/veryhigh.rst:61
"This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, "
"leaving the :c:struct:`PyCompilerFlags`\\* argument set to ``NULL``."
"下記の :c:func:`PyRun_SimpleStringFlags` の :c:struct:`PyCompilerFlags`\\* "
"を ``NULL`` にして単純化したインタフェースです。"
#: ../../c-api/veryhigh.rst:67
"Executes the Python source code from *command* in the :mod:`__main__` module "
"according to the *flags* argument. If :mod:`__main__` does not already "
"exist, it is created.  Returns ``0`` on success or ``-1`` if an exception "
"was raised.  If there was an error, there is no way to get the exception "
"information. For the meaning of *flags*, see below."
":mod:`__main__` モジュールの中で *flags* に従って *command* に含まれる "
"Python ソースコードを実行します。 :mod:`__main__` がまだ存在しない場合は作成"
"されます。正常終了の場合は ``0`` を返し、また例外が発生した場合は ``-1`` を返"
"します。エラーがあっても、例外情報を得る方法はありません。 *flags* の意味につ"
"いては、後述します。"
#: ../../c-api/veryhigh.rst:73
"Note that if an otherwise unhandled :exc:`SystemExit` is raised, this "
"function will not return ``-1``, but exit the process, as long as :c:member:"
"`PyConfig.inspect` is zero."
#: ../../c-api/veryhigh.rst:80
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
"leaving *closeit* set to ``0`` and *flags* set to ``NULL``."
"下記の :c:func:`PyRun_SimpleFileExFlags` の *closeit* を ``0`` に、 *flags* "
"を ``NULL`` にして単純化したインターフェースです。"
#: ../../c-api/veryhigh.rst:86
"This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, "
"leaving *flags* set to ``NULL``."
"下記の :c:func:`PyRun_SimpleFileExFlags` の *flags* を ``NULL`` にして単純化"
"したインターフェースです。"
#: ../../c-api/veryhigh.rst:92
"Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is "
"read from *fp* instead of an in-memory string. *filename* should be the name "
"of the file, it is decoded from :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before "
"``PyRun_SimpleFileExFlags()`` returns."
":c:func:`PyRun_SimpleStringFlags` と似ていますが、Pythonソースコードをメモリ"
"内の文字列ではなく *fp* から読み込みます。 *filename* はそのファイルの名前で"
"なければならず、 :term:`ファイルシステムのエンコーディングとエラーハンドラ "
"<filesystem encoding and error handler>` でデコードされます。 *closeit* に真"
"を指定した場合は、``PyRun_SimpleFileExFlags()`` が処理を戻す前にファイルを閉"
#: ../../c-api/veryhigh.rst:99
"On Windows, *fp* should be opened as binary mode (e.g. ``fopen(filename, "
"\"rb\")``). Otherwise, Python may not handle script file with LF line ending "
"correctly."
"Windowsでは、 *fp* はバイナリモードで開くべきです (例えば ``fopen(filename, "
"\"rb\")``)。\n"
"そうしない場合は、 Python は行末が LF のスクリプトを正しく扱えないでしょう。"
#: ../../c-api/veryhigh.rst:105
"Read and execute a single statement from a file associated with an "
"interactive device according to the *flags* argument.  The user will be "
"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* must be a Python :"
"class:`str` object."
#: ../../c-api/veryhigh.rst:110
"Returns ``0`` when the input was executed successfully, ``-1`` if there was "
"an exception, or an error code from the :file:`errcode.h` include file "
"distributed as part of Python if there was a parse error.  (Note that :file:"
"`errcode.h` is not included by :file:`Python.h`, so must be included "
"specifically if needed.)"
"入力が正常に実行されたときは ``0`` を返します。例外が発生した場合は ``-1`` を"
"返します。パースエラーの場合はPythonの一部として配布されている :file:"
"`errcode.h` インクルードファイルにあるエラーコードを返します。 (:file:"
"`Python.h` は :file:`errcode.h` をインクルードしません。従って、 必要な場合は"
"その都度インクルードしなければならないことに注意してください。)"
#: ../../c-api/veryhigh.rst:119
"This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, "
"leaving *flags* set to ``NULL``."
"下記の :c:func:`PyRun_InteractiveOneFlags` の *flags* を ``NULL`` にして単純"
"化したインターフェースです。"
#: ../../c-api/veryhigh.rst:125
"Similar to :c:func:`PyRun_InteractiveOneObject`, but *filename* is a :c:expr:"
"`const char*`, which is decoded from the :term:`filesystem encoding and "
"error handler`."
#: ../../c-api/veryhigh.rst:132
"This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` "
"below, leaving *flags* set to ``NULL``."
"下記の :c:func:`PyRun_InteractiveLoopFlags` の *flags* を ``NULL`` にして単純"
"化したインターフェースです。"
#: ../../c-api/veryhigh.rst:138
"Read and execute statements from a file associated with an interactive "
"device until EOF is reached.  The user will be prompted using ``sys.ps1`` "
"and ``sys.ps2``.  *filename* is decoded from the :term:`filesystem encoding "
"and error handler`.  Returns ``0`` at EOF or a negative number upon failure."
"対話的デバイスに関連付けられたファイルから EOF に達するまで文を読み込み実行し"
"``sys.ps1`` と ``sys.ps2`` を使って、ユーザにプロンプトを表示します。\n"
"*filename* は :term:`ファイルシステムのエンコーディングとエラーハンドラ "
"<filesystem encoding and error handler>` でデコードされます。\n"
"EOFに達すると ``0`` を返すか、失敗したら負の数を返します。"
#: ../../c-api/veryhigh.rst:146
"Can be set to point to a function with the prototype ``int func(void)``.  "
"The function will be called when Python's interpreter prompt is about to "
"become idle and wait for user input from the terminal.  The return value is "
"ignored.  Overriding this hook can be used to integrate the interpreter's "
"prompt with other event loops, as done in :file:`Modules/_tkinter.c` in the "
"Python source code."
#: ../../c-api/veryhigh.rst:154 ../../c-api/veryhigh.rst:178
"This function is only called from the :ref:`main interpreter <sub-"
"interpreter-support>`."
#: ../../c-api/veryhigh.rst:161
"Can be set to point to a function with the prototype ``char *func(FILE "
"*stdin, FILE *stdout, char *prompt)``, overriding the default function used "
"to read a single line of input at the interpreter's prompt.  The function is "
"expected to output the string *prompt* if it's not ``NULL``, and then read a "
"line of input from the provided standard input file, returning the resulting "
"string.  For example, The :mod:`readline` module sets this hook to provide "
"line-editing and tab-completion features."
"``char *func(FILE *stdin, FILE *stdout, char *prompt)`` というプロトタイプの"
"関数へのポインタが設定でき、デフォルトの関数を上書きすることでインタプリタの"
"プロンプトへの入力を1行だけ読めます。\n"
"この関数は、文字列 *prompt* が ``NULL`` でない場合は *prompt* を出力し、与え"
"られた標準入力ファイルから入力を1行読み、結果の文字列を返すという動作が期待さ"
"例えば、 :mod:`readline` モジュールはこのフックを設定して、行編集機能やタブ補"
"完機能を提供しています。"
#: ../../c-api/veryhigh.rst:170
"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:"
"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred."
"返り値は :c:func:`PyMem_RawMalloc` または :c:func:`PyMem_RawRealloc` でメモリ"
"確保した文字列、あるいはエラーが起きた場合には ``NULL`` でなければなりませ"
#: ../../c-api/veryhigh.rst:173
"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:"
"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :"
"c:func:`PyMem_Realloc`."
"返り値は、 :c:func:`PyMem_Malloc` や :c:func:`PyMem_Realloc` ではなく、 :c:"
"func:`PyMem_RawMalloc` または :c:func:`PyMem_RawRealloc` でメモリ確保したもの"
"でなければなりません。"
#: ../../c-api/veryhigh.rst:184
"This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving "
"*flags* set to ``NULL``."
"下記の :c:func:`PyRun_StringFlags` の *flags* を ``NULL`` にして単純化したイ"
"ンターフェースです。"
#: ../../c-api/veryhigh.rst:190
"Execute Python source code from *str* in the context specified by the "
"objects *globals* and *locals* with the compiler flags specified by "
"*flags*.  *globals* must be a dictionary; *locals* can be any object that "
"implements the mapping protocol.  The parameter *start* specifies the start "
"symbol and must be one of the :ref:`available start symbols <start-symbols>`."
#: ../../c-api/veryhigh.rst:196
"Returns the result of executing the code as a Python object, or ``NULL`` if "
"an exception was raised."
"コードを実行した結果をPythonオブジェクトとして返します。または、例外が発生し"
"たならば ``NULL`` を返します。"
#: ../../c-api/veryhigh.rst:202
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0`` and *flags* set to ``NULL``."
"下記の :c:func:`PyRun_FileExFlags` の *closeit* を ``0`` にし、 *flags* を "
"``NULL`` にして単純化したインターフェースです。"
#: ../../c-api/veryhigh.rst:208
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*flags* set to ``NULL``."
"下記の :c:func:`PyRun_FileExFlags` の *flags* を ``NULL`` にして単純化したイ"
"ンターフェースです。"
#: ../../c-api/veryhigh.rst:214
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0``."
"下記の :c:func:`PyRun_FileExFlags` の *closeit* を ``0`` にして単純化したイン"
"ターフェースです。"
#: ../../c-api/veryhigh.rst:220
"Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read "
"from *fp* instead of an in-memory string. *filename* should be the name of "
"the file, it is decoded from the :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before :c:func:"
"`PyRun_FileExFlags` returns."
":c:func:`PyRun_StringFlags` と似ていますが、Pythonソースコードをメモリ内の文"
"字列ではなく *fp* から読み込みます。 *filename* はそのファイルの名前でなけれ"
"ばならず、 :term:`ファイルシステムのエンコーディングとエラーハンドラ "
"<filesystem encoding and error handler>` でデコードされます。 *closeit* に真"
"を指定した場合は、:c:func:`PyRun_FileExFlags` が処理を戻す前にファイルを閉じ"
#: ../../c-api/veryhigh.rst:229
"This is a simplified interface to :c:func:`Py_CompileStringFlags` below, "
"leaving *flags* set to ``NULL``."
"下記の :c:func:`Py_CompileStringFlags` の *flags* を ``NULL`` にして単純化し"
"たインターフェースです。"
#: ../../c-api/veryhigh.rst:235
"This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, "
"with *optimize* set to ``-1``."
"下記の :c:func:`Py_CompileStringExFlags` の *optimize* を ``-1`` にして単純化"
"したインターフェースです。"
#: ../../c-api/veryhigh.rst:241
"Parse and compile the Python source code in *str*, returning the resulting "
"code object.  The start symbol is given by *start*; this can be used to "
"constrain the code which can be compiled and should be :ref:`available start "
"symbols <start-symbols>`.  The filename specified by *filename* is used to "
"construct the code object and may appear in tracebacks or :exc:`SyntaxError` "
"exception messages.  This returns ``NULL`` if the code cannot be parsed or "
"compiled."
#: ../../c-api/veryhigh.rst:249
"The integer *optimize* specifies the optimization level of the compiler; a "
"value of ``-1`` selects the optimization level of the interpreter as given "
"by :option:`-O` options.  Explicit levels are ``0`` (no optimization; "
"``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false) "
"or ``2`` (docstrings are removed too)."
"整数 *optimize* は、コンパイラの最適化レベルを指定します;  ``-1`` は、インタ"
"プリタの :option:`-O` オプションで与えられるのと同じ最適化レベルを選びます。"
"明示的なレベルは、 ``0`` (最適化なし、 ``__debug__`` は真)、 ``1`` (assert は"
"取り除かれ、 ``__debug__`` は偽)、 ``2`` (docstring も取り除かれる) です。"
#: ../../c-api/veryhigh.rst:260
"Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string "
"decoded from the :term:`filesystem encoding and error handler`."
":c:func:`Py_CompileStringObject` と似ていますが、 *filename* は :term:`ファイ"
"ルシステムのエンコーディングとエラーハンドラ <filesystem encoding and error "
"handler>` でデコードされたバイト文字列です。"
#: ../../c-api/veryhigh.rst:267
"This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the "
"code object, and global and local variables.  The other arguments are set to "
"``NULL``."
":c:func:`PyEval_EvalCodeEx` のシンプルなインターフェースで、コードオブジェク"
"トと、グローバル変数とローカル変数だけを受け取ります。\n"
"他の引数には ``NULL`` が渡されます。"
#: ../../c-api/veryhigh.rst:274
"Evaluate a precompiled code object, given a particular environment for its "
"evaluation.  This environment consists of a dictionary of global variables, "
"a mapping object of local variables, arrays of arguments, keywords and "
"defaults, a dictionary of default values for :ref:`keyword-only <keyword-"
"only_parameter>` arguments and a closure tuple of cells."
"与えられた特定の環境で、コンパイル済みのコードオブジェクトを評価します。この"
"環境はグローバル変数の辞書と、ローカル変数のマッピングオブジェクト、引数の配"
"列、キーワードとデフォルト値、:ref:`キーワード専用 <keyword-only_parameter>` "
"引数のデフォルト値の辞書と、セルのクロージャタプルで構成されます。"
#: ../../c-api/veryhigh.rst:283
"Evaluate an execution frame.  This is a simplified interface to :c:func:"
"`PyEval_EvalFrameEx`, for backward compatibility."
"実行フレームを評価します。これは :c:func:`PyEval_EvalFrameEx` に対するシンプ"
"ルなインターフェースで、後方互換性のためのものです。"
#: ../../c-api/veryhigh.rst:289
"This is the main, unvarnished function of Python interpretation.  The code "
"object associated with the execution frame *f* is executed, interpreting "
"bytecode and executing calls as needed.  The additional *throwflag* "
"parameter can mostly be ignored - if true, then it causes an exception to "
"immediately be thrown; this is used for the :meth:`~generator.throw` methods "
"of generator objects."
"Python のインタープリタの主要な、直接的な関数です。実行フレーム *f* に関連付"
"けられたコードオブジェクトを実行します。 バイトコードを解釈して、必要に応じて"
"呼び出しを実行します。 追加の *throwflag* 引数はほとんど無視できます。 - も"
"し true なら、 すぐに例外を発生させます。これはジェネレータオブジェクトの :"
"meth:`~generator.throw` メソッドで利用されます。"
#: ../../c-api/veryhigh.rst:296
"This function now includes a debug assertion to help ensure that it does not "
"silently discard an active exception."
"アクティブな例外を黙って捨てないことを保証するのに便利なように、この関数はデ"
"バッグアサーションを含むようになりました。"
#: ../../c-api/veryhigh.rst:303
"This function changes the flags of the current evaluation frame, and returns "
"true on success, false on failure."
"現在の評価フレームのフラグを変更します。成功したら true を、失敗したら false "
#: ../../c-api/veryhigh.rst:309
"This is the structure used to hold compiler flags.  In cases where code is "
"only being compiled, it is passed as ``int flags``, and in cases where code "
"is being executed, it is passed as ``PyCompilerFlags *flags``.  In this "
"case, ``from __future__ import`` can modify *flags*."
"コンパイラフラグを収めておくための構造体です。コードをコンパイルするだけの場"
"合、この構造体が ``int flags`` として渡されます。コードを実行する場合には "
"``PyCompilerFlags *flags`` として渡されます。この場合、``from __future__ "
"import`` は *flags* の内容を変更できます。"
#: ../../c-api/veryhigh.rst:314
"Whenever ``PyCompilerFlags *flags`` is ``NULL``, :c:member:`~PyCompilerFlags."
"cf_flags` is treated as equal to ``0``, and any modification due to ``from "
"__future__ import`` is discarded."
#: ../../c-api/veryhigh.rst:320
msgid "Compiler flags."
msgstr "コンパイラフラグ。"
#: ../../c-api/veryhigh.rst:324
"*cf_feature_version* is the minor Python version. It should be initialized "
"to ``PY_MINOR_VERSION``."
#: ../../c-api/veryhigh.rst:327
"The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` "
"flag is set in :c:member:`~PyCompilerFlags.cf_flags`."
#: ../../c-api/veryhigh.rst:330
msgid "Added *cf_feature_version* field."
#: ../../c-api/veryhigh.rst:333
msgid "The available compiler flags are accessible as macros:"
#: ../../c-api/veryhigh.rst:342
"See :ref:`compiler flags <ast-compiler-flags>` in documentation of the :py:"
"mod:`!ast` Python module, which exports these constants under the same names."
#: ../../c-api/veryhigh.rst:347
msgid "Low-level flags"
#: ../../c-api/veryhigh.rst:348
"The following flags and masks serve narrow needs of the standard library and "
"interactive interpreters.  Code outside the standard library rarely has a "
"reason to use them.  They are considered implementation details and may "
"change at any time."
#: ../../c-api/veryhigh.rst:355
"This flag is a private interface between the compiler and the :mod:`codeop` "
"module.  Do not use it; its behavior is unsupported and may change without "
#: ../../c-api/veryhigh.rst:359
"With this flag set, when compilation fails because the source text ends "
"where more input is expected, for example in the middle of an indented block "
"or an unterminated string literal, the error raised is the undocumented "
"``_IncompleteInputError``, a subclass of :exc:`SyntaxError`.  The :mod:"
"`codeop` module sets this flag, together with :c:macro:"
"`PyCF_DONT_IMPLY_DEDENT`, to tell input that is incomplete apart from input "
"with a real syntax error, so that interactive interpreters know when to "
"prompt for another line instead of reporting an error."
#: ../../c-api/veryhigh.rst:373
"By default, when compiling with the :c:var:`Py_single_input` start symbol, "
"reaching the end of the source text implicitly closes any open indented "
"blocks.  With this flag set, open blocks are only closed if the last line of "
"the source ends with a newline; otherwise, compilation fails with a :exc:"
"`SyntaxError`:"
#: ../../c-api/veryhigh.rst:379
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"const char *source = \"if a:\\n    pass\";\n"
"/* The \"if\" block is closed implicitly;\n"
"   this returns a code object: */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);\n"
"/* With the flag, this fails with a SyntaxError,\n"
"   because the last line does not end with a newline: */\n"
"flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_single_input, &flags);"
#: ../../c-api/veryhigh.rst:396
"The :mod:`codeop` module uses this flag to detect incomplete interactive "
"input.  While the user is still typing inside an indented block, the source "
"does not yet end with a newline, so it fails to compile and the user is "
"prompted for another line."
#: ../../c-api/veryhigh.rst:403
"Read the source text as UTF-8, ignoring its :pep:`263` encoding declaration "
"(\"coding cookie\"), if any:"
#: ../../c-api/veryhigh.rst:406
"PyCompilerFlags flags = {\n"
"    .cf_flags = 0,\n"
"    .cf_feature_version = PY_MINOR_VERSION,\n"
"const char *source = \"# coding: latin-1\\ns = '\\xe9'\\n\";\n"
"/* The coding cookie is honored: byte 0xE9 is decoded as\n"
"   Latin-1, and this returns a code object that sets s to \"é\": */\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);\n"
"/* With the flag, the cookie is ignored and compilation fails\n"
"   with a SyntaxError, because 0xE9 is not valid UTF-8: */\n"
"flags.cf_flags = PyCF_IGNORE_COOKIE;\n"
"Py_CompileStringFlags(source, \"<input>\", Py_file_input, &flags);"
#: ../../c-api/veryhigh.rst:423
"The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set "
"this flag when the source is a :class:`str` object, because they pass the "
"text to the parser encoded as UTF-8."
#: ../../c-api/veryhigh.rst:429
"Mark the source text as known to be UTF-8 encoded. The :func:`compile`, :"
"func:`eval` and :func:`exec` built-in functions set this flag, but it "
"currently has no effect."
#: ../../c-api/veryhigh.rst:433
"The \"``PyCF``\" flags above can be combined with \"``CO_FUTURE``\" flags "
"such as :c:macro:`CO_FUTURE_ANNOTATIONS` to enable features normally "
"selectable using :ref:`future statements <future>`. See :ref:"
"`c_codeobject_flags` for a complete list."
#: ../../c-api/veryhigh.rst:438
msgid "The following masks combine several flags:"
#: ../../c-api/veryhigh.rst:442
"Bitmask of all ``CO_FUTURE`` flags (see :ref:`c_codeobject_flags`), which "
"select features normally enabled by :ref:`future statements <future>`. When "
"code compiled with a ``PyCompilerFlags *flags`` argument contains a ``from "
"__future__ import`` statement, the flag for the imported feature is added to "
"*flags*, so that code executed later in the same context inherits it."
#: ../../c-api/veryhigh.rst:452
"Do not use this mask in new code.  It is kept only so that old code passing "
"its flags to :func:`compile` keeps working."
#: ../../c-api/veryhigh.rst:455
"Bitmask of flags for obsolete future features that no longer have any effect."
#: ../../c-api/veryhigh.rst:460
"Bitmask of all ``PyCF`` flags that change how the source is compiled, such "
"as :c:macro:`PyCF_ONLY_AST`. The :func:`compile` built-in function uses this "
"mask to validate its *flags* argument."
#: ../../c-api/veryhigh.rst:469
msgid "Available start symbols"
#: ../../c-api/veryhigh.rst:476
"The start symbol from the Python grammar for isolated expressions; for use "
"with :c:func:`Py_CompileString`."
"単独の式に対するPython文法の開始記号で、 :c:func:`Py_CompileString` と一緒に"
#: ../../c-api/veryhigh.rst:484
"The start symbol from the Python grammar for sequences of statements as read "
"from a file or other source; for use with :c:func:`Py_CompileString`.  This "
"is the symbol to use when compiling arbitrarily long Python source code."
"ファイルあるいは他のソースから読み込まれた文の並びに対するPython文法の開始記"
"号で、 :c:func:`Py_CompileString` と一緒に使います。これは任意の長さのPython"
"ソースコードをコンパイルするときに使う記号です。"
#: ../../c-api/veryhigh.rst:493
"The start symbol from the Python grammar for a single statement; for use "
"with :c:func:`Py_CompileString`. This is the symbol used for the interactive "
"interpreter loop."
"単一の文に対するPython文法の開始記号で、 :c:func:`Py_CompileString` と一緒に"
"使います。これは対話式のインタプリタループのための記号です。"
#: ../../c-api/veryhigh.rst:502
"The start symbol from the Python grammar for a function type; for use with :"
"c:func:`Py_CompileString`. This is used to parse \"signature type comments\" "
"from :pep:`484`."
#: ../../c-api/veryhigh.rst:506
msgid "This requires the :c:macro:`PyCF_ONLY_AST` flag to be set."
#: ../../c-api/veryhigh.rst:509
msgid ":py:class:`ast.FunctionType`"
#: ../../c-api/veryhigh.rst:510
msgid ":pep:`484`"
#: ../../c-api/veryhigh.rst:516
msgid "Stack Effects"
#: ../../c-api/veryhigh.rst:519
msgid ":py:func:`dis.stack_effect`"
#: ../../c-api/veryhigh.rst:524
msgid "Sentinel value representing an invalid stack effect."
#: ../../c-api/veryhigh.rst:526
msgid "This is currently equivalent to ``INT_MAX``."
#: ../../c-api/veryhigh.rst:533
msgid "Compute the stack effect of *opcode* with argument *oparg*."
msgstr "*opcode* と引数 *oparg* がスタックに与える影響を計算します。"
#: ../../c-api/veryhigh.rst:535 ../../c-api/veryhigh.rst:549
"On success, this function returns the stack effect; on failure, this "
"returns :c:macro:`PY_INVALID_STACK_EFFECT`."
#: ../../c-api/veryhigh.rst:543
"Similar to :c:func:`PyCompile_OpcodeStackEffect`, but don't include the "
"stack effect of jumping if *jump* is zero."
#: ../../c-api/veryhigh.rst:546
"If *jump* is ``0``, this will not include the stack effect of jumping, but "
"if *jump* is ``1`` or ``-1``, this will include it."
#: ../../c-api/veryhigh.rst:474 ../../c-api/veryhigh.rst:482
#: ../../c-api/veryhigh.rst:491 ../../c-api/veryhigh.rst:500
msgid "Py_CompileString (C function)"
Navigation Menu

Uh oh!

Uh oh!

Uh oh!

Uh oh!

FilesExpand file tree

veryhigh.po

Latest commit

History

veryhigh.po

File metadata and controls
