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()

getch()가 KEY_MOUSE를 반환하여 마우스 이벤트를 알린 후, 이 메서드는 대기 중인 마우스 이벤트를 꺼내기 위해 호출되어야 합니다, 이벤트는 5-튜플 (id, x, y, z, bstate)로 표현됩니다. id는 여러 장치를 구별하는 데 사용되는 ID 값이며, x, y, z는 이벤트 좌표입니다. (z는 현재 사용되지 않습니다.) bstate는 비트가 이벤트 유형을 나타내도록 설정되는 정숫값이며, 다음 상수 중 하나 이상의 비트별 OR입니다. 여기서 n은 1에서 4까지의 버튼 번호입니다: BUTTONn_PRESSED, BUTTONn_RELEASED, BUTTONn_CLICKED, BUTTONn_DOUBLE_CLICKED, BUTTONn_TRIPLE_CLICKED, BUTTON_SHIFT, BUTTON_CTRL, BUTTON_ALT.

curses.getsyx()

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

curses.getwin(file)

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

curses.has_colors()

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

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)

변경될 색상 번호와 뒤따르는 세 RGB 값(빨강, 녹색 및 파랑 성분의 양)을 취해서 색상의 정의를 변경합니다. color_number의 값은 0과 COLORS - 1 사이여야 합니다. r, g, b는 각각 0과 1000 사이의 값이어야 합니다. init_color()를 사용하면, 화면에서 해당 색상의 모든 항목이 즉시 새 정의로 변경됩니다. 이 함수는 대부분의 터미널에서 효과가 없습니다; can_change_color()가 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를 반환합니다. 마우스 이벤트의 위치를 포함하는 화면 창의 부분 집합을 결정하는 데 유용합니다.

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)

window.vline(y, x, ch, n)

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

상수

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

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