mvwhline(3) [netbsd man page]

CURSES_LINE(3)						   BSD Library Functions Manual 					    CURSES_LINE(3)

NAME

     curses_line, hline, whline, vline, wvline, mvhline, mvwhline, mvvline, mvwvline -- curses draw lines on windows routines

LIBRARY

     Curses Library (libcurses, -lcurses)

SYNOPSIS

     #include <curses.h>

     int
     hline(chtype ch, int n);

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

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

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

     int
     vline(chtype c, int n);

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

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

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

DESCRIPTION

     These functions draw lines on stdscr or on the specified window.

     The hline() function draws a horizontal line of the character ch on stdscr starting at the current cursor position and extending for n char-
     acters, or until the right hand side of stdscr is reached.  If the text portion of ch is 0 then the line will be drawn with the ACS_HLINE
     character.

     The whline() function is the same as the hline() function, excepting that the line is drawn in the window specified by win.

     The vline() function draws a vertical line of character ch on stdscr starting at the current cursor position and moving down until either n
     characters have been drawn or the bottom of stdscr is reached.  If the text portion of ch is 0 then the line will be drawn with the ACS_VLINE
     character.

     The wvline() function is the same as the vline() function, excepting that the line is drawn on the given window.

     The mvhline(), mvwhline(), mvvline() and mvwvline() functions are the same as the hline(), whline(), vline() and wvline() functions, respec-
     tively, excepting that wmove() is called to move the cursor to the position specified by y, x before the line is drawn on the window.

RETURN VALUES

     Functions returning pointers will return NULL if an error is detected.  The functions that return an int will return one of the following
     values:

     OK   The function completed successfully.
     ERR  An error occurred in the function.

SEE ALSO

     curses_border(3)

STANDARDS

     The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.

     The use of ACS_HLINE and ACS_VLINE as default drawing character in hline() and vline() is a NetBSD extension which should not be relied on in
     portable code.

HISTORY

     The Curses package appeared in 4.0BSD.

BSD
								 February 19, 2010							       BSD

hline(3XCURSES) 					  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 <curses.h>

       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.

       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 ERR.

ERRORS

       None

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       border(3XCURSES), border_set(3XCURSES), hline_set(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002							   hline(3XCURSES)