curs_addchstr(3)

명칭
addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr, mvaddchnstr, mvwaddchstr, mvwaddchnstr - 캐릭터( 및 속성)의 string를 ncurses 윈도우에 추가한다

서식
#include <ncurses.h> int addchstr(chtype *chstr) ;
int addchnstr(chtype *chstr, int n) ;
int waddchstr(WINDOW *win, chtype *chstr) ;
int waddchnstr(WINDOW *win, chtype *chstr, int n) ;
int mvaddchstr(int y, int x, chtype *chstr) ;
int mvaddchnstr(int y, int x, chtype *chstr, int n) ;
int mvwaddchstr(WINDOW *win, int y, int x, chtype *chstr) ;
int mvwaddchnstr(WINDOW *win, int y, int x, chtype *chstr, int n) ;

해설
이러한 routine는, chstr 를, 윈도우 이미지 구조내의 현재의 커서 위치 및 커서 위치의 뒤에 카피합니다. 마지막 인수로서 n 를 가지는 4 개의 routine는, 많아도 n 개의 엘리먼트를 카피합니다만, 그것보다 많게는 행에 들어가지 않습니다. n=-1 의 경우, string 전체가, 행에 들어가는 최대 캐릭터수까지 카피됩니다. 윈도우 커서는 진행되지 않습니다. 이러한 routine는 waddnstr 보다 고속으로 기능합니다. 그러나, 사용할 경우에는 주위를 기울일 필요가 있습니다. 어떤 종류의 체크도 하지 않고 (예를 들어, 개행 캐릭터의 체크), 현재의 커서 위치를 진행시키지 않고, 오른쪽 margin와 교차하는 경우는 새로운 행에 wraparound 하지 않고 string를 잘라 버리기 때문입니다.

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

주석
waddchnstr 이외의 routine는 모두 매크로일 가능성이 있는 것에 주의해 주세요.

관련 항목
ncurses(3)