X/Open Curses Library Functions                   hline(3XCURSES)



NAME
     hline, mvhline, mvvline, mvwhline, mvwvline, vline,  whline,
     wvline - use single-byte characters (and renditions) to draw
     lines

SYNOPSIS
     cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
      -R  /usr/xpg4/lib  -lcurses  [ library... ]

     c89 [ flag... ] file... -lcurses [ library... ]

     #include 

     int hline(chtype ch, int n);


     int mvhline(int y, int x, chtype ch, int n);


     int mvvline(int y, int x, chtype ch, int n);


     int mvwhline(WINDOW *win, int y, int x, chtype ch, int n);


     int mvwvline(WINDOW *win, int y, int x, chtype ch, int n);


     int vline(chtype ch, int n);


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


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


DESCRIPTION
     The hline(), vline(), whline(), wvline() functions   draw  a
     horizontal  or vertical line, in either the window stdscr or
     win  starting at the current cursor position.  The  line  is
     drawn using the character ch and is a maximum of n positions
     long, or as many as will fit into the window.  If  ch  is  0
     (zero),  the  default  horizontal  or  vertical character is
     used.


     The mvhline(), mvvline(), mvwhline(), mvwvline()   functions
     are  similar to the previous group of functions but the line
     begins  at cursor position specified by x and y.





SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions                   hline(3XCURSES)



     The functions with names ending with hline() draw horizontal
     lines  proceeding  towards the last column of the same line.
     The functions with names ending with vline()  draw  vertical
     lines proceeding towards the last column of the same line.


     These functions do not change the position of the cursor.

PARAMETERS
     ch     Is the character used to draw the line.


     n      Is the maximum number of characters in the line.


     y      Is the y (row) coordinate for the start of the line.


     x      Is the x (column) coordinate for  the  start  of  the
            line.


     win    Is a pointer to a window.


RETURN VALUES
     On success,  these  functions  return  OK.  Otherwise,  they
     return ER.

ERORS
     None

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     border(3XCURSES), borderset(3XCURSES), hlineset(3XCURSES),
     libcurses(3XCURSES), attributes(5), standards(5)





SunOS 5.11           Last change: 5 Jun 2002                    2