cursborderset(3X) cursborderset(3X)

NAME
       bboorrddeerrsseett, wwbboorrddeerrsseett, bbooxxsseett, hhlliinneesseett, wwhhlliinneesseett, mmvvhhlliinneesseett,
       mmvvwwhhlliinneesseett, vvlliinneesseett, wwvvlliinneesseett, mmvvvvlliinneesseett, mmvvwwvvlliinneesseett - create
       ccuurrsseess borders or lines using complex characters and renditions

SYNOPSIS
       ##iinncclluuddee <>

       iinntt bboorrddeerrsseett((
          ccoonnsstt cccchhaarrtt **ls, ccoonnsstt cccchhaarrtt **rs,
          ccoonnsstt cccchhaarrtt **ts, ccoonnsstt cccchhaarrtt **bs,
          ccoonnsstt cccchhaarrtt **tl, ccoonnsstt cccchhaarrtt **tr,
          ccoonnsstt cccchhaarrtt **bl, ccoonnsstt cccchhaarrtt **br ));;
       iinntt wwbboorrddeerrsseett((
          WWIINNDDOOWW **wwiinn,
          ccoonnsstt cccchhaarrtt **ls, ccoonnsstt cccchhaarrtt **rs,
          ccoonnsstt cccchhaarrtt **ts, ccoonnsstt cccchhaarrtt **bs,
          ccoonnsstt cccchhaarrtt **tl, ccoonnsstt cccchhaarrtt **tr,
          ccoonnsstt cccchhaarrtt **bl, ccoonnsstt cccchhaarrtt **br));;
       iinntt bbooxxsseett((
          WWIINNDDOOWW **wwiinn,
          ccoonnsstt cccchhaarrtt **verch,
          ccoonnsstt cccchhaarrtt **horch));;
       iinntt hhlliinneesseett((
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt wwhhlliinneesseett((
          WWIINNDDOOWW **win,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt mmvvhhlliinneesseett((
          iinntt y, iinntt x,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt mmvvwwhhlliinneesseett((
          WWIINNDDOOWW **win,
          iinntt y, iinntt x,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt vvlliinneesseett((
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt wwvvlliinneesseett((
          WWIINNDDOOWW **win,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt mmvvvvlliinneesseett((
          iinntt y, iinntt x,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;
       iinntt mmvvwwvvlliinneesseett((
          WWIINNDDOOWW **win,
          iinntt y, iinntt x,
          ccoonnsstt cccchhaarrtt **wch, iinntt n));;

DESCRIPTION
       The bboorrddeerrsseett and wwbboorrddeerrsseett functions draw a border around the edges
       of the current or specified window.  These functions do not change  the
       cursor position, and do not wrap.

       Other  than  the  window, each argument is a complex character with at-
       tributes:
              ls - left side,
              rs - right side,
              ts - top side,
              bs - bottom side,
              tl - top left-hand corner,
              tr - top right-hand corner,
              bl - bottom left-hand corner, and
              br - bottom right-hand corner.

       If any of these arguments is zero, then the corresponding default  val-
       ues (defined in ccuurrsseess..hh) are used instead:
              WWAACCSSVVLLIINNEE,
              WWAACCSSVVLLIINNEE,
              WWAACCSSHHLLIINNEE,
              WWAACCSSHHLLIINNEE,
              WWAACCSSUULLCCOORRNNEERR,
              WWAACCSSUURRCCOORRNNEERR,
              WWAACCSSLLLLCCOORRNNEERR, and
              WWAACCSSLLRRCCOORRNNEERR.

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

       wwbboorrddeerrsseett((win,, verch,, verch,,
           horch,, horch,, NNUULLLL,, NNUULLLL,, NNUULLLL,, NNUULLLL));;

       The  **lliinneesseett functions use wch to draw a line starting at the current
       cursor position in the window.  The line is at most n  characters  long
       or  as many as fit into the window.  The current cursor position is not
       changed.

       The hhlliinneesseett, mmvvhhlliinneesseett, mmvvwwhhlliinneesseett, and wwhhlliinneesseett functions draw
       a line proceeding toward the last column of the same line.

       The vvlliinneesseett, mmvvvvlliinneesseett, mmvvwwvvlliinneesseett, and wwvvlliinneesseett functions draw
       a line proceeding toward the last line of the window.

NNOOTTEESS
       Note  that  bboorrddeerrsseett,  hhlliinneesseett,  mmvvhhlliinneesseett,  mmvvvvlliinneesseett,   mmvvwwhh-
       lliinneesseett, mmvvwwvvlliinneesseett, and vvlliinneesseett may be macros.

RETURN VALUES
       Upon successful completion, these functions return OOKK.  Otherwise, they
       return EERRRR.

       Functions using a window parameter return an error if it is null.

SEE ALSO
       nnccuurrsseess(3X), ccuurrssbboorrddeerr(3X), ccuurrssoouuttooppttss(3X)



                                                           cursborderset(3X)