# `curses` — 문자 셀 디스플레이를 위한 터미널 처리

Source code: Lib/curses

`curses` 모듈은 이식성 있는 고급 터미널 처리를 위한 사실상의 표준인 curses 라이브러리에 대한 인터페이스를 제공합니다.

curses는 유닉스 환경에서 가장 널리 사용되지만, 윈도우, DOS 및 기타 시스템에서도 사용할 수 있는 버전이 있습니다. 이 확장 모듈은 리눅스와 유닉스의 BSD 변형에서 동작하는 오픈 소스 curses 라이브러리인 ncurses의 API와 일치하도록 설계되었습니다.

참고

설명서에 문자(character)가 언급될 때마다 정수, 한 문자 유니코드 문자열 또는 한 바이트 바이트열로 지정할 수 있습니다.

설명서에 문자 문자열(character string)이 언급될 때마다 유니코드 문자열이나 바이트열로 지정할 수 있습니다.

참고

버전 5.4부터, ncurses 라이브러리는 `nl_langinfo` 함수를 사용하여 비 ASCII 데이터를 해석하는 방법을 결정합니다. 이는 응용 프로그램에서 `locale.setlocale()`을 호출해야 하고 시스템의 사용 가능한 인코딩 중 하나를 사용하여 유니코드 문자열을 인코딩해야 함을 의미합니다. 이 예제는 시스템의 기본 인코딩을 사용합니다:

    import locale
    locale.setlocale(locale.LC_ALL, '')
    code = locale.getpreferredencoding()

그런 다음 code를 `str.encode()` 호출의 encoding으로 사용하십시오.

더 보기

모듈 `curses.ascii`

  로케일 설정과 관계없이, ASCII 문자로 작업하기 위한 유틸리티.

모듈 `curses.panel`

  curses 창에 깊이를 추가하는 패널 스택 확장.

모듈 `curses.textpad`

  Emacs와 유사한 바인딩을 지원하는 curses를 위한 편집 가능한 텍스트 위젯.

파이썬 curses 프로그래밍

  Andrew Kuchling과 Eric Raymond가 작성한, curses를 파이썬에서 사용하는 것에 대한 자습서 자료.

파이썬 소스 배포의 Tools/demo/ 디렉터리에는 이 모듈에서 제공하는 curses 바인딩을 사용하는 몇 가지 예제 프로그램이 포함되어 있습니다.

## 함수

`curses` 모듈은 다음 예외를 정의합니다:

exception `curses.``error`

  curses 라이브러리 함수가 에러를 반환할 때 발생하는 예외.

참고

함수나 메서드에 대한 x나 y 인자가 선택 사항일 때마다, 기본값은 현재 커서 위치입니다. attr이 선택적일 때마다 기본값은 `A_NORMAL`입니다.

`curses` 모듈은 다음 함수를 정의합니다:

`curses.``baudrate`()

  터미널의 출력 속도를 초당 비트 수로 반환합니다. 소프트웨어 터미널 에뮬레이터에서는 고정된 큰 값을 갖습니다. 역사적인 이유로 포함되었습니다; 이전에는, 시간 지연에 대한 출력 루프를 작성하는데, 때로는 회선 속도에 따라 인터페이스를 변경하는 데 사용되었습니다.

`curses.``beep`()

  짧은 주의 음을 냅니다.

`curses.``can_change_color`()

  프로그래머가 터미널에 표시되는 색상을 변경할 수 있는지에 따라 `True`나 `False`를 반환합니다.

`curses.``cbreak`()

  cbreak 모드로 들어갑니다. cbreak 모드(“드문(rare)” 모드라고도 합니다)에서는 일반 tty 줄 버퍼링이 꺼지고 문자를 하나씩 읽을 수 있습니다. 그러나, 원시(raw) 모드와 달리, 특수 문자(인터럽트(interrupt), 종료(quit), 일시 중단(suspend) 및 흐름 제어(flow control))는 tty 드라이버와 호출하는 프로그램에 영향을 미칩니다. `raw()`를 먼저 호출한 다음 `cbreak()`를 호출하면 터미널이 cbreak 모드로 유지됩니다.

`curses.``color_content`(color_number)

  `0`과 `COLORS - 1` 사이의 색상 color_number에서 빨강, 녹색 및 파랑 (RGB) 구성 요소의 강도(intensity)를 반환합니다. 주어진 색상에 대한 R,G,B 값이 포함된 3-튜플을 반환합니다. 이 값은 `0`(구성 요소 없음)과 `1000`(구성 요소의 최대량) 사이입니다.

`curses.``color_pair`(pair_number)

  지정된 색상 쌍으로 텍스트를 표시하기 위한 속성값을 반환합니다. 처음 256 색상 쌍만 지원됩니다. 이 속성값은 `A_STANDOUT`, `A_REVERSE` 및 기타 `A_*` 속성과 결합할 수 있습니다. `pair_number()`는 이 함수의 역입니다.

`curses.``curs_set`(visibility)

  커서 상태를 설정합니다. visibility는 `0`, `1` 또는 `2`로 설정될 수 있는데, 각각 보이지 않음(invisible), 보통, 매우 잘 보임(very visible)입니다. 터미널이 요청된 visibility를 지원하면, 이전 커서 상태를 반환합니다; 그렇지 않으면 예외가 발생합니다. 많은 터미널에서, “보이는(visible)” 모드는 밑줄 커서이고 “매우 잘 보이는(very visible)” 모드는 블록 커서입니다.

`curses.``def_prog_mode`()

  현재 터미널 모드를 “프로그램(program)” 모드로 저장합니다. 프로그램 모드는 실행 중인 프로그램이 curses를 사용 중인 모드입니다. (반대는 “셸(shell)” 모드이며, 프로그램이 curses를 사용하지 않을 때입니다.) 이후에 `reset_prog_mode()`를 호출하면 이 모드가 복원됩니다.

`curses.``def_shell_mode`()

  현재 터미널 모드를 “셸(shell)” 모드로 저장합니다. 셸 모드는 실행 중인 프로그램이 curses를 사용하지 않는 모드입니다. (반대는 “프로그램(program)” 모드이며, 프로그램이 curses 기능을 사용 중일 때입니다.) 이후에 `reset_shell_mode()`를 호출하면 이 모드가 복원됩니다.

`curses.``delay_output`(ms)

  출력에 ms 밀리초 일시 중지를 삽입합니다.

`curses.``doupdate`()

  물리적 화면을 갱신합니다. curses 라이브러리는 두 개의 데이터 구조를 유지합니다. 하나는 현재 물리적 화면 내용을 표현하고 다른 하나는 원하는 다음 상태를 나타내는 가상 화면을 표현합니다. `doupdate()`는 물리적 화면을 가상 화면과 일치하도록 갱신합니다.

  가상 화면은 창에 `addstr()`과 같은 쓰기 연산이 수행된 후 `noutrefresh()` 호출로 갱신될 수 있습니다. 일반적인 `refresh()` 호출은 단순히 `noutrefresh()` 후에 `doupdate()` 하는 것입니다; 여러 개의 창을 갱신해야 하면, 모든 창에서 `noutrefresh()` 호출을 실행한 다음 단일 `doupdate()`를 실행하여 속도 성능을 높이고 아마도 화면 깜박임을 줄일 수 있습니다.

`curses.``echo`()

  반향(echo) 모드로 들어갑니다. 반향 모드에서는, 각 문자 입력이 입력되는 대로 화면에 반향을 일으킵니다.

`curses.``endwin`()

  라이브러리를 초기화 해제하고, 터미널을 정상 상태로 되돌립니다.

`curses.``erasechar`()

  사용자의 현재 지우기 문자(erase character)를 1바이트 바이트열 객체로 반환합니다. 유닉스 운영 체제에서 이는 curses 프로그램의 제어 tty의 특성이며, curses 라이브러리 자체에 의해 설정되지 않습니다.

`curses.``filter`()

  `filter()` 루틴을 사용하는 경우 `initscr()`을 호출하기 전에 호출해야 합니다. 이러한 호출 중에, 효과는 `LINES`가 `1`로 설정되고; `clear`, `cup`, `cud`, `cud1`, `cuu1`, `cuu`, `vpa` 기능이 비활성화되고; `home` 문자열이 `cr` 값으로 설정됩니다. 결과적으로 커서가 현재 줄에 갇혀서 화면이 갱신됩니다. 화면의 나머지 부분을 건드리지 않고 한 번에 한 글자(character-at-a-time) 줄 편집을 활성화하는데 사용될 수 있습니다.

`curses.``flash`()

  화면을 깜박입니다. 즉, 반전 비디오로 변경한 다음 짧은 간격으로 되돌립니다. 어떤 사람들은 `beep()`이 만드는 가청 주의 신호보다 이런 ‘시각적 벨’을 선호합니다.

