GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — python-docs-ja/extending/extending.po at 3.13 · python/python-docs-ja Expand file tree/ Copy pathextending.poMore file actions 2677 lines (2471 loc) · 129 KB / Copy pathextending.poFile metadata and controls2677 lines (2471 loc) · 129 KB 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 # 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: # Yusuke Miyazaki <[email protected]>, 2021 # mollinaca, 2021 # Shin Saito, 2021 # 菊池 健志, 2023 # tomo, 2023 # 石井明久, 2024 # Arihiro TAKASE, 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2025-05-09 14:19+0000\n" "PO-Revision-Date: 2021-06-28 00:51+0000\n" "Last-Translator: Arihiro TAKASE, 2024\n" "Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/" "ja/)\n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" #: ../../extending/extending.rst:8 msgid "Extending Python with C or C++" msgstr "C や C++ による Python の拡張" #: ../../extending/extending.rst:10 msgid "" "It is quite easy to add new built-in modules to Python, if you know how to " "program in C. Such :dfn:`extension modules` can do two things that can't be " "done directly in Python: they can implement new built-in object types, and " "they can call C library functions and system calls." msgstr "" "C プログラムの書き方を知っているなら、Python に新たな組み込みモジュールを追加" "するのはきわめて簡単です。この新たなモジュール、拡張モジュール " "(:dfn:`extension module`) を使うと、Python が直接行えない二つのこと: 新しい組" "み込みオブジェクトの実装、そして全ての C ライブラリ関数とシステムコールに対す" "る呼び出し、ができるようになります。" #: ../../extending/extending.rst:15 msgid "" "To support extensions, the Python API (Application Programmers Interface) " "defines a set of functions, macros and variables that provide access to most " "aspects of the Python run-time system. The Python API is incorporated in a " "C source file by including the header ``\"Python.h\"``." msgstr "" "拡張モジュールをサポートするため、Python API (Application Programmer's " "Interface) では一連の関数、マクロおよび変数を提供していて、Python ランタイム" "システムのほとんどの側面へのアクセス手段を提供しています。 Python API は、" "ヘッダ ``\"Python.h\"`` をインクルードして C ソースに取り込みます。" #: ../../extending/extending.rst:20 msgid "" "The compilation of an extension module depends on its intended use as well " "as on your system setup; details are given in later chapters." msgstr "" "拡張モジュールのコンパイル方法は、モジュールの用途やシステムの設定方法に依存" "します。詳細は後の章で説明します。" #: ../../extending/extending.rst:25 msgid "" "The C extension interface is specific to CPython, and extension modules do " "not work on other Python implementations. In many cases, it is possible to " "avoid writing C extensions and preserve portability to other " "implementations. For example, if your use case is calling C library " "functions or system calls, you should consider using the :mod:`ctypes` " "module or the `cffi <https://cffi.readthedocs.io/>`_ library rather than " "writing custom C code. These modules let you write Python code to interface " "with C code and are more portable between implementations of Python than " "writing and compiling a C extension module." msgstr "" "C 拡張のインターフェイスは CPython に固有のものであり、これによる拡張モジュー" "ルはほかの Python 実装では動作しません。多くの場合、C 拡張を書くことを避けて" "ほかの Python 実装のために移植性を確保することは可能です。たとえば、あなたが" "したいことが C ライブラリの関数やシステムコールを呼び出すことである場" "合、 :mod:`ctypes` あるいは `cffi <https://cffi.readthedocs.io/>`_ ライブラリ" "の利用を検討すべきです。これらのモジュールは C コードとインターフェイスし、C " "拡張を書いてコンパイルするのに較べて Python 実装間のより高い移植性をもった " "Python コードを書かせてくれます。" #: ../../extending/extending.rst:40 msgid "A Simple Example" msgstr "簡単な例" #: ../../extending/extending.rst:42 msgid "" "Let's create an extension module called ``spam`` (the favorite food of Monty " "Python fans...) and let's say we want to create a Python interface to the C " "library function :c:func:`system` [#]_. This function takes a null-" "terminated character string as argument and returns an integer. We want " "this function to be callable from Python as follows:" msgstr "" "``spam`` (Monty Python ファンの好物ですね) という名の拡張モジュールを作成する" "ことにして、C ライブラリ関数 :c:func:`system` に対する Python インターフェイ" "スを作成したいとします。 [#]_ この関数は null で終端されたキャラクタ文字列を" "引数にとり、整数を返します。この関数を以下のようにして Python から呼び出せる" "ようにしたいとします。" #: ../../extending/extending.rst:48 msgid "" ">>> import spam\n" ">>> status = spam.system(\"ls -l\")" msgstr "" #: ../../extending/extending.rst:53 msgid "" "Begin by creating a file :file:`spammodule.c`. (Historically, if a module " "is called ``spam``, the C file containing its implementation is " "called :file:`spammodule.c`; if the module name is very long, like " "``spammify``, the module name can be just :file:`spammify.c`.)" msgstr "" "まずは :file:`spammodule.c` を作成するところから始めます。 (伝統として、 " "``spam`` という名前のモジュールを作成する場合、モジュールの実装が入った C " "ファイルを :file:`spammodule.c` と呼ぶことになっています; ``spammify`` のよう" "に長すぎるモジュール名の場合には、単に :file:`spammify.c` にもできます。)" #: ../../extending/extending.rst:58 msgid "The first two lines of our file can be::" msgstr "このファイルの最初の 2 行は以下のようにします::" #: ../../extending/extending.rst:60 ../../extending/extending.rst:663 msgid "" "#define PY_SSIZE_T_CLEAN\n" "#include <Python.h>" msgstr "" "#define PY_SSIZE_T_CLEAN\n" "#include <Python.h>" #: ../../extending/extending.rst:63 msgid "" "which pulls in the Python API (you can add a comment describing the purpose " "of the module and a copyright notice if you like)." msgstr "" "これで、Python API を取り込みます (必要なら、モジュールの用途に関する説明や、" "著作権表示を追加します)。" #: ../../extending/extending.rst:68 msgid "" "Since Python may define some pre-processor definitions which affect the " "standard headers on some systems, you *must* include :file:`Python.h` before " "any standard headers are included." msgstr "" "Python は、システムによっては標準ヘッダの定義に影響するようなプリプロセッサ定" "義を行っているので、 :file:`Python.h` をいずれの標準ヘッダよりも前にインク" "ルード *せねばなりません* 。" #: ../../extending/extending.rst:72 msgid "" "``#define PY_SSIZE_T_CLEAN`` was used to indicate that ``Py_ssize_t`` should " "be used in some APIs instead of ``int``. It is not necessary since Python " "3.13, but we keep it here for backward compatibility. See :ref:`arg-parsing-" "string-and-buffers` for a description of this macro." msgstr "" "``#define PY_SSIZE_T_CLEAN`` は、いくつかの API では ``int`` の代わりに " "``Py_ssize_t`` が使われるべきであることを示すために使われていました。これは " "Python 3.13 以降では不要となりましたが、後方互換性のために維持されています。" "このマクロの説明は :ref:`arg-parsing-string-and-buffers` にあります。" #: ../../extending/extending.rst:77 msgid "" "All user-visible symbols defined by :file:`Python.h` have a prefix of ``Py`` " "or ``PY``, except those defined in standard header files. For convenience, " "and since they are used extensively by the Python interpreter, " "``\"Python.h\"`` includes a few standard header files: ``<stdio.h>``, " "``<string.h>``, ``<errno.h>``, and ``<stdlib.h>``. If the latter header " "file does not exist on your system, it declares the " "functions :c:func:`malloc`, :c:func:`free` and :c:func:`realloc` directly." msgstr "" ":file:`Python.h` で定義されているユーザから可視のシンボルは、全て接頭辞 " "``Py`` または ``PY`` が付いています。ただし、標準ヘッダファイル内の定義は除き" "ます。簡単のためと、Python 内で広範に使うことになるという理由から、 " "``\"Python.h\"`` はいくつかの標準ヘッダファイル: ``<stdio.h>`` 、 " "``<string.h>`` 、 ``<errno.h>`` 、および ``<stdlib.h>`` をインクルードしてい" "ます。後者のヘッダファイルがシステム上になければ、 ``\"Python.h\"`` が関" "数 :c:func:`malloc` 、 :c:func:`free` および :c:func:`realloc` を直接定義しま" "す。" #: ../../extending/extending.rst:85 msgid "" "The next thing we add to our module file is the C function that will be " "called when the Python expression ``spam.system(string)`` is evaluated " "(we'll see shortly how it ends up being called)::" msgstr "" "次にファイルに追加する内容は、Python 式 ``spam.system(string)`` を評価する際" "に呼び出されることになる C 関数です (この関数を最終的にどのように呼び出すか" "は、後ですぐわかります)::" #: ../../extending/extending.rst:89 msgid "" "static PyObject *\n" "spam_system(PyObject *self, PyObject *args)\n" "{\n" " const char *command;\n" " int sts;\n" "\n" " if (!PyArg_ParseTuple(args, \"s\", &command))\n" " return NULL;\n" " sts = system(command);\n" " return PyLong_FromLong(sts);\n" "}" msgstr "" #: ../../extending/extending.rst:101 msgid "" "There is a straightforward translation from the argument list in Python (for " "example, the single expression ``\"ls -l\"``) to the arguments passed to the " "C function. The C function always has two arguments, conventionally named " "*self* and *args*." msgstr "" "ここでは、Python の引数リスト (例えば、単一の式 ``\"ls -l\"``) から C 関数に" "渡す引数にそのまま変換しています。 C 関数は常に二つの引数を持ち、便宜的に " "*self* および *args* と呼ばれます。" #: ../../extending/extending.rst:106 msgid "" "The *self* argument points to the module object for module-level functions; " "for a method it would point to the object instance." msgstr "" "*self* 引数には、モジュールレベルの関数であればモジュールが、メソッドにはオブ" "ジェクトインスタンスが渡されます。" #: ../../extending/extending.rst:109 msgid "" "The *args* argument will be a pointer to a Python tuple object containing " "the arguments. Each item of the tuple corresponds to an argument in the " "call's argument list. The arguments are Python objects --- in order to do " "anything with them in our C function we have to convert them to C values. " "The function :c:func:`PyArg_ParseTuple` in the Python API checks the " "argument types and converts them to C values. It uses a template string to " "determine the required types of the arguments as well as the types of the C " "variables into which to store the converted values. More about this later." msgstr "" "*args* 引数は、引数の入った Python タプルオブジェクトへのポインタになります。" "タプル内の各要素は、呼び出しの際の引数リストにおける各引数に対応します。引数" "は Python オブジェクトです --- C 関数で引数を使って何かを行うには、オブジェク" "トから C の値に変換せねばなりません。Python API の関" "数 :c:func:`PyArg_ParseTuple` は引数の型をチェックし、C の値に変換しま" "す。 :c:func:`PyArg_ParseTuple` はテンプレート文字列を使って、引数オブジェク" "トの型と、変換された値を入れる C 変数の型を判別します。これについては後で詳し" "く説明します。" #: ../../extending/extending.rst:118 msgid "" ":c:func:`PyArg_ParseTuple` returns true (nonzero) if all arguments have the " "right type and its components have been stored in the variables whose " "addresses are passed. It returns false (zero) if an invalid argument list " "was passed. In the latter case it also raises an appropriate exception so " "the calling function can return ``NULL`` immediately (as we saw in the " "example)." msgstr "" ":c:func:`PyArg_ParseTuple` は、全ての引数が正しい型を持っていて、アドレス渡し" "された各変数に各引数要素を保存したときに真 (非ゼロ) を返します。この関数は不" "正な引数リストを渡すと偽 (ゼロ) を返します。後者の場合、関数は適切な例外を送" "出するので、呼び出し側は (例にもあるように) すぐに ``NULL`` を返すようにして" "ください。" #: ../../extending/extending.rst:128 msgid "Intermezzo: Errors and Exceptions" msgstr "幕間小話: エラーと例外" #: ../../extending/extending.rst:130 msgid "" "An important convention throughout the Python interpreter is the following: " "when a function fails, it should set an exception condition and return an " "error value (usually ``-1`` or a ``NULL`` pointer). Exception information " "is stored in three members of the interpreter's thread state. These are " "``NULL`` if there is no exception. Otherwise they are the C equivalents of " "the members of the Python tuple returned by :meth:`sys.exc_info`. These are " "the exception type, exception instance, and a traceback object. It is " "important to know about them to understand how errors are passed around." msgstr "" #: ../../extending/extending.rst:139 msgid "" "The Python API defines a number of functions to set various types of " "exceptions." msgstr "" "Python API では、様々な型の例外をセットするための関数をいくつか定義していま" "す。" #: ../../extending/extending.rst:141 msgid "" "The most common one is :c:func:`PyErr_SetString`. Its arguments are an " "exception object and a C string. The exception object is usually a " "predefined object like :c:data:`PyExc_ZeroDivisionError`. The C string " "indicates the cause of the error and is converted to a Python string object " "and stored as the \"associated value\" of the exception." msgstr "" "もっともよく用いられるのは :c:func:`PyErr_SetString` です。引数は例外オブジェ" "クトと C 文字列です。例外オブジェクトは通" "常、 :c:data:`PyExc_ZeroDivisionError` のような定義済みのオブジェクトです。 " "C 文字列はエラーの原因を示し、Python 文字列オブジェクトに変換されて例外の " "\"付属値\" に保存されます。" #: ../../extending/extending.rst:147 msgid "" "Another useful function is :c:func:`PyErr_SetFromErrno`, which only takes an " "exception argument and constructs the associated value by inspection of the " "global variable :c:data:`errno`. The most general function " "is :c:func:`PyErr_SetObject`, which takes two object arguments, the " "exception and its associated value. You don't need to :c:func:`Py_INCREF` " "the objects passed to any of these functions." msgstr "" "もう一つ有用な関数として :c:func:`PyErr_SetFromErrno` があります。この関数は" "引数に例外だけをとり、付属値はグローバル変数 :c:data:`errno` から構築します。" "もっとも汎用的な関数は :c:func:`PyErr_SetObject` で、二つのオブジェクト、例外" "と付属値を引数にとります。これら関数に渡すオブジェクトに" "は :c:func:`Py_INCREF` を使う必要はありません。" #: ../../extending/extending.rst:154 msgid "" "You can test non-destructively whether an exception has been set " "with :c:func:`PyErr_Occurred`. This returns the current exception object, " "or ``NULL`` if no exception has occurred. You normally don't need to " "call :c:func:`PyErr_Occurred` to see whether an error occurred in a function " "call, since you should be able to tell from the return value." msgstr "" "例外がセットされているかどうかは、 :c:func:`PyErr_Occurred` を使って非破壊的" "に調べられます。この関数は現在の例外オブジェクトを返します。例外が発生してい" "ない場合には ``NULL`` を返します。通常は、関数の戻り値からエラーが発生したか" "を判別できるはずなので、 :c:func:`PyErr_Occurred` を呼び出す必要はありませ" "ん。" msgid "" "When a function *f* that calls another function *g* detects that the latter " "fails, *f* should itself return an error value (usually ``NULL`` or " "``-1``). It should *not* call one of the ``PyErr_*`` functions --- one has " "already been called by *g*. *f*'s caller is then supposed to also return an " "error indication to *its* caller, again *without* calling ``PyErr_*``, and " "so on --- the most detailed cause of the error was already reported by the " "function that first detected it. Once the error reaches the Python " "interpreter's main loop, this aborts the currently executing Python code and " "tries to find an exception handler specified by the Python programmer." msgstr "" "別の関数 *g* を呼び出した関数 *f* が、その呼び出しの失敗を検出した場合、*f* " "自身もエラー値 (通常は ``NULL`` または ``-1``) を返す必要があります。\n" "このとき ``PyErr_*`` 関数を呼び出しては *いけません*。\n" "*g* がすでに呼び出しているからです。\n" "次に *f* の呼び出し元も、``PyErr_*`` を *呼び出さずに*、*その呼び出し元* へエ" "ラーを示す値を返します。\n" "以下同様に続きます。\n" "エラーの最も詳しい原因は、最初にエラーを検出した関数がすでに報告していま" "す。\n" "エラーが Python インタープリタのメインループに到達すると、実行中の Python " "コードの処理を中断し、Python プログラマーが指定した例外ハンドラーを探します。" msgid "" "(There are situations where a module can actually give a more detailed error " "message by calling another ``PyErr_*`` function, and in such cases it is " "fine to do so. As a general rule, however, this is not necessary, and can " "cause information about the cause of the error to be lost: most operations " "can fail for a variety of reasons.)" msgstr "" "(別の ``PyErr_*`` 関数を呼び出すことで、モジュールがより詳しいエラーメッセー" "ジを提供できる場合は、そうしても構いません。\n" "ただし、一般には不要であり、エラーの原因に関する情報が失われるおそれがありま" "す。\n" "ほとんどの操作は様々な理由で失敗し得るためです。)" #: ../../extending/extending.rst:176 msgid "" "To ignore an exception set by a function call that failed, the exception " "condition must be cleared explicitly by calling :c:func:`PyErr_Clear`. The " "only time C code should call :c:func:`PyErr_Clear` is if it doesn't want to " "pass the error on to the interpreter but wants to handle it completely by " "itself (possibly by trying something else, or pretending nothing went wrong)." msgstr "" "ある関数呼び出しでの処理の失敗によってセットされた例外を無視するに" "は、 :c:func:`PyErr_Clear` を呼び出して例外状態を明示的に消去しなくてはなりま" "せん。エラーをインタプリタには渡したくなく、自前で (何か他の作業を行ったり、" "何も起こらなかったかのように見せかけるような) エラー処理を完全に行う場合にの" "み、 :c:func:`PyErr_Clear` を呼び出すようにすべきです。" #: ../../extending/extending.rst:182 msgid "" "Every failing :c:func:`malloc` call must be turned into an exception --- the " "direct caller of :c:func:`malloc` (or :c:func:`realloc`) must " "call :c:func:`PyErr_NoMemory` and return a failure indicator itself. All " "the object-creating functions (for example, :c:func:`PyLong_FromLong`) " "already do this, so this note is only relevant to those who " "call :c:func:`malloc` directly." msgstr "" ":c:func:`malloc` の呼び出し失敗は、常に例外にしなくてはなりません " "--- :c:func:`malloc` (または :c:func:`realloc`) を直接呼び出しているコード" "は、 :c:func:`PyErr_NoMemory` を呼び出して、失敗を示す値を返さねばなりませ" "ん。オブジェクトを生成する全ての関数 (例えば :c:func:`PyLong_FromLong`) は " "``PyErr_NoMemory()`` の呼び出しを済ませてしまうので、この規則が関係するのは直" "接 :c:func:`malloc` を呼び出すコードだけです。" msgid "" "Also note that, with the important exception of :c:func:`PyArg_ParseTuple` " "and friends, functions that return an integer status usually return a " "positive value or zero for success and ``-1`` for failure, like Unix system " "calls." msgstr "" "また、:c:func:`PyArg_ParseTuple` などの重要な例外を除き、整数の状態コードを返" "す関数は通常、Unix のシステムコールと同じく、成功時に正の値またはゼロを返し、" "失敗時に ``-1`` を返します。" #: ../../extending/extending.rst:192 msgid "" "Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` " "or :c:func:`Py_DECREF` calls for objects you have already created) when you " "return an error indicator!" msgstr "" "最後に、エラー標示値を返す際に、(エラーが発生するまでに既に生成してしまったオ" "ブジェクトに対して :c:func:`Py_XDECREF` や :c:func:`Py_DECREF` を呼び出して) " "ごみ処理を注意深く行ってください!" msgid "" "The choice of which exception to raise is entirely yours. There are " "predeclared C objects corresponding to all built-in Python exceptions, such " "as :c:data:`PyExc_ZeroDivisionError`, which you can use directly. Of course, " "you should choose exceptions wisely --- don't use :c:data:`PyExc_TypeError` " "to mean that a file couldn't be opened (that should probably " "be :c:data:`PyExc_OSError`). If something's wrong with the argument list, " "the :c:func:`PyArg_ParseTuple` function usually " "raises :c:data:`PyExc_TypeError`. If you have an argument whose value must " "be in a particular range or must satisfy other " "conditions, :c:data:`PyExc_ValueError` is appropriate." msgstr "" "どの例外を送出するかは自由に選べます。\n" ":c:data:`PyExc_ZeroDivisionError` など、Python のすべての組み込み例外に対応す" "る C オブジェクトが宣言済みで、そのまま利用できます。\n" "もちろん、例外は適切に選ぶ必要があります。\n" "例えば、ファイルを開けなかったことを示すために :c:data:`PyExc_TypeError` を使" "うべきではありません (おそらく :c:data:`PyExc_OSError` が適切です)。\n" "引数リストに問題がある場合、:c:func:`PyArg_ParseTuple` 関数は通" "常 :c:data:`PyExc_TypeError` を送出します。\n" "引数の値が特定の範囲内でなければならない場合や、その他の条件を満たす必要があ" "る場合は、:c:data:`PyExc_ValueError` が適切です。" #: ../../extending/extending.rst:206 msgid "" "You can also define a new exception that is unique to your module. For this, " "you usually declare a static object variable at the beginning of your file::" msgstr "" "モジュール固有の新たな例外も定義できます。定義するには、通常はファイルの先頭" "部分に静的なオブジェクト変数の宣言を行います::" #: ../../extending/extending.rst:209 msgid "static PyObject *SpamError;" msgstr "" #: ../../extending/extending.rst:211 msgid "" "and initialize it in your module's initialization function (:c:func:`!" "PyInit_spam`) with an exception object::" msgstr "" #: ../../extending/extending.rst:214 msgid "" "PyMODINIT_FUNC\n" "PyInit_spam(void)\n" "{\n" " PyObject *m;\n" "\n" " m = PyModule_Create(&spammodule);\n" " if (m == NULL)\n" " return NULL;\n" "\n" " SpamError = PyErr_NewException(\"spam.error\", NULL, NULL);\n" " if (PyModule_AddObjectRef(m, \"error\", SpamError) < 0) {\n" " Py_CLEAR(SpamError);\n" " Py_DECREF(m);\n" " return NULL;\n" " }\n" "\n" " return m;\n" "}" msgstr "" msgid "" "Note that the Python name for the exception object is :exc:`!spam.error`. " "The :c:func:`PyErr_NewException` function may create a class with the base " "class being :exc:`Exception` (unless another class is passed in instead of " "``NULL``), described in :ref:`bltin-exceptions`." msgstr "" "例外オブジェクトの Python での名前は :exc:`!spam.error` であることに注意して" "ください。\n" ":c:func:`PyErr_NewException` 関数は、``NULL`` の代わりに別のクラスを渡さなけ" "れば、:ref:`bltin-exceptions` で説明する :exc:`Exception` を基底クラスとする" "クラスを作成できます。" msgid "" "Note also that the :c:data:`!SpamError` variable retains a reference to the " "newly created exception class; this is intentional! Since the exception " "could be removed from the module by external code, an owned reference to the " "class is needed to ensure that it will not be discarded, causing :c:data:`!" "SpamError` to become a dangling pointer. Should it become a dangling " "pointer, C code which raises the exception could cause a core dump or other " "unintended side effects." msgstr "" ":c:data:`!SpamError` 変数が新しく作成した例外クラスへの参照を保持している点に" "も注意してください。\n" "これは意図的なものです。\n" "外部のコードがモジュールから例外を削除する可能性があるため、クラスへの参照を" "所有しておく必要があります。\n" "そうすることで、クラスが破棄されて :c:data:`!SpamError` がダングリングポイン" "ターになるのを防ぎます。\n" "ダングリングポインターになると、その例外を送出する C コードがコアダンプなどの" "意図しない副作用を引き起こすおそれがあります。" #: ../../extending/extending.rst:245 msgid "" "We discuss the use of :c:macro:`PyMODINIT_FUNC` as a function return type " "later in this sample." msgstr "" msgid "" "The :exc:`!spam.error` exception can be raised in your extension module " "using a call to :c:func:`PyErr_SetString` as shown below::" msgstr "" "次のように :c:func:`PyErr_SetString` を呼び出すと、拡張モジュールから :exc:`!" "spam.error` 例外を送出できます。 ::" msgid "" "static PyObject *\n" "spam_system(PyObject *self, PyObject *args)\n" "{\n" " const char *command;\n" " int sts;\n" "\n" " if (!PyArg_ParseTuple(args, \"s\", &command))\n" " return NULL;\n" " sts = system(command);\n" " if (sts < 0) {\n" " PyErr_SetString(SpamError, \"System command failed\");\n" " return NULL;\n" " }\n" " return PyLong_FromLong(sts);\n" "}" msgstr "" "static PyObject *\n" "spam_system(PyObject *self, PyObject *args)\n" "{\n" " const char *command;\n" " int sts;\n" "\n" " if (!PyArg_ParseTuple(args, \"s\", &command))\n" " return NULL;\n" " sts = system(command);\n" " if (sts < 0) {\n" " PyErr_SetString(SpamError, \"System command failed\");\n" " return NULL;\n" " }\n" " return PyLong_FromLong(sts);\n" "}" #: ../../extending/extending.rst:271 msgid "Back to the Example" msgstr "例に戻る" #: ../../extending/extending.rst:273 msgid "" "Going back to our example function, you should now be able to understand " "this statement::" msgstr "先ほどの関数の例に戻ると、今度は以下の実行文を理解できるはずです::" #: ../../extending/extending.rst:276 msgid "" "if (!PyArg_ParseTuple(args, \"s\", &command))\n" " return NULL;" msgstr "" #: ../../extending/extending.rst:279 msgid "" "It returns ``NULL`` (the error indicator for functions returning object " "pointers) if an error is detected in the argument list, relying on the " "exception set by :c:func:`PyArg_ParseTuple`. Otherwise the string value of " "the argument has been copied to the local variable :c:data:`!command`. This " "is a pointer assignment and you are not supposed to modify the string to " "which it points (so in Standard C, the variable :c:data:`!command` should " "properly be declared as ``const char *command``)." msgstr "" #: ../../extending/extending.rst:287 msgid "" "The next statement is a call to the Unix function :c:func:`system`, passing " "it the string we just got from :c:func:`PyArg_ParseTuple`::" msgstr "" "次の文では、 :c:func:`PyArg_ParseTuple` で得た文字列を渡して Unix 関" "数 :c:func:`system` を呼び出しています::" #: ../../extending/extending.rst:290 msgid "sts = system(command);" msgstr "" #: ../../extending/extending.rst:292 msgid "" "Our :func:`!spam.system` function must return the value of :c:data:`!sts` as " "a Python object. This is done using the " "function :c:func:`PyLong_FromLong`. ::" msgstr "" #: ../../extending/extending.rst:295 msgid "return PyLong_FromLong(sts);" msgstr "" #: ../../extending/extending.rst:297 msgid "" "In this case, it will return an integer object. (Yes, even integers are " "objects on the heap in Python!)" msgstr "" "上の場合では、整数オブジェクトを返します。(そう、整数ですら、 Python において" "はヒープ上のオブジェクトなのです! )" #: ../../extending/extending.rst:300 msgid "" "If you have a C function that returns no useful argument (a function " "returning :c:expr:`void`), the corresponding Python function must return " "``None``. You need this idiom to do so (which is implemented by " "the :c:macro:`Py_RETURN_NONE` macro)::" msgstr "" "何ら有用な値を返さない関数 (:c:expr:`void` を返す関数) に対応する Python の関" "数は ``None`` を返さねばなりません。関数に ``None`` を返させるには、以下のよ" "うな慣用句を使います (この慣用句は :c:macro:`Py_RETURN_NONE` マクロに実装され" "ています)::" #: ../../extending/extending.rst:305 msgid "" "Py_INCREF(Py_None);\n" "return Py_None;" msgstr "" #: ../../extending/extending.rst:308 msgid "" ":c:data:`Py_None` is the C name for the special Python object ``None``. It " "is a genuine Python object rather than a ``NULL`` pointer, which means " "\"error\" in most contexts, as we have seen." msgstr "" ":c:data:`Py_None` は特殊な Pyhton オブジェクトである ``None`` に対応する C で" "の名前です。これまで見てきたようにほとんどのコンテキストで \"エラー\" を意味" "する ``NULL`` ポインタとは違い、 ``None`` は純粋な Python のオブジェクトで" "す。" #: ../../extending/extending.rst:316 msgid "The Module's Method Table and Initialization Function" msgstr "モジュールのメソッドテーブルと初期化関数" #: ../../extending/extending.rst:318 msgid "" "I promised to show how :c:func:`!spam_system` is called from Python " "programs. First, we need to list its name and address in a \"method table\"::" msgstr "" #: ../../extending/extending.rst:321 msgid "" "static PyMethodDef SpamMethods[] = {\n" " ...\n" " {\"system\", spam_system, METH_VARARGS,\n" " \"Execute a shell command.\"},\n" " ...\n" " {NULL, NULL, 0, NULL} /* Sentinel */\n" "};" msgstr "" #: ../../extending/extending.rst:329 msgid "" "Note the third entry (``METH_VARARGS``). This is a flag telling the " "interpreter the calling convention to be used for the C function. It should " "normally always be ``METH_VARARGS`` or ``METH_VARARGS | METH_KEYWORDS``; a " "value of ``0`` means that an obsolete variant of :c:func:`PyArg_ParseTuple` " "is used." msgstr "" "リスト要素の三つ目のエントリ (``METH_VARARGS``) に注意してください。このエン" "トリは、C 関数が使う呼び出し規約をインタプリタに教えるためのフラグです。通常" "この値は ``METH_VARARGS`` か ``METH_VARARGS | METH_KEYWORDS`` のはずです; " "``0`` は旧式の :c:func:`PyArg_ParseTuple` の変化形が使われることを意味しま" "す。" #: ../../extending/extending.rst:334 msgid "" "When using only ``METH_VARARGS``, the function should expect the Python-" "level parameters to be passed in as a tuple acceptable for parsing " "via :c:func:`PyArg_ParseTuple`; more information on this function is " "provided below." msgstr "" "``METH_VARARGS`` だけを使う場合、C 関数は、Python レベルでの引数" "が :c:func:`PyArg_ParseTuple` が受理できるタプルの形式で渡されるものと想定し" "なければなりません; この関数についての詳細は下で説明します。" #: ../../extending/extending.rst:338 msgid "" "The :c:macro:`METH_KEYWORDS` bit may be set in the third field if keyword " "arguments should be passed to the function. In this case, the C function " "should accept a third ``PyObject *`` parameter which will be a dictionary of " "keywords. Use :c:func:`PyArg_ParseTupleAndKeywords` to parse the arguments " "to such a function." msgstr "" #: ../../extending/extending.rst:344 msgid "" "The method table must be referenced in the module definition structure::" msgstr "" "メソッドテーブルはモジュール定義の構造体から参照されていなければなりません::" #: ../../extending/extending.rst:346 msgid "" "static struct PyModuleDef spammodule = {\n" " PyModuleDef_HEAD_INIT,\n" " \"spam\", /* name of module */\n" " spam_doc, /* module documentation, may be NULL */\n" " -1, /* size of per-interpreter state of the module,\n" " or -1 if the module keeps state in global variables. */\n" " SpamMethods\n" "};" msgstr "" #: ../../extending/extending.rst:355 msgid "" "This structure, in turn, must be passed to the interpreter in the module's " "initialization function. The initialization function must be " "named :c:func:`!PyInit_name`, where *name* is the name of the module, and " "should be the only non-\\ ``static`` item defined in the module file::" msgstr "" #: ../../extending/extending.rst:360 msgid "" "PyMODINIT_FUNC\n" "PyInit_spam(void)\n" "{\n" " return PyModule_Create(&spammodule);\n" "}" msgstr "" #: ../../extending/extending.rst:366 msgid "" "Note that :c:macro:`PyMODINIT_FUNC` declares the function as ``PyObject *`` " "return type, declares any special linkage declarations required by the " "platform, and for C++ declares the function as ``extern \"C\"``." msgstr "" #: ../../extending/extending.rst:370 msgid "" "When the Python program imports module :mod:`!spam` for the first " "time, :c:func:`!PyInit_spam` is called. (See below for comments about " "embedding Python.) It calls :c:func:`PyModule_Create`, which returns a " "module object, and inserts built-in function objects into the newly created " "module based upon the table (an array of :c:type:`PyMethodDef` structures) " "found in the module definition. :c:func:`PyModule_Create` returns a pointer " "to the module object that it creates. It may abort with a fatal error for " "certain errors, or return ``NULL`` if the module could not be initialized " "satisfactorily. The init function must return the module object to its " "caller, so that it then gets inserted into ``sys.modules``." msgstr "" #: ../../extending/extending.rst:381 msgid "" "When embedding Python, the :c:func:`!PyInit_spam` function is not called " "automatically unless there's an entry in the :c:data:`PyImport_Inittab` " "table. To add the module to the initialization table, " "use :c:func:`PyImport_AppendInittab`, optionally followed by an import of " "the module::" msgstr "" #: ../../extending/extending.rst:386 msgid "" "#define PY_SSIZE_T_CLEAN\n" "#include <Python.h>\n" "\n" "int\n" "main(int argc, char *argv[])\n" "{\n" " PyStatus status;\n" " PyConfig config;\n" " PyConfig_InitPythonConfig(&config);\n" "\n" " /* Add a built-in module, before Py_Initialize */\n" " if (PyImport_AppendInittab(\"spam\", PyInit_spam) == -1) {\n" " fprintf(stderr, \"Error: could not extend in-built modules " "table\\n\");\n" " exit(1);\n" " }\n" "\n" " /* Pass argv[0] to the Python interpreter */\n" " status = PyConfig_SetBytesString(&config, &config.program_name, " "argv[0]);\n" " if (PyStatus_Exception(status)) {\n" " goto exception;\n" " }\n" "\n" " /* Initialize the Python interpreter. Required.\n" " If this step fails, it will be a fatal error. */\n" " status = Py_InitializeFromConfig(&config);\n" " if (PyStatus_Exception(status)) {\n" " goto exception;\n" " }\n" " PyConfig_Clear(&config);\n" "\n" " /* Optionally import the module; alternatively,\n" " import can be deferred until the embedded script\n" " imports it. */\n" " PyObject *pmodule = PyImport_ImportModule(\"spam\");\n" " if (!pmodule) {\n" " PyErr_Print();\n" " fprintf(stderr, \"Error: could not import module 'spam'\\n\");\n" " }\n" "\n" " // ... use Python C API here ...\n" "\n" " return 0;\n" "\n" " exception:\n" " PyConfig_Clear(&config);\n" " Py_ExitStatusException(status);\n" "}" msgstr "" #: ../../extending/extending.rst:436 msgid "" "Removing entries from ``sys.modules`` or importing compiled modules into " "multiple interpreters within a process (or following a :c:func:`fork` " "without an intervening :c:func:`exec`) can create problems for some " "extension modules. Extension module authors should exercise caution when " "initializing internal data structures." msgstr "" "単一のプロセス内 (または :c:func:`fork` 後の :c:func:`exec` が介入していない" "状態) における複数のインタプリタにおいて、 ``sys.modules`` からエントリを除去" "したり新たなコンパイル済みモジュールを import したりすると、拡張モジュールに" "よっては問題を生じることがあります。拡張モジュールの作者は、内部データ構造を" "初期化する際にはよくよく用心すべきです。" #: ../../extending/extending.rst:442 msgid "" "A more substantial example module is included in the Python source " "distribution as :file:`Modules/xxmodule.c`. This file may be used as a " "template or simply read as an example." msgstr "" "より実質的なモジュール例は、Python ソース配布物に :file:`Modules/xxmodule.c` " "という名前で入っています。このファイルはテンプレートとしても利用できますし、" "単に例としても読めます。" #: ../../extending/extending.rst:448 msgid "" "Unlike our ``spam`` example, ``xxmodule`` uses *multi-phase initialization* " "(new in Python 3.5), where a PyModuleDef structure is returned from " "``PyInit_spam``, and creation of the module is left to the import machinery. " "For details on multi-phase initialization, see :PEP:`489`." msgstr "" "``xmodule`` は ``spam`` と異なり、 *多段階初期化 (multi-phase " "initialization* (Python 3.5 の新機能) を使っています。 ``PyInit_spam`` が " "PyModuleDef を返し、モジュールの生成は後に import 機構が行います。多段階初期" "化についての詳細は :PEP:`489` を参照してください。" #: ../../extending/extending.rst:457 msgid "Compilation and Linkage" msgstr "コンパイルとリンク" #: ../../extending/extending.rst:459 msgid "" "There are two more things to do before you can use your new extension: " "compiling and linking it with the Python system. If you use dynamic " "loading, the details may depend on the style of dynamic loading your system " "uses; see the chapters about building extension modules " "(chapter :ref:`building`) and additional information that pertains only to " "building on Windows (chapter :ref:`building-on-windows`) for more " "information about this." msgstr "" "新しい拡張モジュールを使えるようになるまで、まだ二つの作業: コンパイルと、" "Python システムへのリンク、が残っています。動的読み込み (dynamic loading) を" "使っているのなら、作業の詳細は自分のシステムが使っている動的読み込みの形式に" "よって変わるかもしれません; 詳しくは、拡張モジュールのビルドに関する章 " "(:ref:`building` 章) や、Windows におけるビルドに関係する追加情報の章 " "(:ref:`building-on-windows` 章) を参照してください。" #: ../../extending/extending.rst:466 msgid "" "If you can't use dynamic loading, or if you want to make your module a " "permanent part of the Python interpreter, you will have to change the " "configuration setup and rebuild the interpreter. Luckily, this is very " "simple on Unix: just place your file (:file:`spammodule.c` for example) in " "the :file:`Modules/` directory of an unpacked source distribution, add a " "line to the file :file:`Modules/Setup.local` describing your file:" msgstr "" "動的読み込みを使えなかったり、モジュールを常時 Python インタプリタの一部にし" "ておきたい場合には、インタプリタのビルド設定を変更して再ビルドしなければなら" "なくなるでしょう。Unixでは、幸運なことにこの作業はとても単純です: 単に自作の" "モジュールファイル (例えば :file:`spammodule.c`) を展開したソース配布物" "の :file:`Modules/` ディレクトリに置き、 :file:`Modules/Setup.local` に自分" "のファイルを説明する以下の一行:" msgid "spam spammodule.o" msgstr "spam spammodule.o" #: ../../extending/extending.rst:477 msgid "" "and rebuild the interpreter by running :program:`make` in the toplevel " "directory. You can also run :program:`make` in the :file:`Modules/` " "subdirectory, but then you must first rebuild :file:`Makefile` there by " "running ':program:`make` Makefile'. (This is necessary each time you change " "the :file:`Setup` file.)" msgstr "" "を追加して、トップレベルのディレクトリで :program:`make` を実行して、インタプ" "リタを再ビルドするだけです。 :file:`Modules/` サブディレクトリで" "も :program:`make` を実行できますが、前もって ':program:`make` Makefile' を実" "行して :file:`Makefile` を再ビルドしておかなければならりません。(この作業" "は :file:`Setup` ファイルを変更するたびに必要です。)" #: ../../extending/extending.rst:483 msgid "" "If your module requires additional libraries to link with, these can be " "listed on the line in the configuration file as well, for instance:" msgstr "" "モジュールが別のライブラリとリンクされている必要がある場合、ライブラリも設定" "ファイルに列挙できます。例えば以下のようにします。" msgid "spam spammodule.o -lX11" msgstr "spam spammodule.o -lX11" #: ../../extending/extending.rst:494 msgid "Calling Python Functions from C" msgstr "C から Python 関数を呼び出す" #: ../../extending/extending.rst:496 msgid "" "So far we have concentrated on making C functions callable from Python. The " "reverse is also useful: calling Python functions from C. This is especially " "the case for libraries that support so-called \"callback\" functions. If a " "C interface makes use of callbacks, the equivalent Python often needs to " "provide a callback mechanism to the Python programmer; the implementation " "will require calling the Python callback functions from a C callback. Other " "uses are also imaginable." msgstr "" "これまでは、Python からの C 関数の呼び出しに重点を置いて述べてきました。とこ" "ろでこの逆: C からの Python 関数の呼び出しもまた有用です。とりわけ、いわゆる " "\"コールバック\" 関数をサポートするようなライブラリを作成する際にはこの機能が" "便利です。ある C インターフェースがコールバックを利用している場合、同等の機能" "を提供する Python コードでは、しばしば Python プログラマにコールバック機構を" "提供する必要があります; このとき実装では、 C で書かれたコールバック関数から " "Python で書かれたコールパック関数を呼び出すようにする必要があるでしょう。もち" "ろん、他の用途も考えられます。" #: ../../extending/extending.rst:504 msgid "" "Fortunately, the Python interpreter is easily called recursively, and there " "is a standard interface to call a Python function. (I won't dwell on how to " "call the Python parser with a particular string as input --- if you're " "interested, have a look at the implementation of the :option:`-c` command " "line option in :file:`Modules/main.c` from the Python source code.)" msgstr "" "幸運なことに、Python インタプリタは簡単に再帰呼び出しでき、 Python 関数を呼び" "出すための標準インターフェースもあります。 (Python パーザを特定の入力文字を" "使って呼び出す方法について詳説するつもりはありません --- この方法に興味がある" "なら、 Python ソースコードの :file:`Modules/main.c` にある、コマンドラインオ" "プション :option:`-c` の実装を見てください)" #: ../../extending/extending.rst:510 msgid "" "Calling a Python function is easy. First, the Python program must somehow " "pass you the Python function object. You should provide a function (or some " "other interface) to do this. When this function is called, save a pointer " "to the Python function object (be careful to :c:func:`Py_INCREF` it!) in a " "global variable --- or wherever you see fit. For example, the following " "function might be part of a module definition::" msgstr "" "Python 関数の呼び出しは簡単です。まず、C のコードに対してコールバックを登録し" "ようとする Python プログラムは、何らかの方法で Python の関数オブジェクトを渡" "さねばなりません。このために、コールバック登録関数 (またはその他のインター" "フェース) を提供せねばなりません。このコールバック登録関数が呼び出された際" "に、引き渡された Python 関数オブジェクトへのポインタをグローバル変数に --- あ" "るいは、どこか適切な場所に --- 保存します (関数オブジェクト" "を :c:func:`Py_INCREF` するようよく注意してください!)。例えば、以下のような関" "数がモジュールの一部になっていることでしょう::" msgid "" "static PyObject *my_callback = NULL;\n" "\n" "static PyObject *\n" "my_set_callback(PyObject *dummy, PyObject *args)\n" "{\n" " PyObject *result = NULL;\n" " PyObject *temp;\n" "\n" " if (PyArg_ParseTuple(args, \"O:set_callback\", &temp)) {\n" " if (!PyCallable_Check(temp)) {\n" " PyErr_SetString(PyExc_TypeError, \"parameter must be " "callable\");\n" " return NULL;\n" " }\n" " Py_XINCREF(temp); /* Add a reference to new callback */\n" " Py_XDECREF(my_callback); /* Dispose of previous callback */\n" " my_callback = temp; /* Remember new callback */\n" " /* Boilerplate to return \"None\" */\n" " Py_INCREF(Py_None);\n" " result = Py_None;\n" " }\n" " return result;\n" "}" msgstr "" "static PyObject *my_callback = NULL;\n" "\n" |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |