sync with cpython 9e38723a

Author: github-actions[bot]

faq/programming.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-04-16 00:03+0000\n"
+"POT-Creation-Date: 2024-09-09 16:09+0000\n"
 "PO-Revision-Date: 2018-05-23 14:36+0000\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -141,20 +141,34 @@ msgid ""
 "after the name of the corresponding C variable. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:90
+msgid ""
+"import curses\n"
+"stdscr = curses.initscr()"
+msgstr ""
+
 #: ../../howto/curses.rst:93
 msgid ""
 "Usually curses applications turn off automatic echoing of keys to the "
 "screen, in order to be able to read keys and only display them under certain "
 "circumstances.  This requires calling the :func:`~curses.noecho` function. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:98
+msgid "curses.noecho()"
+msgstr ""
+
 #: ../../howto/curses.rst:100
 msgid ""
 "Applications will also commonly need to react to keys instantly, without "
 "requiring the Enter key to be pressed; this is called cbreak mode, as "
 "opposed to the usual buffered input mode. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:104
+msgid "curses.cbreak()"
+msgstr ""
+
 #: ../../howto/curses.rst:106
 msgid ""
 "Terminals usually return special keys, such as the cursor keys or navigation "
@@ -165,19 +179,34 @@ msgid ""
 "keypad mode. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:113
+msgid "stdscr.keypad(True)"
+msgstr ""
+
 #: ../../howto/curses.rst:115
 msgid ""
 "Terminating a curses application is much easier than starting one. You'll "
 "need to call::"
 msgstr ""
 
+#: ../../howto/curses.rst:118
+msgid ""
+"curses.nocbreak()\n"
+"stdscr.keypad(False)\n"
+"curses.echo()"
+msgstr ""
+
 #: ../../howto/curses.rst:122
 msgid ""
 "to reverse the curses-friendly terminal settings. Then call the :func:"
 "`~curses.endwin` function to restore the terminal to its original operating "
 "mode. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:126
+msgid "curses.endwin()"
+msgstr ""
+
 #: ../../howto/curses.rst:128
 msgid ""
 "A common problem when debugging a curses application is to get your terminal "
@@ -193,6 +222,25 @@ msgid ""
 "by importing the :func:`curses.wrapper` function and using it like this::"
 msgstr ""
 
+#: ../../howto/curses.rst:137
+msgid ""
+"from curses import wrapper\n"
+"\n"
+"def main(stdscr):\n"
+"    # Clear screen\n"
+"    stdscr.clear()\n"
+"\n"
+"    # This raises ZeroDivisionError when i == 10.\n"
+"    for i in range(0, 11):\n"
+"        v = i-10\n"
+"        stdscr.addstr(i, 0, '10 divided by {} is {}'.format(v, 10/v))\n"
+"\n"
+"    stdscr.refresh()\n"
+"    stdscr.getkey()\n"
+"\n"
+"wrapper(main)"
+msgstr ""
+
 #: ../../howto/curses.rst:153
 msgid ""
 "The :func:`~curses.wrapper` function takes a callable object and does the "
@@ -227,6 +275,13 @@ msgid ""
 "window object. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:178
+msgid ""
+"begin_x = 20; begin_y = 7\n"
+"height = 5; width = 40\n"
+"win = curses.newwin(height, width, begin_y, begin_x)"
+msgstr ""
+
 #: ../../howto/curses.rst:182
 msgid ""
 "Note that the coordinate system used in curses is unusual. Coordinates are "
@@ -282,6 +337,24 @@ msgid ""
 "will be displayed.  ::"
 msgstr ""
 
+#: ../../howto/curses.rst:223
+msgid ""
+"pad = curses.newpad(100, 100)\n"
+"# These loops fill the pad with letters; addch() is\n"
+"# explained in the next section\n"
+"for y in range(0, 99):\n"
+"    for x in range(0, 99):\n"
+"        pad.addch(y,x, ord('a') + (x*x+y*y) % 26)\n"
+"\n"
+"# Displays a section of the pad in the middle of the screen.\n"
+"# (0,0) : coordinate of upper-left corner of pad area to display.\n"
+"# (5,5) : coordinate of upper-left corner of window area to be filled\n"
+"#         with pad content.\n"
+"# (20, 75) : coordinate of lower-right corner of window area to be\n"
+"#          : filled with pad content.\n"
+"pad.refresh( 0,0, 5,5, 20,75)"
+msgstr ""
+
 #: ../../howto/curses.rst:238
 msgid ""
 "The :meth:`!refresh` call displays a section of the pad in the rectangle "