`curses.``flushinp`()

  모든 입력 버퍼를 플러시 합니다. 이렇게 하면 사용자가 입력했지만, 아직 프로그램에서 처리하지 않은 모든 선행 입력(typeahead)을 모두 버립니다.

`curses.``getmouse`()

  After `getch()` returns `KEY_MOUSE` to signal a mouse event, this method should be called to retrieve the queued mouse event, represented as a 5-tuple `(id, x, y, z, bstate)`. id is an ID value used to distinguish multiple devices, and x, y, z are the event’s coordinates. (z is currently unused.) bstate is an integer value whose bits will be set to indicate the type of event, and will be the bitwise OR of one or more of the following constants, where n is the button number from 1 to 5: `BUTTONn_PRESSED`, `BUTTONn_RELEASED`, `BUTTONn_CLICKED`, `BUTTONn_DOUBLE_CLICKED`, `BUTTONn_TRIPLE_CLICKED`, `BUTTON_SHIFT`, `BUTTON_CTRL`, `BUTTON_ALT`.

  버전 3.10에서 변경: The `BUTTON5_*` constants are now exposed if they are provided by the underlying curses library.

`curses.``getsyx`()

  가상 화면 커서의 현재 좌표를 튜플 `(y, x)`로 반환합니다. `leaveok`가 현재 `True`이면, `(-1, -1)`을 반환합니다.

`curses.``getwin`(file)

  이전 `putwin()` 호출로 파일에 저장된 창 관련 데이터를 읽습니다. 그런 다음 루틴은 해당 데이터를 사용하여 새 창을 만들고 초기화하여, 새 창 객체를 반환합니다.

`curses.``has_colors`()

  터미널이 색상을 표시할 수 있으면 `True`를 반환합니다. 그렇지 않으면 `False`를 반환합니다.

`curses.``has_extended_color_support`()

  Return `True` if the module supports extended colors; otherwise, return `False`. Extended color support allows more than 256 color pairs for terminals that support more than 16 colors (e.g. xterm-256color).

  Extended color support requires ncurses version 6.1 or later.

  버전 3.10에 추가.

`curses.``has_ic`()

  터미널에 문자 삽입과 삭제 기능이 있으면 `True`를 반환합니다. 이 함수는 역사적인 이유로만 포함되는데, 모든 최신 소프트웨어 터미널 에뮬레이터에 이러한 기능이 있기 때문입니다.

`curses.``has_il`()

  터미널에 줄 삽입과 삭제 기능이 있거나, 영역 스크롤을 사용하여 시뮬레이션 할 수 있으면 `True`를 반환합니다. 이 함수는 역사적인 이유로만 포함되는데, 모든 최신 소프트웨어 터미널 에뮬레이터에 이러한 기능이 있기 때문입니다.

`curses.``has_key`(ch)

  키값 ch를 취하고, 현재 터미널 유형이 해당 값을 가진 키를 인식하면 `True`를 반환합니다.

`curses.``halfdelay`(tenths)

  사용자가 입력 한 문자를 프로그램에서 즉시 사용할 수 있다는 점에서 cbreak 모드와 유사한, 반 지연(half-delay) 모드에 사용됩니다. 그러나 tenths 10분의 1초 동안 블록한 후 아무것도 입력하지 않으면 예외가 발생합니다. tenths의 값은 `1`과 `255` 사이의 숫자여야 합니다. 반 지연 모드를 종료하려면 `nocbreak()`를 사용하십시오.

`curses.``init_color`(color_number, r, g, b)

  Change the definition of a color, taking the number of the color to be changed followed by three RGB values (for the amounts of red, green, and blue components). The value of color_number must be between `0` and `COLORS - 1`. Each of r, g, b, must be a value between `0` and `1000`. When `init_color()` is used, all occurrences of that color on the screen immediately change to the new definition. This function is a no-op on most terminals; it is active only if `can_change_color()` returns `True`.

`curses.``init_pair`(pair_number, fg, bg)

  색상 쌍의 정의를 변경합니다. 세 가지 인자를 취합니다: 변경할 색상 쌍 번호, 전경색 번호 및 배경색 번호. pair_number의 값은 `1`과 `COLOR_PAIRS - 1` 사이여야 합니다 (`0` 색상 쌍은 검은 배경색에 흰 전경색으로 연결되어 있으며 변경할 수 없습니다). fg와 bg 인자의 값은 `0`과 `COLORS - 1` 사이, 또는, `use_default_colors()` 후에, `-1`이어야 합니다. 색상 쌍이 이전에 초기화되었으면, 화면이 새로 고쳐지고 해당 색상 쌍의 모든 항목이 새 정의로 변경됩니다.

`curses.``initscr`()

  라이브러리를 초기화합니다. 전체 화면을 나타내는 창 객체를 반환합니다.

  참고

  터미널을 여는 중 에러가 발생하면, 하부 curses 라이브러리가 인터프리터를 종료시킬 수 있습니다.

`curses.``is_term_resized`(nlines, ncols)

  `resize_term()`이 창 구조를 수정한다면 `True`를, 그렇지 않으면 `False`를 반환합니다.

`curses.``isendwin`()

  `endwin()`이 호출되었으면 (즉, curses 라이브러리가 초기화 해제되었다면) `True`를 반환합니다.

`curses.``keyname`(k)

  키 번호 k의 이름을 바이트열 객체로 반환합니다. 인쇄 가능한 ASCII 문자를 생성하는 키의 이름은 키의 문자입니다. 제어 키(control-key) 조합의 이름은 캐럿(`b'^'`)과 그 뒤에오는 해당 인쇄 가능한 ASCII 문자로 구성된 2바이트 바이트열 객체입니다. 대체 키(alt-key) 조합(128–255)의 이름은 접두사 `b'M-'`와 그 뒤에 오는 해당 ASCII 문자의 이름으로 구성되는 바이트열 객체입니다.

`curses.``killchar`()

  사용자의 현재 줄 삭제 문자(line kill character)를 1바이트 바이트열 객체로 반환합니다. 유닉스 운영 체제에서 이는 curses 프로그램의 제어 tty의 특성이며, curses 라이브러리 자체에 의해 설정되지 않습니다.

`curses.``longname`()

  현재 터미널을 설명하는 terminfo 긴 이름 필드를 포함하는 바이트열 객체를 반환합니다. 자세한 설명의 최대 길이는 128자입니다. `initscr()`을 호출한 후에만 정의됩니다.

`curses.``meta`(flag)

  flag가 `True`이면, 8비트 문자 입력을 허용합니다. flag가 `False`이면 7비트 문자만 허용합니다.

`curses.``mouseinterval`(interval)

  클릭으로 인식되기 위해 눌림(press)과 해제(release) 이벤트 사이에 지날 수 있는 최대 시간을 밀리초 단위로 설정하고, 이전 간격 값을 반환합니다. 기본값은 200 msec, 즉 1/5초입니다.

`curses.``mousemask`(mousemask)

  마우스 이벤트가 보고되도록 설정하고, 튜플 `(availmask, oldmask)`를 반환합니다. availmask는 지정된 마우스 이벤트 중 보고 할 수 있는 것을 나타냅니다; 완전히 실패하면 `0`을 반환합니다. oldmask는 주어진 창의 마우스 이벤트 마스크의 이전 값입니다. 이 함수를 한 번도 호출하지 않으면, 마우스 이벤트가 보고되지 않습니다.

`curses.``napms`(ms)

  ms 밀리초 동안 휴면합니다.

`curses.``newpad`(nlines, ncols)

  주어진 수의 행과 열로 새로운 패드 데이터 구조에 대한 포인터를 만들고 반환합니다. 패드를 창 객체로 반환합니다.

  패드는 화면 크기에 의해 제한되지 않으며, 화면의 특정 부분과 반드시 관련될 필요는 없다는 점을 제외하면 창과 같습니다. 큰 창이 필요할 때 패드를 사용할 수 있으며, 한 번에 창의 일부만 화면에 표시됩니다. 패드의 자동 새로 고침(가령 스크롤이나 입력 반향)은 일어나지 않습니다. 패드의 `refresh()`와 `noutrefresh()` 메서드는 표시할 패드의 부분과 표시할 화면의 위치를 지정하기 위해 6개의 인자가 필요합니다. 인자는 pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol입니다; p 인자는 표시할 패드 영역의 왼쪽 위 모서리를 가리키고, s 인자는 패드 영역이 표시될 화면 위의 클리핑 상자를 정의합니다.

`curses.``newwin`(nlines, ncols)
`curses.``newwin`(nlines, ncols, begin_y, begin_x)

  왼쪽 위 모서리가 `(begin_y, begin_x)`이고, 높이/너비가 nlines/ncols 인 새 창을 반환합니다.

  기본적으로, 창은 지정된 위치에서 화면 오른쪽 하단으로 확장됩니다.

