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(7) 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(7),
standards(7) June 5, 2002 HLINE(3XCURSES)
