curs_border(3CURSES)					     Curses Library Functions					      curs_border(3CURSES)

NAME

       curs_border, border, wborder, box, whline, wvline - create curses borders, horizontal and vertical lines

SYNOPSIS

       cc [ flag ... ] file ... -lcurses [ library ... ]
       #include <curses.h>

       int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
	    chtype tr, chtype bl,chtype br);

       int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts,
	    chtype bs, chtype tl, chtype tr, chtype bl, chtype br);

       int box(WINDOW *win, chtype verch, chtype horch);

       int hline(chtype ch, int n);

       int whline(WINDOW *win, chtype ch, int n);

       int vline(chtype ch, int n);

       int wvline(WINDOW *win, chtype ch, int n);

DESCRIPTION

       With the border(), wborder(), and  box() routines, a border is drawn around the edges of the window. The arguments and attributes are:

       ls			     left side of the border
       rs			     right side of the border
       ts			     top side of the border
       bs			     bottom side of the border
       tl			     top left-hand corner
       tr			     top right-hand corner
       bl			     bottom left-hand corner
       br			     bottom right-hand corner

       If  any	of  these  arguments  is zero, then the following default values (defined in <curses.h>) are used respectively instead: ACS_VLINE,
       ACS_VLINE, ACS_HLINE, ACS_HLINE, ACS_ULCORNER, ACS_URCORNER, ACS_BLCORNER, ACS_BRCORNER.

       box(win, verch, horch) is a shorthand for the following call:

       wborder(win, verch, verch, horch, horch , 0, 0, 0, 0)

       hline() and whline() draw a horizontal (left to right) line using ch starting at the current cursor position in	the  window.  The  current
       cursor position is not changed. The line is at most n characters long, or as many as fit into the window.

       vline()	and wvline() draw a vertical (top to bottom) line using ch starting at the current cursor position in the window. The current cur-
       sor position is not changed. The line is at most n characters long, or as many as fit into the window.

RETURN VALUES

       All routines return the integer OK, or a non-negative integer if immedok() is set. See curs_outopts(3CURSES).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       curs_outopts(3CURSES), curses(3CURSES), attributes(5)

NOTES

       The header <curses.h> automatically includes the headers  <stdio.h> and <unctrl.h>.

       Note that border() and box() may be macros.

SunOS 5.11							    31 Dec 1996 					      curs_border(3CURSES)