1curs_deleteln(3CURSES)     Curses Library Functions     curs_deleteln(3CURSES)
2
3
4

NAME

6       curs_deleteln, deleteln, wdeleteln, insdelln, winsdelln, insertln, win‐
7       sertln - delete and insert lines in a curses window
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int deleteln(void);
14
15
16       int wdeleteln(WINDOW *win);
17
18
19       int insdelln(int n);
20
21
22       int winsdelln(WINDOW *win, int n);
23
24
25       int insertln(void);
26
27
28       int winsertln(WINDOW *win);
29
30

DESCRIPTION

32       With the deleteln() and wdeleteln() routines, the line under the cursor
33       in the window is deleted; all lines below the current line are moved up
34       one line. The bottom line of the window is cleared. The cursor position
35       does not change. This does not imply use of a hardware delete line fea‐
36       ture.
37
38
39       With the  insdelln() and winsdelln() routines, for positive n, insert n
40       lines  into  the  specified window above the current line. The n bottom
41       lines are lost. For negative n, delete n lines (starting with  the  one
42       under  the cursor), and move the remaining lines up. The bottom n lines
43       are cleared. The current cursor position remains the same.
44
45
46       With the insertln() and insertln() routines, a blank line  is  inserted
47       above the current line and the bottom line is lost. This does not imply
48       use of a hardware insert line feature.
49

RETURN VALUES

51       All routines return the integer ERR upon failure and an  integer  value
52       other than ERR upon successful completion.
53

ATTRIBUTES

55       See attributes(5) for descriptions of the following attributes:
56
57
58
59
60       ┌─────────────────────────────┬─────────────────────────────┐
61       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │MT-Level                     │Unsafe                       │
64       └─────────────────────────────┴─────────────────────────────┘
65

SEE ALSO

67       curses(3CURSES), attributes(5)
68

NOTES

70       The header <curses.h> automatically includes the headers  <stdio.h> and
71       <unctrl.h>.
72
73
74       Note that all but winsdelln() may be macros.
75
76
77
78SunOS 5.11                        31 Dec 1996           curs_deleteln(3CURSES)