`curses.``nl`()

  줄 바꿈(newline) 모드로 들어갑니다. 이 모드는 입력에서 리턴 키를 줄 바꿈으로 변환하고, 출력에서 줄 바꿈을 리턴(return)과 줄 넘김(line-feed)으로 변환합니다. 줄 바꿈 모드는 처음에 켜져 있습니다.

`curses.``nocbreak`()

  cbreak 모드를 종료합니다. 줄 버퍼링을 사용하는 일반 “요리된(cooked)” 모드로 돌아갑니다.

`curses.``noecho`()

  반향 모드를 종료합니다. 입력 문자 반향이 꺼집니다.

`curses.``nonl`()

  줄 바꿈 모드를 종료합니다. 입력에서 리턴을 줄 바꿈으로 변환하는 것을 비활성화하고, 출력에서 줄 바꿈을 줄 바꿈/리턴으로 저수준 변환하는 것을 비활성화합니다 (그러나 이것은 `addch('\n')`의 동작을 변경하지는 않는데, 항상 가상 화면에서 리턴(return)과 줄 넘김(line feed)에 동등한 역할을 합니다). 변환이 꺼져 있으면, curses가 때로 수직 동작 속도를 약간 올릴 수 있습니다; 또한, 입력에서 리턴 키를 감지할 수 있습니다.

`curses.``noqiflush`()

  `noqiflush()` 루틴이 사용되면, `INTR`, `QUIT` 및 `SUSP` 문자와 연관된 입력과 출력 큐의 일반 플러시가 수행되지 않습니다. 처리기가 종료한 후, 인터럽트가 발생하지 않은 것처럼 출력을 계속하려면 시그널 처리기에서 `noqiflush()`를 호출할 수 있습니다.

`curses.``noraw`()

  원시(raw) 모드를 종료합니다. 줄 버퍼링을 사용하는 일반 “요리된(cooked)” 모드로 돌아갑니다.

`curses.``pair_content`(pair_number)

  요청된 색상 쌍의 색상이 포함된 튜플 `(fg, bg)`를 반환합니다. pair_number의 값은 `0`과 `COLOR_PAIRS - 1` 사이여야 합니다.

`curses.``pair_number`(attr)

  속성값 attr로 설정된 색상 쌍의 번호를 반환합니다. `color_pair()`는 이 함수의 역입니다.

`curses.``putp`(str)

  `tputs(str, 1, putchar)`와 동등합니다; 현재 터미널에 대해 지정된 terminfo 기능의 값을 내보냅니다. `putp()`의 출력은 항상 표준 출력을 향함에 유의하십시오.

`curses.``qiflush`([flag])

  flag가 `False`이면, 효과는 `noqiflush()`를 호출하는 것과 같습니다. flag가 `True`이거나, 인자가 제공되지 않으면, 이러한 제어 문자를 읽을 때 큐가 플러시 됩니다.

`curses.``raw`()

  원시(raw) 모드로 들어갑니다. 원시 모드에서는, 일반 줄 버퍼링과 인터럽트, 종료, 일시 중단 및 흐름 제어 키 처리가 꺼집니다; curses 입력 함수로 문자가 한 번에 하나씩 제시됩니다.

`curses.``reset_prog_mode`()

  `def_prog_mode()`로 이전에 저장한 대로, 터미널을 “프로그램(program)” 모드로 복원합니다.

`curses.``reset_shell_mode`()

  `def_shell_mode()`로 이전에 저장한 대로, 터미널을 “셸(shell)” 모드로 복원합니다.

`curses.``resetty`()

  터미널 모드의 상태를 `savetty()`에 대한 마지막 호출 때의 상태로 복원합니다.

`curses.``resize_term`(nlines, ncols)

  `resizeterm()`이 사용하는 백 엔드 함수로, 대부분의 작업을 수행합니다; 창 크기를 조정할 때, `resize_term()`은 확장되는 영역을 공백으로 채웁니다. 호출하는 응용 프로그램은 이러한 영역을 적절한 데이터로 채워야 합니다. `resize_term()` 함수는 모든 창의 크기를 조정하려고 합니다. 그러나, 패드의 호출 규칙으로 인해, 응용 프로그램과의 추가 상호 작용 없이 이들의 크기를 조정할 수 없습니다.

`curses.``resizeterm`(nlines, ncols)

  표준과 현재 창의 크기를 지정된 크기로 조정하고, 창 크기를 기록하는 curses 라이브러리에서 사용하는 다른 관리 데이터를 조정합니다 (특히 SIGWINCH 처리기).

`curses.``savetty`()

  터미널 모드의 현재 상태를 `resetty()`에서 사용 가능한 버퍼에 저장합니다.

`curses.``get_escdelay`()

  `set_escdelay()`로 설정된 값을 가져옵니다.

  버전 3.9에 추가.

`curses.``set_escdelay`(ms)

  키보드에 입력된 개별 이스케이프 문자와 커서와 기능키로 전송된 이스케이프 시퀀스를 구별하기 위해, 이스케이프 문자를 읽은 후 기다릴 밀리초 수를 설정합니다.

  버전 3.9에 추가.

`curses.``get_tabsize`()

  `set_tabsize()`로 설정된 값을 가져옵니다.

  버전 3.9에 추가.

`curses.``set_tabsize`(size)

  탭을 창에 추가해서 탭 문자를 스페이스로 변환할 때 curses 라이브러리가 사용하는 열 수를 설정합니다.

  버전 3.9에 추가.

`curses.``setsyx`(y, x)

  가상 화면 커서를 y, x로 설정합니다. y와 x가 모두 `-1`이면, `leaveok`는 `True`로 설정됩니다.

`curses.``setupterm`(term=None, fd=- 1)

  터미널을 초기화합니다. term은 터미널 이름을 제공하는 문자열이거나 `None`입니다; 생략되거나 `None`이면, `TERM` 환경 변수의 값이 사용됩니다. fd는 초기화 시퀀스가 전송될 파일 기술자입니다; 제공되지 않거나 `-1`이면, `sys.stdout`의 파일 기술자가 사용됩니다.

`curses.``start_color`()

  프로그래머가 색상을 사용하려면, 다른 색상 조작 루틴을 호출하기 전에 호출해야 합니다. `initscr()` 직후 이 루틴을 호출하는 것이 좋습니다.

  `start_color()`는 8개의 기본 색상(검정, 빨강, 녹색, 노랑, 파랑, 마젠타, 시안 및 흰색)과 터미널이 지원할 수 있는 색상과 색상 쌍의 최댓값인 `curses` 모듈의 2개의 전역 변수 `COLORS`와 `COLOR_PAIRS`를 초기화합니다. 또한 터미널의 전원을 켰을 때의 값으로 터미널의 색상을 복원합니다.

`curses.``termattrs`()

  터미널이 지원하는 모든 비디오 속성의 논리적 OR를 반환합니다. 이 정보는 curses 프로그램이 화면 모양을 완전히 제어해야 할 때 유용합니다.

`curses.``termname`()

  환경 변수 `TERM`의 값을 14자로 잘린 바이트열 객체로 반환합니다.

`curses.``tigetflag`(capname)

  terminfo 기능 이름 capname에 해당하는 불리언 기능의 값을 정수로 반환합니다. capname이 불리언 기능이 아니면 `-1` 값을, 터미널 설명에서 취소되었거나 빠졌으면 `0`을 반환합니다.

`curses.``tigetnum`(capname)

  terminfo 기능 이름 capname에 해당하는 숫자 기능의 값을 정수로 반환합니다. capname이 숫자 기능이 아니면 `-2` 값을, 터미널 설명에서 취소되었거나 빠졌으면 `-1`을 반환합니다.

`curses.``tigetstr`(capname)

  terminfo 기능 이름 capname에 해당하는 문자열 기능의 값을 바이트열 객체로 반환합니다. capname이 terminfo “문자열 기능”이 아니거나, 터미널 설명에서 취소되었거나 빠졌으면 `None`을 반환합니다.

`curses.``tparm`(str[, ...])

  제공된 매개 변수를 사용하여 바이트열 객체 str을 인스턴스 화합니다. 여기서 str은 terminfo 데이터베이스에서 얻은 매개 변수화된 문자열이어야 합니다. 예를 들어 `tparm(tigetstr("cup"), 5, 3)`은 `b'\033[6;4H'`가 될 수 있습니다, 정확한 결과는 터미널 유형에 따라 다릅니다.

