@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.15\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2026-07-13 16:24 +0000\n "
14+ "POT-Creation-Date : 2026-07-19 14:48 +0000\n "
1515"PO-Revision-Date : 2025-09-16 00:00+0000\n "
1616"Last-Translator : python-doc bot, 2025\n "
1717"Language-Team : Japanese (https://app.transifex.com/python-doc/teams/5390/ "
@@ -505,27 +505,162 @@ msgid ""
505505"mod:`!ast` Python module, which exports these constants under the same names."
506506msgstr ""
507507
508- #: ../../c-api/veryhigh.rst:346
508+ #: ../../c-api/veryhigh.rst:347
509+ msgid "Low-level flags"
510+ msgstr ""
511+
512+ #: ../../c-api/veryhigh.rst:348
513+ msgid ""
514+ "The following flags and masks serve narrow needs of the standard library and "
515+ "interactive interpreters. Code outside the standard library rarely has a "
516+ "reason to use them. They are considered implementation details and may "
517+ "change at any time."
518+ msgstr ""
519+
520+ #: ../../c-api/veryhigh.rst:355
521+ msgid ""
522+ "This flag is a private interface between the compiler and the :mod:`codeop` "
523+ "module. Do not use it; its behavior is unsupported and may change without "
524+ "warning."
525+ msgstr ""
526+
527+ #: ../../c-api/veryhigh.rst:359
528+ msgid ""
529+ "With this flag set, when compilation fails because the source text ends "
530+ "where more input is expected, for example in the middle of an indented block "
531+ "or an unterminated string literal, the error raised is the undocumented "
532+ "``_IncompleteInputError``, a subclass of :exc:`SyntaxError`. The :mod:"
533+ "`codeop` module sets this flag, together with :c:macro:"
534+ "`PyCF_DONT_IMPLY_DEDENT`, to tell input that is incomplete apart from input "
535+ "with a real syntax error, so that interactive interpreters know when to "
536+ "prompt for another line instead of reporting an error."
537+ msgstr ""
538+
539+ #: ../../c-api/veryhigh.rst:373
540+ msgid ""
541+ "By default, when compiling with the :c:var:`Py_single_input` start symbol, "
542+ "reaching the end of the source text implicitly closes any open indented "
543+ "blocks. With this flag set, open blocks are only closed if the last line of "
544+ "the source ends with a newline; otherwise, compilation fails with a :exc:"
545+ "`SyntaxError`:"
546+ msgstr ""
547+
548+ #: ../../c-api/veryhigh.rst:379
549+ msgid ""
550+ "PyCompilerFlags flags = {\n"
551+ " .cf_flags = 0,\n"
552+ " .cf_feature_version = PY_MINOR_VERSION,\n"
553+ "};\n"
554+ "const char *source = \" if a:\\ n pass\" ;\n"
555+ "\n"
556+ "/* The \" if\" block is closed implicitly;\n"
557+ " this returns a code object: */\n"
558+ "Py_CompileStringFlags(source, \" <input>\" , Py_single_input, &flags);\n"
559+ "\n"
560+ "/* With the flag, this fails with a SyntaxError,\n"
561+ " because the last line does not end with a newline: */\n"
562+ "flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n"
563+ "Py_CompileStringFlags(source, \" <input>\" , Py_single_input, &flags);"
564+ msgstr ""
565+
566+ #: ../../c-api/veryhigh.rst:396
567+ msgid ""
568+ "The :mod:`codeop` module uses this flag to detect incomplete interactive "
569+ "input. While the user is still typing inside an indented block, the source "
570+ "does not yet end with a newline, so it fails to compile and the user is "
571+ "prompted for another line."
572+ msgstr ""
573+
574+ #: ../../c-api/veryhigh.rst:403
575+ msgid ""
576+ "Read the source text as UTF-8, ignoring its :pep:`263` encoding declaration "
577+ "(\" coding cookie\" ), if any:"
578+ msgstr ""
579+
580+ #: ../../c-api/veryhigh.rst:406
581+ msgid ""
582+ "PyCompilerFlags flags = {\n"
583+ " .cf_flags = 0,\n"
584+ " .cf_feature_version = PY_MINOR_VERSION,\n"
585+ "};\n"
586+ "const char *source = \" # coding: latin-1\\ ns = '\\ xe9'\\ n\" ;\n"
587+ "\n"
588+ "/* The coding cookie is honored: byte 0xE9 is decoded as\n"
589+ " Latin-1, and this returns a code object that sets s to \" é\" : */\n"
590+ "Py_CompileStringFlags(source, \" <input>\" , Py_file_input, &flags);\n"
591+ "\n"
592+ "/* With the flag, the cookie is ignored and compilation fails\n"
593+ " with a SyntaxError, because 0xE9 is not valid UTF-8: */\n"
594+ "flags.cf_flags = PyCF_IGNORE_COOKIE;\n"
595+ "Py_CompileStringFlags(source, \" <input>\" , Py_file_input, &flags);"
596+ msgstr ""
597+
598+ #: ../../c-api/veryhigh.rst:423
599+ msgid ""
600+ "The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set "
601+ "this flag when the source is a :class:`str` object, because they pass the "
602+ "text to the parser encoded as UTF-8."
603+ msgstr ""
604+
605+ #: ../../c-api/veryhigh.rst:429
606+ msgid ""
607+ "Mark the source text as known to be UTF-8 encoded. The :func:`compile`, :"
608+ "func:`eval` and :func:`exec` built-in functions set this flag, but it "
609+ "currently has no effect."
610+ msgstr ""
611+
612+ #: ../../c-api/veryhigh.rst:433
509613msgid ""
510614"The \" ``PyCF``\" flags above can be combined with \" ``CO_FUTURE``\" flags "
511615"such as :c:macro:`CO_FUTURE_ANNOTATIONS` to enable features normally "
512616"selectable using :ref:`future statements <future>`. See :ref:"
513617"`c_codeobject_flags` for a complete list."
514618msgstr ""
515619
516- #: ../../c-api/veryhigh.rst:355
620+ #: ../../c-api/veryhigh.rst:438
621+ msgid "The following masks combine several flags:"
622+ msgstr ""
623+
624+ #: ../../c-api/veryhigh.rst:442
625+ msgid ""
626+ "Bitmask of all ``CO_FUTURE`` flags (see :ref:`c_codeobject_flags`), which "
627+ "select features normally enabled by :ref:`future statements <future>`. When "
628+ "code compiled with a ``PyCompilerFlags *flags`` argument contains a ``from "
629+ "__future__ import`` statement, the flag for the imported feature is added to "
630+ "*flags*, so that code executed later in the same context inherits it."
631+ msgstr ""
632+
633+ #: ../../c-api/veryhigh.rst:452
634+ msgid ""
635+ "Do not use this mask in new code. It is kept only so that old code passing "
636+ "its flags to :func:`compile` keeps working."
637+ msgstr ""
638+
639+ #: ../../c-api/veryhigh.rst:455
640+ msgid ""
641+ "Bitmask of flags for obsolete future features that no longer have any effect."
642+ msgstr ""
643+
644+ #: ../../c-api/veryhigh.rst:460
645+ msgid ""
646+ "Bitmask of all ``PyCF`` flags that change how the source is compiled, such "
647+ "as :c:macro:`PyCF_ONLY_AST`. The :func:`compile` built-in function uses this "
648+ "mask to validate its *flags* argument."
649+ msgstr ""
650+
651+ #: ../../c-api/veryhigh.rst:469
517652msgid "Available start symbols"
518653msgstr ""
519654
520- #: ../../c-api/veryhigh.rst:362
655+ #: ../../c-api/veryhigh.rst:476
521656msgid ""
522657"The start symbol from the Python grammar for isolated expressions; for use "
523658"with :c:func:`Py_CompileString`."
524659msgstr ""
525660"単独の式に対するPython文法の開始記号で、 :c:func:`Py_CompileString` と一緒に"
526661"使います。"
527662
528- #: ../../c-api/veryhigh.rst:370
663+ #: ../../c-api/veryhigh.rst:484
529664msgid ""
530665"The start symbol from the Python grammar for sequences of statements as read "
531666"from a file or other source; for use with :c:func:`Py_CompileString`. This "
@@ -535,7 +670,7 @@ msgstr ""
535670"号で、 :c:func:`Py_CompileString` と一緒に使います。これは任意の長さのPython"
536671"ソースコードをコンパイルするときに使う記号です。"
537672
538- #: ../../c-api/veryhigh.rst:379
673+ #: ../../c-api/veryhigh.rst:493
539674msgid ""
540675"The start symbol from the Python grammar for a single statement; for use "
541676"with :c:func:`Py_CompileString`. This is the symbol used for the interactive "
@@ -544,64 +679,64 @@ msgstr ""
544679"単一の文に対するPython文法の開始記号で、 :c:func:`Py_CompileString` と一緒に"
545680"使います。これは対話式のインタプリタループのための記号です。"
546681
547- #: ../../c-api/veryhigh.rst:388
682+ #: ../../c-api/veryhigh.rst:502
548683msgid ""
549684"The start symbol from the Python grammar for a function type; for use with :"
550685"c:func:`Py_CompileString`. This is used to parse \" signature type comments\" "
551686"from :pep:`484`."
552687msgstr ""
553688
554- #: ../../c-api/veryhigh.rst:392
689+ #: ../../c-api/veryhigh.rst:506
555690msgid "This requires the :c:macro:`PyCF_ONLY_AST` flag to be set."
556691msgstr ""
557692
558- #: ../../c-api/veryhigh.rst:395
693+ #: ../../c-api/veryhigh.rst:509
559694msgid ":py:class:`ast.FunctionType`"
560695msgstr ""
561696
562- #: ../../c-api/veryhigh.rst:396
697+ #: ../../c-api/veryhigh.rst:510
563698msgid ":pep:`484`"
564699msgstr ""
565700
566- #: ../../c-api/veryhigh.rst:402
701+ #: ../../c-api/veryhigh.rst:516
567702msgid "Stack Effects"
568703msgstr ""
569704
570- #: ../../c-api/veryhigh.rst:405
705+ #: ../../c-api/veryhigh.rst:519
571706msgid ":py:func:`dis.stack_effect`"
572707msgstr ""
573708
574- #: ../../c-api/veryhigh.rst:410
709+ #: ../../c-api/veryhigh.rst:524
575710msgid "Sentinel value representing an invalid stack effect."
576711msgstr ""
577712
578- #: ../../c-api/veryhigh.rst:412
713+ #: ../../c-api/veryhigh.rst:526
579714msgid "This is currently equivalent to ``INT_MAX``."
580715msgstr ""
581716
582- #: ../../c-api/veryhigh.rst:419
717+ #: ../../c-api/veryhigh.rst:533
583718msgid "Compute the stack effect of *opcode* with argument *oparg*."
584719msgstr "*opcode* と引数 *oparg* がスタックに与える影響を計算します。"
585720
586- #: ../../c-api/veryhigh.rst:421 ../../c-api/veryhigh.rst:435
721+ #: ../../c-api/veryhigh.rst:535 ../../c-api/veryhigh.rst:549
587722msgid ""
588723"On success, this function returns the stack effect; on failure, this "
589724"returns :c:macro:`PY_INVALID_STACK_EFFECT`."
590725msgstr ""
591726
592- #: ../../c-api/veryhigh.rst:429
727+ #: ../../c-api/veryhigh.rst:543
593728msgid ""
594729"Similar to :c:func:`PyCompile_OpcodeStackEffect`, but don't include the "
595730"stack effect of jumping if *jump* is zero."
596731msgstr ""
597732
598- #: ../../c-api/veryhigh.rst:432
733+ #: ../../c-api/veryhigh.rst:546
599734msgid ""
600735"If *jump* is ``0``, this will not include the stack effect of jumping, but "
601736"if *jump* is ``1`` or ``-1``, this will include it."
602737msgstr ""
603738
604- #: ../../c-api/veryhigh.rst:360 ../../c-api/veryhigh.rst:368
605- #: ../../c-api/veryhigh.rst:377 ../../c-api/veryhigh.rst:386
739+ #: ../../c-api/veryhigh.rst:474 ../../c-api/veryhigh.rst:482
740+ #: ../../c-api/veryhigh.rst:491 ../../c-api/veryhigh.rst:500
606741msgid "Py_CompileString (C function)"
607742msgstr ""
0 commit comments