@@ -515,6 +588,13 @@ msgid ""
 "you could code::"
 msgstr ""
 
+#: ../../howto/curses.rst:364
+msgid ""
+"stdscr.addstr(0, 0, \"Current mode: Typing mode\",\n"
+"              curses.A_REVERSE)\n"
+"stdscr.refresh()"
+msgstr ""
+
 #: ../../howto/curses.rst:368
 msgid ""
 "The curses library also supports color on those terminals that provide it. "
@@ -548,6 +628,12 @@ msgstr ""
 msgid "An example, which displays a line of text using color pair 1::"
 msgstr ""
 
+#: ../../howto/curses.rst:391
+msgid ""
+"stdscr.addstr(\"Pretty text\", curses.color_pair(1))\n"
+"stdscr.refresh()"
+msgstr ""
+
 #: ../../howto/curses.rst:394
 msgid ""
 "As I said before, a color pair consists of a foreground and background "
@@ -571,13 +657,21 @@ msgid ""
 "background, you would call::"
 msgstr ""
 
+#: ../../howto/curses.rst:408
+msgid "curses.init_pair(1, curses.COLOR_RED, curses.COLOR_WHITE)"
+msgstr ""
+
 #: ../../howto/curses.rst:410
 msgid ""
 "When you change a color pair, any text already displayed using that color "
 "pair will change to the new colors.  You can also display new text in this "
 "color with::"
 msgstr ""
 
+#: ../../howto/curses.rst:414
+msgid "stdscr.addstr(0,0, \"RED ALERT!\", curses.color_pair(1))"
+msgstr ""
+
 #: ../../howto/curses.rst:416
 msgid ""
 "Very fancy terminals can change the definitions of the actual colors to a "
@@ -643,6 +737,18 @@ msgid ""
 "program may look something like this::"
 msgstr ""
 
+#: ../../howto/curses.rst:462
+msgid ""
+"while True:\n"
+"    c = stdscr.getch()\n"
+"    if c == ord('p'):\n"
+"        PrintDocument()\n"
+"    elif c == ord('q'):\n"
+"        break  # Exit the while loop\n"
+"    elif c == curses.KEY_HOME:\n"
+"        x = y = 0"
+msgstr ""
+
 #: ../../howto/curses.rst:471
 msgid ""
 "The :mod:`curses.ascii` module supplies ASCII class membership functions "
@@ -662,6 +768,14 @@ msgid ""
 "number of characters. ::"
 msgstr ""
 
+#: ../../howto/curses.rst:484
+msgid ""
+"curses.echo()            # Enable echoing of characters\n"
+"\n"
+"# Get a 15-character string, with the cursor on the top line\n"
+"s = stdscr.getstr(0,0, 15)"
+msgstr ""
+
 #: ../../howto/curses.rst:489
 msgid ""
 "The :mod:`curses.textpad` module supplies a text box that supports an Emacs-"
@@ -670,6 +784,27 @@ msgid ""
 "results either with or without trailing spaces.  Here's an example::"
 msgstr ""
 
+#: ../../howto/curses.rst:495
+msgid ""
+"import curses\n"
+"from curses.textpad import Textbox, rectangle\n"
+"\n"
+"def main(stdscr):\n"
+"    stdscr.addstr(0, 0, \"Enter IM message: (hit Ctrl-G to send)\")\n"
+"\n"
+"    editwin = curses.newwin(5,30, 2,1)\n"
+"    rectangle(stdscr, 1,0, 1+5+1, 1+30+1)\n"
+"    stdscr.refresh()\n"
+"\n"
+"    box = Textbox(editwin)\n"
+"\n"
+"    # Let the user edit until Ctrl-G is struck.\n"
+"    box.edit()\n"
+"\n"
+"    # Get resulting contents\n"
+"    message = box.gather()"
+msgstr ""
+
 #: ../../howto/curses.rst:513
 msgid ""
 "See the library documentation on :mod:`curses.textpad` for more details."