hline.3x (2010 09)

hline(3X) hline(3X)

(ENHANCED CURSES)

NAME

hline, mvhline, mvvline, mvwhline, mvwvline, vline, whline, wvline — draw lines from single-byte char-

acters and renditions

SYNOPSIS

#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

These functions draw a line in the current or speciﬁed window starting at the current or speciﬁed posi-

tion, using ch. The line is at most n positions long, or as many as ﬁt into the 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

hline(), mvhline(), mvwhline() and whline() functions draw a line proceeding toward the

last column of the same line.

The

vline(), mvvline(), mvwvline() and wvline() functions draw a line proceeding toward the

last line of the window.

RETURN VALUE

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

ERRORS

No errors are deﬁned.

APPLICATION USAGE

These functions are only guaranteed to operate reliably on character sets in which each character ﬁts into

a single byte, whose attributes can be expressed using only constants with the A_ preﬁx.