border(3X)                                                       border(3X)

NAME
     border, wborder - draw borders from single-byte characters and rendi-
     tions

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

DESCRIPTION
     The border() and wborder() functions draw a border around the edges of
     the current or specified window. These functions do not advance the
     cursor position. These functions do not perform special character pro-
     cessing. These functions do not perform wrapping.

     The arguments in the left-hand column of the following table contain
     single-byte characters with renditions, which have the following uses
     in drawing the border:

     _____________________________________________________________________
    | Argument                                                 Default   |
    |   Name                      Usage                         Value    |
    |____________________________________________________________________|
    | ls         Starting-column side                       ACSVLINE    |
    | rs         Ending-column side                         ACSVLINE    |
    | ts         First-line side                            ACSHLINE    |
    | bs         Last-line side                             ACSHLINE    |
    | tl         Corner of the first line and the start-    ACSULCORNER |
    |            ing column                                              |
    | tr         Corner of the first line and the ending    ACSURCORNER |
    |            column                                                  |
    | bl         Corner of the last line and the starting   ACSBLCORNER |
    |            column                                                  |
    | br         Corner of the last line and the ending     ACSBRCORNER |
    |            column                                                  |
    |____________________________________________________________________|

     If the value of any argument in the left-hand column is 0, then the
     default value in the right-hand column is used. If the value of any
     argument in the left-hand column is a multi-column character, the
     results are undefined.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.




Page 1                       Reliant UNIX 5.44                Printed 11/98

border(3X)                                                       border(3X)

ERRORS
     No errors are defined.

NOTES
     These functions are only guaranteed to operate reliably on character
     sets in which each character fits into a single byte, whose attributes
     can be expressed using only constants with the A prefix.

SEE ALSO
     borderset(3X), box(3X), curses(3X), hline(3X), curses(5).












































Page 2                       Reliant UNIX 5.44                Printed 11/98