


curs_border(3X)                                   curs_border(3X)


NNAAMMEE
       ccuurrss__bboorrddeerr:  bboorrddeerr,  wwbboorrddeerr, bbooxx, hhlliinnee, wwhhlliinnee, vvlliinnee,
       wwvvlliinnee - create ccuurrsseess borders,  horizontal  and  vertical
       lines

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>
       iinntt bboorrddeerr((cchhttyyppee llss,, cchhttyyppee rrss,, cchhttyyppee ttss,, cchhttyyppee bbss,,
          cchhttyyppee ttll,, cchhttyyppee ttrr,, cchhttyyppee bbll,, cchhttyyppee bbrr));;
       iinntt wwbboorrddeerr((WWIINNDDOOWW **wwiinn,, cchhttyyppee llss,, cchhttyyppee rrss,,
          cchhttyyppee ttss,, cchhttyyppee bbss,, cchhttyyppee ttll,, cchhttyyppee ttrr,,
          cchhttyyppee bbll,, cchhttyyppee bbrr));;
       iinntt bbooxx((WWIINNDDOOWW **wwiinn,, cchhttyyppee vveerrcchh,, cchhttyyppee hhoorrcchh));;
       iinntt hhlliinnee((cchhttyyppee cchh,, iinntt nn));;
       iinntt wwhhlliinnee((WWIINNDDOOWW **wwiinn,, cchhttyyppee cchh,, iinntt nn));;
       iinntt vvlliinnee((cchhttyyppee cchh,, iinntt nn));;
       iinntt wwvvlliinnee((WWIINNDDOOWW **wwiinn,, cchhttyyppee cchh,, iinntt nn));;

DDEESSCCRRIIPPTTIIOONN
       The bboorrddeerr, wwbboorrddeerr and bbooxx routines draw a box around the
       edges of a window.  The argument _l_s  is  a  character  and
       attributes  used  for  the  left  side of the border, _r_s -
       right side, _t_s - top side, _b_s -  bottom  side,  _t_l  -  top
       left-hand  corner, _t_r - top right-hand corner, _b_l - bottom
       left-hand corner, and _b_r - bottom right-hand  corner.   If
       any of these arguments is zero, then the following default
       values (defined in ccuurrsseess..hh) are used instead:  AACCSS__VVLLIINNEE,
       AACCSS__VVLLIINNEE,     AACCSS__HHLLIINNEE,     AACCSS__HHLLIINNEE,     AACCSS__UULLCCOORRNNEERR,
       AACCSS__UURRCCOORRNNEERR, AACCSS__BBLLCCOORRNNEERR, AACCSS__BBRRCCOORRNNEERR.

       bbooxx((_w_i_n, _v_e_r_c_h,, _h_o_r_c_h)) is a shorthand  for  the  following
       call:  wwbboorrddeerr((_w_i_n,,  _v_e_r_c_h,,  _v_e_r_c_h,, _h_o_r_c_h,, _h_o_r_c_h,, 00,, 00,, 00,,
       00)).

       The hhlliinnee and wwhhlliinnee functions draw a horizontal (left  to
       right)  line using _c_h starting at the current cursor posi-
       tion 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.

       The vvlliinnee and wwvvlliinnee functions draw  a  vertical  (top  to
       bottom) line using _c_h starting at the current cursor posi-
       tion 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.

RREETTUURRNN VVAALLUUEE
       All routines return the integer  OOKK.   The  SVr4.0  manual
       says  "or  a  non-negative integer if iimmmmeeddookk is set", but
       this appears to be an error.

NNOOTTEESS
       The borders generated by these functions are  _i_n_s_i_d_e  bor-
       ders (this is also true of SVr4 curses, though the fact is



                                                                1





curs_border(3X)                                   curs_border(3X)


       not documented).

       Note that bboorrddeerr and bbooxx may be macros.

PPOORRTTAABBIILLIITTYY
       These functions are described in the XSI Curses  standard,
       Issue 4.  Additional functions mmvvhhlliinnee, mmvvvvlliinnee, mmvvwwhhlliinnee,
       and mmvvwwvvlliinnee are described there which this implementation
       does  not  yet  support.  The standard specifies that they
       return EERRRR on failure, but specifies no error  conditions.

SSEEEE AALLSSOO
       ccuurrsseess(3X), ccuurrss__oouuttooppttss(3X).












































                                                                2


