curs_addch(3)

명칭
addch, waddch, mvaddch, mvwaddch, echochar, wechochar - 캐릭터를 (속성과 함께) ncurses 윈도우에 추가하고 나서, 커서를 진행시킨다

서식
#include <ncurses.h> addch(chtype ch) ;
waddch(WINDOW *win, chtype ch) ;
mvaddch(int y, int x, chtype ch) ;
mvwaddch(WINDOW *win, int y, int x, chtype ch) ;
echochar(chtype ch) ;
wechochar(WINDOW *win, chtype ch) ;

해설
addch, waddch, mvaddch 및 mvwaddch 의 각 routine는, 지정의 윈도우의 현재의 윈도우 위치에 캐릭터 ch 를 설정해, 그 위치를 진행합니다. 이것들은 stdio(3)의 putchar 에 유사하고 있습니다. 진행이 우단 margin의 경우, 커서는 자동적으로 다음의 행의 선두에 랩 합니다. scrollok 가 유효한 경우, 스크롤 area의 하단에서는, 스크롤 area가 1 행만 위에 스크롤 합니다. ch 가 탭, 개행, 또는 백 스페이스의 경우, 커서는 윈도우 내부에서 적절히 이동 당합니다. 개행은 clrtoeol 를 실시하고 나서 이동합니다. 탭은, 8 컬럼 마다 있다고 보여집니다. ch 가 탭, 개행, 백 스페이스 이외의 제어 캐릭터의 경우, 그것은 ^X 표기로 그려집니다. 제어 캐릭터를 추가한 후에 winch 를 호출해도, 제어 캐릭터는 돌아오지 않고, 대신에 제어 캐릭터의 표현이 돌려주어집니다 (제어 캐릭터를 캐릭터 대로 보내려면 , echochar를 사용합니다). 비디오 속성은 1 개의 캐릭터와 논리합 (OR)을 취하는 것에 의해, 결합되어 파라미터에 넣을 수가 있습니다. 이 결과, 이러한 속성도 설정되게 됩니다 (여기서 의도하는 것은, 속성을 포함해 텍스트가, inch 와 addch 를 사용해, 어느 장소로부터 다른 장소에 카피할 수 있다고 하는 것입니다). [ curs_attr(3) 페이지의, 정의가 끝난 비디오 속성 정수이다 standout 를 참조해 주세요]. echochar routine와 wechochar routine는, addch 의 호출의 뒤에 refresh 의 호출이 계속된 것, 또는 waddch 의 호출의 뒤에 wrefresh 의 호출이 계속된 것과 기능적으로 동등합니다. 1 개의 캐릭터만이 출력되고 있는 것을 고려에 넣어 제어 캐릭터가 아닌 캐릭터의 경우는, 이러한 routine를, 동등의 것 대신에 사용하면(자), 성능이 큰폭으로 향상하는 일이 있습니다.

  라인 그래픽스
이후의 변수를 사용해, addch 패밀리의 routine로, 라인 묘화 캐릭터를 화면에 추가할 수 있습니다. 이하에 리스트 한 디폴트 캐릭터가 사용되는 것은, acsc 기능이 터미널 고유의 대신의 것을 정의하지 않는 경우입니다. 이름은 VT100 명명법으로부터 취해 있습니다.
명칭 | 디폴트 | 기술
ACS_ULCORNER | + | 좌상 코너
ACS_LLCORNER | + | 좌하 코너
ACS_URCORNER | + | 우상 코너
ACS_LRCORNER | + | 우하 코너
ACS_RTEE | + | 오른쪽 트리
ACS_LTEE | + | 왼쪽 트리
ACS_BTEE | + | 하단 트리
ACS_TTEE | + | 상단 트리
ACS_HLINE | - | 수평선
ACS_VLINE | | | 수직선
ACS_PLUS | + | 플러스
ACS_S1 | - | 주사선 1
ACS_S9 |  | 주사선 9
ACS_DIAMOND | + | 다이아몬드
ACS_CKBOARD | : | checker 보드 (점묘)
ACS_DEGREE | '번의 심볼
ACS_PLMINUS | # | 플러스 / 마이너스
ACS_BULLET | o | 브렛트
ACS_LARROW | < | 좌향 화살표
ACS_RARROW | > | 오른쪽 방향 화살표
ACS_DARROW | v | 하향 화살표
ACS_UARROW | ^ | 오름새 화살표
ACS_BOARD | # | 정방형의 보드
ACS_LANTERN | # | 랜턴의 심볼
ACS_BLOCK | # | 묻을 수 있었던 정방형의 블록

반환값
routine는 모두, 처리가 실패하면(자) 정수 ERR 로 돌아갑니다. 처리가 성공해 완료하면(자), ERR 이외의 정수치가 돌려주어집니다. 다만, 지금까지의 routine의 설명으로 다르도록(듯이) 주기했을 경우는 별도입니다.

버그

주석
addch, mvaddch, mvwaddch 및 echochar 는 매크로일 가능성이 있습니다. 386 으로 486 의 콘솔에서는, wechochar 에 상위 비트를 설정한 인수를 지정하면(자), 대응하는 높이가 반의 ASCIIZ 그래픽이 생성됩니다 (SVr4 curses 에도 이 특징이 있습니다만, 문서에 기재는 되고 있지 않습니다). 그러나, 제어 캐릭터 인수는 통상, 대응하는 그래픽을 작성하지 않는 것입니다. CR, NL, FF 및 TAB 와 같은 캐릭터는, 통상, 콘솔 드라이버 자체에 의해 해석되어 ESC 는 제어 순차 순서의 선두라고 해석됩니다.

관련 항목
ncurses(3), curs_attr(3), curs_clear(3), curs_inch(3), curs_outopts(3), curs_refresh(3), putc(3).