`curses.``typeahead`(fd)

  파일 기술자 fd가 선행 입력 검사(typeahead checking)에 사용되도록 지정합니다. fd가 `-1`이면, 선행 입력 검사가 수행되지 않습니다.

  curses 라이브러리는 화면을 갱신하는 동안 정기적으로 선행 입력을 들여다보고 “라인 브레이크 아웃 최적화(line-breakout optimization)”를 수행합니다. 입력이 발견되고, 그것이 tty에서 왔으면, refresh나 doupdate가 다시 호출될 때까지 현재 갱신을 연기해서, 앞서 입력된 명령에 더 빠르게 응답 할 수 있도록 합니다. 이 함수를 사용하면 선행 입력 검사를 위해 다른 파일 기술자를 지정할 수 있습니다.

`curses.``unctrl`(ch)

  문자 ch의 인쇄 가능한 표현인 바이트열 객체를 반환합니다. 제어 문자는 캐럿과 그 뒤에 오는 문자로 표시됩니다, 예를 들어 `b'^C'`. 인쇄 문자는 그대로 남아 있습니다.

`curses.``ungetch`(ch)

  다음 `getch()`가 반환하도록 ch를 푸시합니다.

  참고

  `getch()`가 호출되기 전에 하나의 ch 만 푸시할 수 있습니다.

`curses.``update_lines_cols`()

  `LINES`와 `COLS`를 갱신합니다. 수동 화면 크기 조정을 감지하는 데 유용합니다.

  버전 3.5에 추가.

`curses.``unget_wch`(ch)

  다음 `get_wch()`가 반환하도록 ch를 푸시합니다.

  참고

  `get_wch()`가 호출되기 전에 하나의 ch 만 푸시할 수 있습니다.

  버전 3.3에 추가.

`curses.``ungetmouse`(id, x, y, z, bstate)

  주어진 상태 데이터와 결합하여, `KEY_MOUSE` 이벤트를 입력 큐로 푸시합니다.

`curses.``use_env`(flag)

  사용되면, 이 함수는 `initscr()`이나 newterm을 호출하기 전에 호출해야 합니다. flag가 `False`이면, 환경 변수 `LINES`와 `COLUMNS`(기본적으로 사용됩니다)가 설정되어 있거나, 창에서 curses가 실행 중인 경우(이때 기본 동작은 `LINES`와 `COLUMNS`가 설정되지 않았으면 창 크기를 사용하는 것입니다)에도 terminfo 데이터베이스에 지정된 행(lines)과 열(columns)의 값이 사용됩니다.

`curses.``use_default_colors`()

  이 기능을 지원하는 터미널에서 색상의 기본값을 사용하도록 허용합니다. 응용 프로그램에서 투명성을 지원하려면 이를 사용하십시오. 기본 색상은 색상 번호 `-1`에 할당됩니다. 이 함수를 호출하면, 예를 들어 `init_pair(x, curses.COLOR_RED, -1)`은 기본 배경 위의 빨간 전경색으로 색상 쌍 x를 초기화합니다.

`curses.``wrapper`(func, /, *args, **kwargs)

  curses를 초기화하고 다른 콜러블 객체 func를 호출하는데, 이 콜러블은 curses를 사용하는 응용 프로그램의 나머지 부분이어야 합니다. 응용 프로그램에서 예외가 발생하면, 이 함수는 예외를 다시 발생시키고 트레이스백을 생성하기 전에 터미널을 정상 상태로 복원합니다. 콜러블 객체 func는 메인 창 ‘stdscr’을 첫 번째 인자로 전달받고 `wrapper()`로 전달된 다른 모든 인자가 그 뒤를 따릅니다. func를 호출하기 전에, `wrapper()`는 cbreak 모드를 켜고, 반향을 끄고, 터미널 키패드를 활성화하고, 터미널에 색상이 지원되면 색상을 초기화합니다. 빠져나갈 때 (정상인지 예외로 인한 것인지 관계없이) 요리된(cooked) 모드를 복원하고, 반향을 켜고, 터미널 키패드를 비활성화합니다.

## 창 객체

위의 `initscr()`과 `newwin()`에 의해 반환된 창 객체에는 다음과 같은 메서드와 어트리뷰트가 있습니다:

`window.``addch`(ch[, attr])
`window.``addch`(y, x, ch[, attr])

  속성 attr로 `(y, x)`에 문자 ch를 그려서, 그 위치에 이전에 그린 문자를 덮어씁니다. 기본적으로, 문자 위치와 속성은 창 객체의 현재 설정입니다.

  참고

  창, 하위 창(subwindow) 또는 패드 외부에 쓰면 `curses.error`가 발생합니다. 창, 하위 창 또는 패드의 오른쪽 하단에 쓰려고 하면 문자가 인쇄된 후 예외가 발생합니다.

`window.``addnstr`(str, n[, attr])
`window.``addnstr`(y, x, str, n[, attr])

  `(y, x)`에 문자열 str의 최대 n 문자를 속성 attr로 그려, 이전 디스플레이의 내용을 덮어씁니다.

`window.``addstr`(str[, attr])
`window.``addstr`(y, x, str[, attr])

  `(y, x)`에 문자열 str을 속성 attr로 그려, 이전 디스플레이의 내용을 덮어씁니다.

  참고

  - 창, 하위 창 또는 패드 외부에 쓰면 `curses.error`가 발생합니다. 창, 하위 창 또는 패드의 오른쪽 하단에 쓰려고 하면 문자열이 인쇄된 후 예외가 발생합니다.

  - 이 파이썬 모듈의 백 엔드인 ncurses에 있는 버그가 창 크기를 조정할 때 세그멘테이션 오류를 유발할 수 있습니다. 이것은 ncurses-6.1-20190511에서 수정되었습니다. 이전 ncurses에 갇혀 있다면, 줄 바꿈이 포함된 str로 `addstr()`을 호출하지 않으면 트리거를 피할 수 있습니다. 대신, 줄마다 `addstr()`을 따로 호출하십시오.

`window.``attroff`(attr)

  현재 창에 대한 모든 쓰기에 적용된 “배경(background)” 집합에서 속성 attr을 제거합니다.

`window.``attron`(attr)

  현재 창에 대한 모든 쓰기에 적용된 “배경(background)” 집합에 속성 attr을 추가합니다.

`window.``attrset`(attr)

  속성의 “배경(background)” 집합을 attr로 설정합니다. 이 집합은 처음에 `0`입니다 (속성 없음).

`window.``bkgd`(ch[, attr])

  창의 배경 속성을 attr 속성을 가진 문자 ch로 설정합니다. 그런 다음 해당 창의 모든 문자 위치에 변경 사항이 적용됩니다:

  - 창의 모든 문자 속성이 새 배경 속성으로 변경됩니다.

  - 이전 배경 문자가 나타날 때마다, 새 배경 문자로 변경됩니다.

`window.``bkgdset`(ch[, attr])

  창의 배경을 설정합니다. 창의 배경은 문자와 속성의 모든 조합으로 구성됩니다. 배경의 속성 부분은 창에 쓰인 모든 비 공백 문자와 결합(OR)합니다. 배경의 문자와 속성 부분은 모두 공백 문자와 결합합니다. 배경은 문자의 속성이 되고 스크롤과 줄/문자 삽입/삭제 연산을 통해 문자와 함께 이동합니다.

`window.``border`([ls[, rs[, ts[, bs[, tl[, tr[, bl[, br]]]]]]]])

  창의 가장자리 주위에 테두리를 그립니다. 각 매개 변수는 테두리의 특정 부분에 사용할 문자를 지정합니다; 자세한 내용은 아래 표를 참조하십시오.

  참고

  모든 매개 변수의 `0` 값은 해당 매개 변수에 기본 문자가 사용되도록 합니다. 키워드 매개 변수는 사용할 수 없습니다. 기본값은 이 표에 나열되어 있습니다:

  매개 변수 | 설명 | 기본값
  --- | --- | ---
  ls | 좌변 | `ACS_VLINE`
  rs | 우변 | `ACS_VLINE`
  ts | 상단 | `ACS_HLINE`
  bs | 하단 | `ACS_HLINE`
  tl | 왼쪽 위 모서리 | `ACS_ULCORNER`
  tr | 오른쪽 위 모서리 | `ACS_URCORNER`
  bl | 왼쪽 아래 모서리 | `ACS_LLCORNER`
  br | 오른쪽 아래 모서리 | `ACS_LRCORNER`

`window.``box`([vertch, horch])

  `border()`와 유사하지만, ls와 rs가 모두 vertch이고 ts와 bs가 모두 horch입니다. 이 함수는 항상 기본 모서리 문자를 사용합니다.

