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

NAME

6       curs_termattrs,  baudrate,  erasechar,  has_ic, has_il, killchar, long‐
7       name, termattrs, termname - curses environment query routines
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int baudrate(void);
14
15
16       char erasechar(void);
17
18
19       int has_ic(void);
20
21
22       int has_il(void);
23
24
25       char killchar(void);
26
27
28       char *longname(void);
29
30
31       chtype termattrs(void);
32
33
34       char *termname(void);
35
36

DESCRIPTION

38       The baudrate() routine returns the output speed of  the  terminal.  The
39       number  returned  is  in  bits  per second, for example 9600, and is an
40       integer.
41
42
43       With the erasechar() routine, the user's  current  erase  character  is
44       returned.
45
46
47       The  has_ic()  routine  is true if the terminal has insert- and delete-
48       character capabilities.
49
50
51       The has_il() routine is true if the terminal has  insert-  and  delete-
52       line  capabilities,  or can simulate them using scrolling regions. This
53       might be used to determine if it would be appropriate to turn on physi‐
54       cal scrolling using scrollok().
55
56
57       With  the killchar() routine, the user's current line kill character is
58       returned.
59
60
61       The longname() routine returns a pointer to a static area containing  a
62       verbose  description  of  the current terminal. The maximum length of a
63       verbose description is 128 characters. It is  defined  only  after  the
64       call to initscr() or newterm(). The area is overwritten by each call to
65       newterm() and is not restored by set_term(), so  the  value  should  be
66       saved between calls to newterm() if longname() is going to be used with
67       multiple terminals.
68
69
70       If a given terminal doesn't support a video attribute that an  applica‐
71       tion  program is trying to use, curses may substitute a different video
72       attribute for it. The termattrs() function returns a logical OR of  all
73       video  attributes supported by the terminal. This information is useful
74       when a curses program needs complete control over the appearance of the
75       screen.
76
77
78       The  termname()  routine  returns the value of the environment variable
79       TERM (truncated to 14 characters).
80

RETURN VALUES

82       longname() and termname() return NULL on error.
83
84
85       Routines that return an integer return ERR upon failure and an  integer
86       value other than ERR upon successful completion.
87

ATTRIBUTES

89       See attributes(5) for descriptions of the following attributes:
90
91
92
93
94       ┌─────────────────────────────┬─────────────────────────────┐
95       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
96       ├─────────────────────────────┼─────────────────────────────┤
97       │MT-Level                     │Unsafe                       │
98       └─────────────────────────────┴─────────────────────────────┘
99

SEE ALSO

101       curs_initscr(3CURSES),      curs_outopts(3CURSES),     curses(3CURSES),
102       attributes(5)
103

NOTES

105       The header <curses.h> automatically includes the headers  <stdio.h> and
106       <unctrl.h>.
107
108
109       Note that termattrs() may be a macro.
110
111
112
113SunOS 5.11                        31 Dec 1996          curs_termattrs(3CURSES)
Impressum