curses.po

# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-09 17:02+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../c-api/curses.rst:4
msgid "Curses C API"
msgstr "Curses C API"

#: ../../c-api/curses.rst:6
msgid ""
":mod:`curses` exposes a small C interface for extension modules. Consumers "
"must include the header file :file:`py_curses.h` (which is not included by "
"default by :file:`Python.h`) and :c:func:`import_curses` must be invoked, "
"usually as part of the module initialisation function, to populate :c:var:"
"`PyCurses_API`."
msgstr ""
":mod:`curses` 為擴充模組公開了一個小型的 C 介面。使用者必須包含標頭檔 "
":file:`py_curses.h`\\ （此檔案不會由 :file:`Python.h` 預設包含），並且必須觸發 "
":c:func:`import_curses` 以填充 (populate) :c:var:`PyCurses_API`，通常是作為"
"模組初始化函式的一部分。"

#: ../../c-api/curses.rst:14
msgid ""
"Neither the C API nor the pure Python :mod:`curses` module are compatible "
"with subinterpreters."
msgstr ""

#: ../../c-api/curses.rst:19
msgid ""
"Import the curses C API. The macro does not need a semi-colon to be called."
msgstr "引入 curses C API。呼叫此巨集不需要寫分號。"

#: ../../c-api/curses.rst:21
msgid "On success, populate the :c:var:`PyCurses_API` pointer."
msgstr ""

#: ../../c-api/curses.rst:23
msgid ""
"On failure, set :c:var:`PyCurses_API` to NULL and set an exception. The "
"caller must check if an error occurred via :c:func:`PyErr_Occurred`:"
msgstr ""

#: ../../c-api/curses.rst:26
msgid ""
"import_curses();  // semi-colon is optional but recommended\n"
"if (PyErr_Occurred()) { /* cleanup */ }"
msgstr ""
"import_curses();  // 建議要寫分號但非必要\n"
"if (PyErr_Occurred()) { /* 清理 */ }"

#: ../../c-api/curses.rst:34
msgid ""
"Dynamically allocated object containing the curses C API. This variable is "
"only available once :c:macro:`import_curses` succeeds."
msgstr ""

#: ../../c-api/curses.rst:37
msgid "``PyCurses_API[0]`` corresponds to :c:data:`PyCursesWindow_Type`."
msgstr ""

#: ../../c-api/curses.rst:39
msgid ""
"``PyCurses_API[1]``, ``PyCurses_API[2]``, and ``PyCurses_API[3]`` are "
"pointers to predicate functions of type ``int (*)(void)``."
msgstr ""
"``PyCurses_API[1]``、``PyCurses_API[2]`` 和 ``PyCurses_API[3]`` 是指向 "
"型別為 ``int (*)(void)`` 的謂詞函式 (predicate functions) 的指標。"

#: ../../c-api/curses.rst:42
msgid ""
"When called, these predicates return whether :func:`curses.setupterm`, :func:"
"`curses.initscr`, and :func:`curses.start_color` have been called "
"respectively."
msgstr ""

#: ../../c-api/curses.rst:46
msgid ""
"See also the convenience macros :c:macro:`PyCursesSetupTermCalled`, :c:macro:"
"`PyCursesInitialised`, and :c:macro:`PyCursesInitialisedColor`."
msgstr ""

#: ../../c-api/curses.rst:51
msgid ""
"The number of entries in this structure is subject to changes. Consider "
"using :c:macro:`PyCurses_API_pointers` to check if new fields are available "
"or not."
msgstr ""

#: ../../c-api/curses.rst:58
msgid ""
"The number of accessible fields (``4``) in :c:var:`PyCurses_API`. This "
"number is incremented whenever new fields are added."
msgstr ""

#: ../../c-api/curses.rst:64
msgid ""
"The :ref:`heap type <heap-types>` corresponding to :class:`curses.window`."
msgstr ""

#: ../../c-api/curses.rst:69
msgid ""
"Return true if *op* is a :class:`curses.window` instance, false otherwise."
msgstr "如果 *op* 是 :class:`curses.window` 實例則回傳 true，否則回傳 false。"

#: ../../c-api/curses.rst:72
msgid ""
"The following macros are convenience macros expanding into C statements. In "
"particular, they can only be used as ``macro;`` or ``macro``, but not "
"``macro()`` or ``macro();``."
msgstr ""

#: ../../c-api/curses.rst:78
msgid "Macro checking if :func:`curses.setupterm` has been called."
msgstr "如果已呼叫 :func:`curses.setupterm`，則為巨集檢查。"

#: ../../c-api/curses.rst:80 ../../c-api/curses.rst:97
#: ../../c-api/curses.rst:114
msgid "The macro expansion is roughly equivalent to:"
msgstr "巨集展開大致相當於："

#: ../../c-api/curses.rst:82
msgid ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_setupterm_called = (predicate_t)PyCurses_API[1];\n"
"    if (!was_setupterm_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"
msgstr ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_setupterm_called = (predicate_t)PyCurses_API[1];\n"
"    if (!was_setupterm_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"

#: ../../c-api/curses.rst:95
msgid "Macro checking if :func:`curses.initscr` has been called."
msgstr "如果已呼叫 :func:`curses.initscr`，則為巨集檢查。"

#: ../../c-api/curses.rst:99
msgid ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_initscr_called = (predicate_t)PyCurses_API[2];\n"
"    if (!was_initscr_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"
msgstr ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_initscr_called = (predicate_t)PyCurses_API[2];\n"
"    if (!was_initscr_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"

#: ../../c-api/curses.rst:112
msgid "Macro checking if :func:`curses.start_color` has been called."
msgstr "如果已呼叫 :func:`curses.start_color`，則為巨集檢查。"

#: ../../c-api/curses.rst:116
msgid ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_start_color_called = (predicate_t)PyCurses_API[3];\n"
"    if (!was_start_color_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"
msgstr ""
"{\n"
"    typedef int (*predicate_t)(void);\n"
"    predicate_t was_start_color_called = (predicate_t)PyCurses_API[3];\n"
"    if (!was_start_color_called()) {\n"
"        return NULL;\n"
"    }\n"
"}"

#: ../../c-api/curses.rst:128
msgid "Internal data"
msgstr "內部資料"

#: ../../c-api/curses.rst:130
msgid ""
"The following objects are exposed by the C API but should be considered "
"internal-only."
msgstr "以下物件由 C API 所公開，但應視為僅供內部使用。"

#: ../../c-api/curses.rst:135
msgid "Name of the curses capsule to pass to :c:func:`PyCapsule_Import`."
msgstr ""

#: ../../c-api/curses.rst:137
msgid "Internal usage only. Use :c:macro:`import_curses` instead."
msgstr "僅供內部使用。請改用 :c:macro:`import_curses`。"