`window.``chgat`(attr)
`window.``chgat`(num, attr)
`window.``chgat`(y, x, attr)
`window.``chgat`(y, x, num, attr)

  현재 커서 위치나 제공되면 `(y, x)` 위치에 num 문자의 속성을 설정합니다. num이 제공되지 않거나 `-1`이면, 줄 끝까지의 모든 문자에 속성이 설정됩니다. 이 함수는 제공되면 커서를 `(y, x)` 위치로 이동합니다. 변경된 줄을 `touchline()` 메서드를 사용하여 터치해서 다음 창 refresh로 내용이 다시 표시됩니다.

`window.``clear`()

  `erase()`와 유사하지만, `refresh()`를 다음에 호출할 때 전체 창이 다시 그려집니다.

`window.``clearok`(flag)

  flag가 `True`이면, `refresh()`에 대한 다음 호출은 창을 완전히 지웁니다.

`window.``clrtobot`()

  커서에서 창끝까지 지웁니다: 커서 아래의 모든 줄이 삭제된 다음, `clrtoeol()`과 동등한 것이 수행됩니다.

`window.``clrtoeol`()

  커서에서 줄 끝까지 지웁니다.

`window.``cursyncup`()

  창의 현재 커서 위치를 반영하도록 창의 모든 조상의 현재 커서 위치를 갱신합니다.

`window.``delch`([y, x])

  `(y, x)`에서 문자를 삭제합니다.

`window.``deleteln`()

  커서 아래의 줄을 삭제합니다. 다음 줄은 모두 한 줄씩 위로 이동합니다.

`window.``derwin`(begin_y, begin_x)
`window.``derwin`(nlines, ncols, begin_y, begin_x)

  “창 파생(derive window)”의 약어인 `derwin()`은 `subwin()`을 호출하는 것과 같지만, begin_y와 begin_x가 전체 화면에 상대적이 아니라 창의 원점에 상대적이라는 차이가 있습니다. 파생된 창에 대한 창 객체를 반환합니다.

`window.``echochar`(ch[, attr])

  attr 속성을 가진 문자 ch를 추가하고, 즉시 창에서 `refresh()`를 호출합니다.

`window.``enclose`(y, x)

  주어진 화면 상대적인 문자 셀 좌표 쌍이 주어진 창에 속하는지를 검사하고, `True`나 `False`를 반환합니다. 마우스 이벤트의 위치를 포함하는 화면 창의 부분 집합을 결정하는 데 유용합니다.

  버전 3.10에서 변경: Previously it returned `1` or `0` instead of `True` or `False`.

`window.``encoding`

  메서드 인자(유니코드 문자열과 문자)를 인코딩하는 데 사용되는 인코딩. encoding 어트리뷰트는 하위 창(subwindow)을 만들 때 (예를 들어 `window.subwin()`으로) 부모 창에서 상속됩니다. 기본적으로, 로케일 인코딩이 사용됩니다 (`locale.getpreferredencoding()`를 참조하십시오).

  버전 3.3에 추가.

`window.``erase`()

  창을 지웁니다.

`window.``getbegyx`()

  왼쪽 위 모서리 좌표의 튜플 `(y, x)`를 반환합니다.

`window.``getbkgd`()

  주어진 창의 현재 배경 문자/속성 쌍을 반환합니다.

`window.``getch`([y, x])

  문자를 얻습니다. 반환된 정수는 ASCII 범위일 필요가 없음에 유의하십시오: 기능키, 키패드 키 등은 255보다 큰 숫자로 표시됩니다. 지연 없는(no-delay) 모드에서, 입력이 없으면 `-1`을 반환하고, 그렇지 않으면 키가 눌릴 때까지 기다립니다.

`window.``get_wch`([y, x])

  와이드 문자(wide character)를 얻습니다. 대부분의 키에 대해서는 문자를 반환하고, 기능키, 키패드 키 및 기타 특수키에 대해서는 정수를 반환합니다. 지연 없는(no-delay) 모드에서, 입력이 없으면 예외를 발생시킵니다.

  버전 3.3에 추가.

`window.``getkey`([y, x])

  문자를 얻습니다. `getch()`처럼 정수를 반환하는 대신 문자열을 반환합니다. 기능키, 키패드 키 및 기타 특수키는 키 이름이 포함된 멀티 바이트 문자열을 반환합니다. 지연 없는(no-delay) 모드에서, 입력이 없으면 예외를 발생시킵니다.

`window.``getmaxyx`()

  창의 높이와 너비의 튜플 `(y, x)`를 반환합니다.

`window.``getparyx`()

  부모 창에 대해 상대적인 이 창의 시작 좌표를 튜플 `(y, x)`로 반환합니다. 이 창에 부모가 없으면 `(-1, -1)`을 반환합니다.

`window.``getstr`()
`window.``getstr`(n)
`window.``getstr`(y, x)
`window.``getstr`(y, x, n)

  프리미티브 줄 편집 용량으로, 사용자로부터 바이트열 객체를 읽습니다.

`window.``getyx`()

  창의 왼쪽 위 모서리에 상대적인 현재 커서 위치의 튜플 `(y, x)`를 반환합니다.

`window.``hline`(ch, n)
`window.``hline`(y, x, ch, n)

  문자 ch로 구성된 길이 n의 `(y, x)`에서 시작하는 수평선을 표시합니다.

`window.``idcok`(flag)

  flag가 `False`이면, curses는 더는 터미널의 하드웨어 문자 삽입/삭제 기능 사용을 고려하지 않습니다; flag가 `True`이면, 문자 삽입과 삭제 사용이 활성화됩니다. curses가 처음 초기화될 때, 기본적으로 문자 삽입/삭제 사용이 활성화됩니다.

`window.``idlok`(flag)

  flag가 `True`이면, `curses`는 하드웨어 줄 편집 기능을 시도하고 사용합니다. 그렇지 않으면, 줄 삽입/삭제가 비활성화됩니다.

`window.``immedok`(flag)

  flag가 `True`이면, 창 이미지의 모든 변경이 자동으로 창을 새로 고칩니다; 더는 `refresh()`를 직접 호출할 필요가 없습니다. 그러나, wrefresh 호출이 반복되어, 성능이 크게 저하될 수 있습니다. 이 옵션은 기본적으로 비활성화되어 있습니다.

`window.``inch`([y, x])

  창의 주어진 위치에 있는 문자를 반환합니다. 하위 8비트는 문자이고, 상위 비트는 속성입니다.

`window.``insch`(ch[, attr])
`window.``insch`(y, x, ch[, attr])

  속성 attr로 `(y, x)`에 문자 ch를 그리면서, x 위치에서 한 문자씩 오른쪽으로 줄을 이동합니다.

`window.``insdelln`(nlines)

  현재 줄 위의 지정된 창에 nlines 줄을 삽입합니다. nlines 바닥 줄은 손실됩니다. 음의 nlines의 경우, 커서 아래에 있는 줄에서 시작하여 nlines 줄을 삭제하고, 나머지 줄을 위로 이동합니다. 바닥 nlines 줄이 지워집니다. 현재 커서 위치는 같게 유지됩니다.

`window.``insertln`()

  커서 아래에 빈 줄을 삽입합니다. 그다음 모든 줄은 한 줄 아래로 이동합니다.

`window.``insnstr`(str, n[, attr])
`window.``insnstr`(y, x, str, n[, attr])

  커서 아래의 문자 앞에 최대 n 문자까지 문자열(줄에 맞는 최대 문자)을 삽입합니다. n이 0이거나 음수이면, 전체 문자열이 삽입됩니다. 커서 오른쪽의 모든 문자가 오른쪽으로 이동하고, 줄의 가장 오른쪽 문자들이 손실됩니다. 커서 위치는 변경되지 않습니다 (지정되면, y, x로 이동한 후에).

`window.``insstr`(str[, attr])
`window.``insstr`(y, x, str[, attr])

  커서 아래의 문자 앞에 문자열(줄에 맞는 최대 문자)을 삽입합니다. 커서 오른쪽의 모든 문자가 오른쪽으로 이동하고, 줄의 가장 오른쪽 문자들이 손실됩니다. 커서 위치는 변경되지 않습니다 (지정되면, y, x로 이동한 후에).

`window.``instr`([n])
`window.``instr`(y, x[, n])

  현재 커서 위치에서 시작하거나 지정되면 y, x에서 시작하여 창에서 추출된 문자의 바이트열 객체를 반환합니다. 문자에서 속성이 제거됩니다. n이 지정되면, `instr()`은 최대 n 문자의 문자열을 반환합니다 (끝의 NUL은 제외합니다).

`window.``is_linetouched`(line)

  `refresh()`에 대한 마지막 호출 이후 지정된 줄이 수정되었으면 `True`를 반환합니다; 그렇지 않으면 `False`를 반환합니다. 주어진 창에서 line이 유효하지 않으면 `curses.error` 예외를 발생시킵니다.

