From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 28 Jun 2026 17:19:17 +0000 (+0200) Subject: [3.13] gh-87881: Document the result of curses inch() and getbkgd() (GH-152488) ... X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e0f81864ec2853152648050b98ec828f6b74c658;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-87881: Document the result of curses inch() and getbkgd() (GH-152488) (GH-152511) (GH-152515) Explain the character/attribute bit layout and how to extract the parts (A_CHARTEXT and A_ATTRIBUTES bit-masks, pair_number() for the color pair). (cherry picked from commit d831a690766e92b3be5e40134f64407bd041bcbf) (cherry picked from commit 09013312bbdf9ff6583c95ba6bc2698e61c66be6) Co-authored-by: Serhiy Storchaka Co-authored-by: Claude Opus 4.8 --- diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst index 68154029af56..32d328283671 100644 --- a/Doc/library/curses.rst +++ b/Doc/library/curses.rst @@ -955,6 +955,7 @@ Window objects .. method:: window.getbkgd() Return the given window's current background character/attribute pair. + Its components can be extracted like those of :meth:`inch`. .. method:: window.getch([y, x]) @@ -1042,8 +1043,10 @@ Window objects .. method:: window.inch([y, x]) - Return the character at the given position in the window. The bottom 8 bits are - the character proper, and upper bits are the attributes. + Return the character at the given position in the window. + The bottom 8 bits are the character proper and the upper bits are the attributes; + extract them with the :data:`A_CHARTEXT` and :data:`A_ATTRIBUTES` bit-masks, + and the color pair with :func:`pair_number`. .. method:: window.insch(ch[, attr])