`window.``is_wintouched`()

  `refresh()`에 대한 마지막 호출 이후 지정된 창이 수정되었으면 `True`를 반환합니다; 그렇지 않으면 `False`를 반환합니다.

`window.``keypad`(flag)

  flag가 `True`이면, 일부 키(키패드, 기능키)가 생성한 이스케이프 시퀀스를 `curses`가 해석합니다. flag가 `False`이면, 이스케이프 시퀀스는 입력 스트림에 그대로 남아 있습니다.

`window.``leaveok`(flag)

  flag가 `True`이면, 커서는 “커서 위치”가 아니라 갱신 중인 위치에 남아 있습니다. 가능하면 커서 이동이 줄어듭니다. 가능하면 커서가 보이지 않게 합니다.

  flag가 `False`이면, 커서는 갱신 후 항상 “커서 위치”에 있게 됩니다.

`window.``move`(new_y, new_x)

  커서를 `(new_y, new_x)`로 이동합니다.

`window.``mvderwin`(y, x)

  창을 부모 창 내부로 이동합니다. 창의 화면에 상대적인 매개 변수는 변경되지 않습니다. 이 루틴은 부모 창의 다른 부분을 화면에서 같은 물리적 위치에 표시하는 데 사용됩니다.

`window.``mvwin`(new_y, new_x)

  왼쪽 위 모서리가 `(new_y, new_x)`가 되도록 창을 이동합니다.

`window.``nodelay`(flag)

  flag가 `True`이면, `getch()`가 비 블로킹이 됩니다.

`window.``notimeout`(flag)

  flag가 `True`이면, 이스케이프 시퀀스가 시간 초과하지 않습니다.

  flag가 `False`이면, 몇 밀리초 후에, 이스케이프 시퀀스가 해석되지 않고, 그대로 입력 스트림에 남아 있습니다.

`window.``noutrefresh`()

  새로 고침을 표시하지만 기다립니다. 이 함수는 원하는 창의 상태를 나타내는 데이터 구조를 갱신하지만, 물리적 화면을 강제로 갱신하지는 않습니다. 이를 위해서는, `doupdate()`를 호출하십시오.

`window.``overlay`(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])

  destwin 위에 창을 오버레이 합니다. 창의 크기가 같을 필요는 없으며, 겹치는 영역만 복사됩니다. 이 복사는 비 파괴적인데, 현재 배경 문자가 destwin의 이전 내용을 덮어쓰지 않습니다.

  복사되는 영역을 세밀하게 제어하기 위해, `overlay()`의 두 번째 형식을 사용할 수 있습니다. sminrow와 smincol은 소스 창의 왼쪽 위 좌표이며, 다른 변수들은 대상 창의 사각형을 표시합니다.

`window.``overwrite`(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])

  destwin 위에 창을 덮어씁니다. 창의 크기가 같을 필요는 없으며, 이 경우 겹치는 영역만 복사됩니다. 이 복사는 파괴적인데, 현재 배경 문자가 destwin의 이전 내용을 덮어씁니다.

  복사된 영역을 세밀하게 제어하기 위해, `overwrite()`의 두 번째 형식을 사용할 수 있습니다. sminrow와 smincol은 소스 창의 왼쪽 위 좌표이며, 다른 변수들은 대상 창의 사각형을 표시합니다.

`window.``putwin`(file)

  창과 연관된 모든 데이터를 제공된 파일 객체에 기록합니다. 이 정보는 나중에 `getwin()` 함수를 사용하여 가져올 수 있습니다.

`window.``redrawln`(beg, num)

  beg 줄에서 시작하는 num 화면 줄이 손상되었으며 다음 `refresh()` 호출에서 완전히 다시 그려야 함을 나타냅니다.

`window.``redrawwin`()

  전체 창을 터치하여, 다음 `refresh()` 호출에서 완전히 다시 그려지도록 합니다.

`window.``refresh`([pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol])

  화면을 즉시 갱신합니다 (이전 그리기/삭제 메서드와 실제 화면을 동기화합니다).

  6개의 선택적 인자는 창이 `newpad()`로 만들어진 패드일 때만 지정할 수 있습니다. 추가 매개 변수는 패드와 화면의 어떤 부분이 관련되어 있는지를 나타내기 위해 필요합니다. pminrow와 pmincol은 패드에서 표시할 사각형의 왼쪽 위 모서리를 지정합니다. sminrow, smincol, smaxrow 및 smaxcol은 화면에 표시할 사각형의 변을 지정합니다. 사각형의 크기가 같아야 해서, 패드에서 표시할 사각형의 오른쪽 아래 모서리는 화면 좌표에서 계산됩니다. 두 사각형 모두 해당 구조 내에 완전히 포함되어야 합니다. pminrow, pmincol, sminrow 또는 smincol의 음수 값은 마치 0인 것처럼 처리됩니다.

`window.``resize`(nlines, ncols)

  curses 창의 스토리지를 재할당하여 지정된 값으로 크기를 조정합니다. 두 크기 중 하나가 현재 값보다 크면, 창의 데이터는 현재 배경 변환 (`bkgdset()`으로 설정한)을 갖는 공백으로 채워집니다.

`window.``scroll`([lines=1])

  화면이나 스크롤 영역을 lines 줄 위로 스크롤 합니다.

`window.``scrollok`(flag)

  맨 아래 줄에서의 줄 바꾸기나 마지막 줄의 마지막 문자 입력의 결과로, 창의 커서가 창이나 스크롤 영역의 경계를 벗어날 때 어떻게 할지를 제어합니다. flag가 `False`이면, 맨 아래 줄에 남습니다. flag가 `True`이면, 창은 한 줄 위로 스크롤 됩니다. 터미널에서 물리적 스크롤 효과를 얻으려면, `idlok()`도 호출해야 함에 유의하십시오.

`window.``setscrreg`(top, bottom)

  스크롤 영역을 top 줄에서 bottom 줄로 설정합니다. 모든 스크롤 작업은 이 영역에서 수행됩니다.

`window.``standend`()

  스탠드 아웃(standout) 속성을 끕니다. 일부 터미널에서는 모든 속성을 끄는 부작용이 있습니다.

`window.``standout`()

  속성 A_STANDOUT을 켭니다.

`window.``subpad`(begin_y, begin_x)
`window.``subpad`(nlines, ncols, begin_y, begin_x)

  왼쪽 위 모서리가 `(begin_y, begin_x)`이고, 너비/높이가 ncols/nlines인 서브 창을 반환합니다.

`window.``subwin`(begin_y, begin_x)
`window.``subwin`(nlines, ncols, begin_y, begin_x)

  왼쪽 위 모서리가 `(begin_y, begin_x)`이고, 너비/높이가 ncols/nlines인 서브 창을 반환합니다.

  기본적으로, 서브 창은 지정된 위치에서 창의 오른쪽 아래 모서리에 이릅니다.

`window.``syncdown`()

  조상 창에서 터치된 창의 각 위치를 터치합니다. 이 루틴은 `refresh()`에 의해 호출되므로, 수동으로 호출할 필요가 거의 없습니다.

`window.``syncok`(flag)

  flag가 `True`이면, 창에 변경 사항이 있을 때마다 `syncup()`이 자동으로 호출됩니다.

`window.``syncup`()

  창에서 변경된 창 조상의 모든 위치를 터치합니다.

`window.``timeout`(delay)

  창의 블로킹이나 비 블로킹 읽기 동작을 설정합니다. delay가 음수이면, 블로킹 읽기가 사용됩니다 (입력을 무한정 기다립니다). delay가 0이면, 비 블로킹 읽기가 사용되며, 대기 중인 입력이 없으면 `getch()`는 `-1`을 반환합니다. delay가 양수이면, `getch()`는 delay 밀리초 동안 블록 하고, 해당 시간이 지나도 여전히 입력이 없으면 `-1`을 반환합니다.

`window.``touchline`(start, count[, changed])

  줄 start로 시작하여 count 줄이 변경된 것으로 가정합니다. changed가 제공되면, 영향을 받는 줄이 변경되었다고 (changed`=True`) 또는 변경되지 않았다고 (changed`=False`) 표시할지를 지정합니다.

`window.``touchwin`()

  그리기 최적화를 위해, 전체 창이 변경된 것으로 가정합니다.

`window.``untouchwin`()

  `refresh()`를 마지막으로 호출한 후에 창의 모든 줄을 변경되지 않은 것으로 표시합니다.

`window.``vline`(ch, n[, attr])
`window.``vline`(y, x, ch, n[, attr])

  Display a vertical line starting at `(y, x)` with length n consisting of the character ch with attributes attr.

## 상수

`curses` 모듈은 다음 데이터 멤버를 정의합니다:

`curses.``ERR`

  정수를 반환하는 일부 curses 루틴은 (가령 `getch()`) 실패 시 `ERR`을 반환합니다.

`curses.``OK`

  정수를 반환하는 일부 curses 루틴은 (가령 `napms()`) 성공 시 `OK`를 반환합니다.

`curses.``version`

  모듈의 현재 버전을 나타내는 바이트열 객체. `__version__`으로도 제공됩니다.

`curses.``ncurses_version`

  ncurses 라이브러리 버전의 세 가지 구성 요소를 포함하는 네임드 튜플: major, minor 및 patch. 모든 값은 정수입니다. 구성 요소는 이름으로도 액세스 할 수 있어서, `curses.ncurses_version[0]`은 `curses.ncurses_version.major`와 동등합니다.

  가용성: ncurses 라이브러리가 사용된 경우.

  버전 3.8에 추가.

문자 셀 속성을 지정하기 위해 일부 상수를 사용할 수 있습니다. 사용 가능한 정확한 상수는 시스템에 따라 다릅니다.

속성 | 의미
--- | ---
`A_ALTCHARSET` | 대체 문자 집합 모드
`A_BLINK` | 깜박임 모드
`A_BOLD` | 볼드 모드
`A_DIM` | 희미한 모드
`A_INVIS` | 보이지 않거나 공백 모드
`A_ITALIC` | 기울임 꼴 모드
`A_NORMAL` | 일반 속성
`A_PROTECT` | 보호 모드
`A_REVERSE` | 배경과 전경색 반전
`A_STANDOUT` | 눈에 띄는 모드
`A_UNDERLINE` | 밑줄 모드
`A_HORIZONTAL` | 수평 하이라이트
`A_LEFT` | 왼쪽 하이라이트
`A_LOW` | 낮은 하이라이트
`A_RIGHT` | 오른쪽 하이라이트
`A_TOP` | 상단 하이라이트
`A_VERTICAL` | 수직 하이라이트
`A_CHARTEXT` | 문자를 추출하는 비트 마스크

버전 3.7에 추가: `A_ITALIC`이 추가되었습니다.

일부 메서드에서 반환한 해당 속성을 추출하기 위해 여러 상수를 사용할 수 있습니다.

비트 마스크 | 의미
--- | ---
`A_ATTRIBUTES` | 속성을 추출하는 비트 마스크
`A_CHARTEXT` | 문자를 추출하는 비트 마스크
`A_COLOR` | 색상 쌍 필드 정보를 추출하는 비트 마스크

키는 `KEY_`로 시작하는 이름을 가진 정수 상수로 참조됩니다. 사용 가능한 정확한 키 기능은 시스템에 따라 다릅니다.

키 상수 | 키
--- | ---
`KEY_MIN` | 최소 키값
`KEY_BREAK` | 브레이크 키 (신뢰할 수 없습니다)
`KEY_DOWN` | 아래쪽 화살표
`KEY_UP` | 위쪽 화살표
`KEY_LEFT` | 왼쪽 화살표
`KEY_RIGHT` | 오른쪽 화살표
`KEY_HOME` | 홈 키 (위쪽+왼쪽 화살표)
`KEY_BACKSPACE` | 백스페이스 (신뢰할 수 없습니다)
`KEY_F0` | 기능키. 최대 64개의 기능키가 지원됩니다.
`KEY_Fn` | 기능키 n의 값
`KEY_DL` | 줄 삭제
`KEY_IL` | 줄 삽입
`KEY_DC` | 문자 삭제
`KEY_IC` | 문자 삽입이나 삽입 모드로 들어가기
`KEY_EIC` | 문자 삽입 모드 종료
`KEY_CLEAR` | 화면 지우기
`KEY_EOS` | 화면 끝까지 지우기
`KEY_EOL` | 줄 끝까지 지우기
`KEY_SF` | 한 줄 앞으로 스크롤
`KEY_SR` | 한 줄 뒤로 스크롤 (역)
`KEY_NPAGE` | 다음 페이지
`KEY_PPAGE` | 이전 페이지
`KEY_STAB` | 탭 설정
`KEY_CTAB` | 탭 지우기
`KEY_CATAB` | 모든 탭 지우기
`KEY_ENTER` | 엔터나 발송 (신뢰할 수 없습니다)
`KEY_SRESET` | 소프트(soft) (부분) 재설정 (신뢰할 수 없습니다)
`KEY_RESET` | 재설정이나 하드(hard) 재설정 (신뢰할 수 없습니다)
`KEY_PRINT` | 인쇄
`KEY_LL` | 홈 다운이나 바닥 (왼쪽 아래)
`KEY_A1` | 키패드의 왼쪽 위
`KEY_A3` | 키패드의 오른쪽 위
`KEY_B2` | 키패드 가운데
`KEY_C1` | 키패드의 왼쪽 아래
`KEY_C3` | 키패드의 오른쪽 아래
`KEY_BTAB` | 백 탭
`KEY_BEG` | Beg (시작)
`KEY_CANCEL` | 취소
`KEY_CLOSE` | 닫기
`KEY_COMMAND` | Cmd (명령)
`KEY_COPY` | 복사
`KEY_CREATE` | 생성
`KEY_END` | 끝
`KEY_EXIT` | 종료
`KEY_FIND` | 찾기
`KEY_HELP` | 도움말
`KEY_MARK` | 표시
`KEY_MESSAGE` | 메시지
`KEY_MOVE` | 이동
`KEY_NEXT` | 다음
`KEY_OPEN` | 열기
`KEY_OPTIONS` | 옵션
`KEY_PREVIOUS` | Prev (이전)
`KEY_REDO` | 다시 하기
`KEY_REFERENCE` | Ref (참조)
`KEY_REFRESH` | 새로 고침
`KEY_REPLACE` | 교체
`KEY_RESTART` | 재시작
`KEY_RESUME` | 재개
`KEY_SAVE` | 저장
`KEY_SBEG` | 시프트 Beg (시작)
`KEY_SCANCEL` | 시프트 취소
`KEY_SCOMMAND` | 시프트 명령
`KEY_SCOPY` | 시프트 복사
`KEY_SCREATE` | 시프트 생성
`KEY_SDC` | 시프트 문자 삭제
`KEY_SDL` | 시프트 줄 삭제
`KEY_SELECT` | 선택
`KEY_SEND` | 시프트 끝
`KEY_SEOL` | 시프트 줄 지우기
`KEY_SEXIT` | 시프트 종료
`KEY_SFIND` | 시프트 찾기
`KEY_SHELP` | 시프트 도움말
`KEY_SHOME` | 시프트 홈
`KEY_SIC` | 시프트 입력
`KEY_SLEFT` | 시프트 왼쪽 화살표
`KEY_SMESSAGE` | 시프트 메시지
`KEY_SMOVE` | 시프트 이동
`KEY_SNEXT` | 시프트 다음
`KEY_SOPTIONS` | 시프트 옵션
`KEY_SPREVIOUS` | 시프트 Prev
`KEY_SPRINT` | 시프트 인쇄
`KEY_SREDO` | 시프트 다시 하기
`KEY_SREPLACE` | 시프트 교체
`KEY_SRIGHT` | 시프트 오른쪽 화살표
`KEY_SRSUME` | 시프트 재개
`KEY_SSAVE` | 시프트 저장
`KEY_SSUSPEND` | 시프트 일시 중단
`KEY_SUNDO` | 시프트 실행 취소
`KEY_SUSPEND` | 일시 중단
`KEY_UNDO` | 실행 취소
`KEY_MOUSE` | 마우스 이벤트가 발생했습니다
`KEY_RESIZE` | 터미널 크기 조정 이벤트
`KEY_MAX` | 최대 키값

VT100과 이의 소프트웨어 에뮬레이션(가령 X 터미널 에뮬레이터)에는, 일반적으로 사용 가능한 기능키가 적어도 4개 (`KEY_F1`, `KEY_F2`, `KEY_F3`, `KEY_F4`) 있고, 화살표 키는 `KEY_UP`, `KEY_DOWN`, `KEY_LEFT` 및 `KEY_RIGHT`에 명백한 방식으로 매핑됩니다. 여러분의 기계에 PC 키보드가 있으면, 화살표 키와 12개의 기능키를 기대하는 것이 안전합니다 (이전 PC 키보드에는 10개의 기능키만 있을 수 있습니다); 또한, 다음과 같은 키패드 매핑이 표준입니다:

키 기능 | 상수
--- | ---
`Insert` | KEY_IC
`Delete` | KEY_DC
`Home` | KEY_HOME
`End` | KEY_END
``Page` `Up`` | KEY_PPAGE
``Page` `Down`` | KEY_NPAGE

다음 표는 대체 문자 집합의 문자를 나열합니다. 이들은 VT100 터미널에서 상속되며, 일반적으로 X 터미널과 같은 소프트웨어 에뮬레이션에서 사용할 수 있습니다. 사용 가능한 그래픽이 없으면, curses는 조잡한 인쇄 가능한 ASCII 근사치로 폴 백 합니다.

참고

`initscr()`가 호출된 후에만 사용할 수 있습니다.

ACS 코드 | 의미
--- | ---
`ACS_BBSS` | 오른쪽 위 모서리의 대체 이름
`ACS_BLOCK` | 채워진 사각형 블록
`ACS_BOARD` | 사각형의 보드
`ACS_BSBS` | 수평선의 대체 이름
`ACS_BSSB` | 왼쪽 위 모서리의 대체 이름
`ACS_BSSS` | 상단 티(top tee)의 대체 이름
`ACS_BTEE` | 하단 티(bottom tee)
`ACS_BULLET` | 불릿
`ACS_CKBOARD` | 체커 보드 (점각)
`ACS_DARROW` | 아래쪽을 가리키는 화살표
`ACS_DEGREE` | 디그리 기호
`ACS_DIAMOND` | 다이아몬드
`ACS_GEQUAL` | 크거나 같음
`ACS_HLINE` | 수평선
`ACS_LANTERN` | 랜턴 기호
`ACS_LARROW` | 왼쪽 화살표
`ACS_LEQUAL` | 작거나 같음
`ACS_LLCORNER` | 왼쪽 아래 모서리
`ACS_LRCORNER` | 오른쪽 아래 모서리
`ACS_LTEE` | 왼쪽 티(left tee)
`ACS_NEQUAL` | 같지 않음 기호
`ACS_PI` | 글자 파이(pi)
`ACS_PLMINUS` | 더하기-또는-빼기 기호
`ACS_PLUS` | 큰 더하기 기호
`ACS_RARROW` | 오른쪽 화살표
`ACS_RTEE` | 오른쪽 티(right tee)
`ACS_S1` | 스캔 줄 1
`ACS_S3` | 스캔 줄 3
`ACS_S7` | 스캔 줄 7
`ACS_S9` | 스캔 줄 9
`ACS_SBBS` | 오른쪽 아래 모서리의 대체 이름
`ACS_SBSB` | 세로줄의 대체 이름
`ACS_SBSS` | 오른쪽 티의 대체 이름
`ACS_SSBB` | 왼쪽 아래 모서리의 대체 이름
`ACS_SSBS` | 하단 티의 대체 이름
`ACS_SSSB` | 왼쪽 티의 대체 이름
`ACS_SSSS` | 크로스 오버(crossover) 또는 큰 더하기의 대체 이름
`ACS_STERLING` | 파운드 스털링(pound sterling)
`ACS_TTEE` | 상단 티(top tee)
`ACS_UARROW` | 위쪽 화살표
`ACS_ULCORNER` | 왼쪽 위 모서리
`ACS_URCORNER` | 오른쪽 위 모서리
`ACS_VLINE` | 수직선

다음 표는 사전 정의된 색상을 나열합니다:

상수 | 색상
--- | ---
`COLOR_BLACK` | 검은색
`COLOR_BLUE` | 파랑
`COLOR_CYAN` | 시안 (청록색 - 밝은 초록이 섞인 파랑)
`COLOR_GREEN` | 초록
`COLOR_MAGENTA` | 마젠타 (자홍색)
`COLOR_RED` | 빨강
`COLOR_WHITE` | 흰색
`COLOR_YELLOW` | 노랑

# `curses.textpad` — curses 프로그램을 위한 텍스트 입력 위젯

`curses.textpad` 모듈은 curses 창에서 기본 텍스트 편집을 처리하는 `Textbox` 클래스를 제공하며, Emacs와 유사한 일련의 키 바인딩을 지원합니다 (따라서 Netscape Navigator, BBedit 6.x, FrameMaker 및 기타 여러 프로그램과도 유사한). 이 모듈은 텍스트 상자의 틀이나 다른 목적에 유용한 사각형 그리기 함수도 제공합니다.

`curses.textpad` 모듈은 다음 함수를 정의합니다:

`curses.textpad.``rectangle`(win, uly, ulx, lry, lrx)

  직사각형을 그립니다. 첫 번째 인자는 창 객체여야 합니다; 나머지 인자는 그 창에 상대적인 좌표입니다. 두 번째와 세 번째 인자는 그릴 사각형의 왼쪽 위 모서리의 y와 x 좌표입니다; 네 번째와 다섯 번째 인자는 오른쪽 아래 모서리의 y와 x 좌표입니다. 사각형은 이것이 가능한 터미널(xterm과 대부분의 다른 소프트웨어 터미널 에뮬레이터를 포함합니다)에서 VT100/IBM PC 양식 문자를 사용하여 그려집니다. 그렇지 않으면 ASCII 대시, 세로 막대 및 더하기 기호로 그려집니다.

## Textbox 객체

다음과 같이 `Textbox` 객체를 인스턴스 화 할 수 있습니다:

class `curses.textpad.``Textbox`(win)

  텍스트 상자 위젯 객체를 반환합니다. win 인자는 텍스트 상자가 포함될 curses 창 객체여야 합니다. 텍스트 상자의 편집 커서는 처음에 좌표 `(0, 0)`으로 포함하는 창의 왼쪽 위 모서리에 있습니다. 인스턴스의 `stripspaces` 플래그가 처음에 켜집니다.

  `Textbox` 객체에는 다음과 같은 메서드가 있습니다:

  `edit`([validator])

    이것이 일반적으로 사용하는 진입점입니다. 종료 키 입력 중 하나를 입력할 때까지 편집 키 입력을 받아들입니다. validator가 제공되면, 반드시 함수여야 합니다. 입력한 각 키 입력에 대해 키 입력을 매개 변수로 호출됩니다; 명령 디스패치가 그 결과에 대해 수행됩니다. 이 메서드는 창 내용을 문자열로 반환합니다; 창의 공백이 포함되는지는 `stripspaces` 어트리뷰트의 영향을 받습니다.

  `do_command`(ch)

    단일 명령 키 입력을 처리합니다. 지원되는 특수키 입력은 다음과 같습니다:

    키 입력 | 동작
    --- | ---
    ``Control`-`A`` | 창의 왼쪽 가장자리로 이동합니다.
    ``Control`-`B`` | 커서를 왼쪽으로 옮깁니다, 필요하면 앞줄로 넘어갑니다.
    ``Control`-`D`` | 커서 아래의 문자를 삭제합니다.
    ``Control`-`E`` | 오른쪽 가장자리(stripspaces가 꺼졌을 때)나 줄 끝(stripspaces가 켜졌을 때)으로 이동합니다.
    ``Control`-`F`` | 커서를 오른쪽으로 옮깁니다, 필요하면 다음 줄로 넘어갑니다.
    ``Control`-`G`` | 종료하고, 창 내용을 반환합니다.
    ``Control`-`H`` | 문자를 뒤로 삭제합니다.
    ``Control`-`J`` | 창이 한 줄이면 종료하고, 그렇지 않으면 줄 바꿈을 삽입합니다.
    ``Control`-`K`` | 줄이 비어 있으면, 삭제하고, 그렇지 않으면 줄 끝까지 지웁니다.
    ``Control`-`L`` | 화면을 새로 고칩니다.
    ``Control`-`N`` | 커서를 아래로 옮깁니다; 한 줄 아래로 이동합니다.
    ``Control`-`O`` | 커서 위치에 빈 줄을 삽입합니다.
    ``Control`-`P`` | 커서를 위로 옮깁니다; 한 줄 위로 이동합니다.

    이동이 불가능한 가장자리에 커서가 있으면 이동 연산이 수행되지 않습니다. 가능하면 다음 동의어가 지원됩니다:

    상수 | 키 입력
    --- | ---
    `KEY_LEFT` | ``Control`-`B``
    `KEY_RIGHT` | ``Control`-`F``
    `KEY_UP` | ``Control`-`P``
    `KEY_DOWN` | ``Control`-`N``
    `KEY_BACKSPACE` | ``Control`-`h``

    다른 모든 키 입력은 주어진 문자를 삽입하고 (줄 넘김을 포함한) 오른쪽으로 이동하는 명령으로 처리됩니다.

  `gather`()

    창 내용을 문자열로 반환합니다; 창의 공백이 포함되는지는 `stripspaces` 멤버의 영향을 받습니다.

  `stripspaces`

    이 어트리뷰트는 창의 공백 해석을 제어하는 플래그입니다. 켜져 있으면, 각 줄의 후행 공백이 무시됩니다; 후행 공백에 커서를 놓는 커서 동작은 대신 해당 줄의 끝으로 이동하고, 창 내용이 수집될 때 후행 공백이 제거됩니다.