1curses(3CURSES) Curses Library Functions curses(3CURSES)
2
3
4
6 curses - CRT screen handling and optimization package
7
9 cc [ flag... ] file.. .-lcurses [ library... ]
10 #include <curses.h>
11
12
14 The curses library routines give the user a terminal-independent method
15 of updating character screens with reasonable optimization.
16
17
18 The curses package allows: overall screen, window and pad manipula‐
19 tion; output to windows and pads; reading terminal input; control over
20 terminal and curses input and output options; environment query rou‐
21 tines; color manipulation; use of soft label keys; terminfo access; and
22 access to low-level curses routines.
23
24
25 To initialize the routines, the routine initscr() or newterm() must be
26 called before any of the other routines that deal with windows and
27 screens are used. The routine endwin() must be called before exiting.
28 To get character-at-a-time input without echoing (most interactive,
29 screen oriented programs want this), the following sequence should be
30 used:
31
32
33 initscr,cbreak,noecho;
34
35
36 Most programs would additionally use the sequence:
37
38
39 nonl,intrflush(stdscr,FALSE),keypad(stdscr,TRUE);
40
41
42 Before a curses program is run, the tab stops of the terminal should be
43 set and its initialization strings, if defined, must be output. This
44 can be done by executing the tput init command after the shell environ‐
45 ment variable TERM has been exported. (See terminfo(4) for further
46 details.)
47
48
49 The curses library permits manipulation of data structures, called win‐
50 dows, which can be thought of as two-dimensional arrays of characters
51 representing all or part of a CRT screen. A default window called std‐
52 scr, which is the size of the terminal screen, is supplied. Others may
53 be created with newwin(3CURSES).
54
55
56 Windows are referred to by variables declared as WINDOW *. These data
57 structures are manipulated with routines described on 3CURSES pages
58 (whose names begin "curs_"). Among which the most basic routines are
59 move(3CURSES) and addch(3CURSES). More general versions of these rou‐
60 tines are included with names beginning with w, allowing the user to
61 specify a window. The routines not beginning with w affect stdscr.
62
63
64 After using routines to manipulate a window, refresh(3CURSES) is
65 called, telling curses to make the user's CRT screen look like stdscr.
66 The characters in a window are actually of type chtype, (character and
67 attribute data) so that other information about the character may also
68 be stored with each character.
69
70
71 Special windows called pads may also be manipulated. These are windows
72 which are not constrained to the size of the screen and whose contents
73 need not be completely displayed. See curs_pad(3CURSES) for more infor‐
74 mation.
75
76
77 In addition to drawing characters on the screen, video attributes and
78 colors may be included, causing the characters to show up in such modes
79 as underlined, in reverse video, or in color on terminals that support
80 such display enhancements. Line drawing characters may be specified to
81 be output. On input, curses is also able to translate arrow and func‐
82 tion keys that transmit escape sequences into single values. The video
83 attributes, line drawing characters, and input values use names,
84 defined in <curses.h>, such as A_REVERSE, ACS_HLINE, and KEY_LEFT.
85
86
87 If the environment variables LINES and COLUMNS are set, or if the pro‐
88 gram is executing in a window environment, line and column information
89 in the environment will override information read by terminfo. This
90 would effect a program running in an AT&T 630 layer, for example, where
91 the size of a screen is changeable.
92
93
94 If the environment variable TERMINFO is defined, any program using
95 curses checks for a local terminal definition before checking in the
96 standard place. For example, if TERM is set to att4424, then the com‐
97 piled terminal definition is found in
98
99
100 /usr/share/lib/terminfo/a/att4424.
101
102
103 (The `a' is copied from the first letter of att4424 to avoid creation
104 of huge directories.) However, if TERMINFO is set to $HOME/myterms,
105 curses first checks
106
107
108 $HOME/myterms/a/att4424,
109
110
111 and if that fails, it then checks
112
113
114 /usr/share/lib/terminfo/a/att4424.
115
116
117 This is useful for developing experimental definitions or when write
118 permission in /usr/share/lib/terminfo is not available.
119
120
121 The integer variables LINES and COLS are defined in <curses.h> and will
122 be filled in by initscr with the size of the screen. The constants TRUE
123 and FALSE have the values 1 and 0, respectively.
124
125
126 The curses routines also define the WINDOW * variable curscr which is
127 used for certain low-level operations like clearing and redrawing a
128 screen containing garbage. The curscr can be used in only a few rou‐
129 tines.
130
131 International Functions
132 The number of bytes and the number of columns to hold a character from
133 the supplementary character set is locale-specific (locale category
134 LC_CTYPE) and can be specified in the character class table.
135
136
137 For editing, operating at the character level is entirely appropriate.
138 For screen formatting, arbitrary movement of characters on screen is
139 not desirable.
140
141
142 Overwriting characters (addch, for example) operates on a screen level.
143 Overwriting a character by a character that requires a different number
144 of columns may produce orphaned columns. These orphaned columns are
145 filled with background characters.
146
147
148 Inserting characters (insch, for example) operates on a character level
149 (that is, at the character boundaries). The specified character is
150 inserted right before the character, regardless of which column of a
151 character the cursor points to. Before insertion, the cursor position
152 is adjusted to the first column of the character.
153
154
155 As with inserting characters, deleting characters (delch, for example)
156 operates on a character level (that is, at the character boundaries).
157 The character at the cursor is deleted whichever column of the charac‐
158 ter the cursor points to. Before deletion, the cursor position is
159 adjusted to the first column of the character.
160
161
162 A multi-column character cannot be put on the last column of a line.
163 When such attempts are made, the last column is set to the background
164 character. In addition, when such an operation creates orphaned col‐
165 umns, the orphaned columns are filled with background characters.
166
167
168 Overlapping and overwriting a window follows the operation of overwrit‐
169 ing characters around its edge. The orphaned columns, if any, are han‐
170 dled as in the character operations.
171
172
173 The cursor is allowed to be placed anywhere in a window. If the inser‐
174 tion or deletion is made when the cursor points to the second or later
175 column position of a character that holds multiple columns, the cursor
176 is adjusted to the first column of the character before the insertion
177 or deletion.
178
179 Routine and Argument Names
180 Many curses routines have two or more versions. The routines prefixed
181 with w require a window argument. The routines prefixed with p require
182 a pad argument. Those without a prefix generally use stdscr.
183
184
185 The routines prefixed with mv require an x and y coordinate to move to
186 before performing the appropriate action. The mv routines imply a call
187 to move(3CURSES) before the call to the other routine. The coordinate y
188 always refers to the row (of the window), and x always refers to the
189 column. The upper left-hand corner is always (0,0), not (1,1).
190
191
192 The routines prefixed with mvw take both a window argument and x and y
193 coordinates. The window argument is always specified before the coordi‐
194 nates.
195
196
197 In each case, win is the window affected, and pad is the pad affected;
198 win and pad are always pointers to type WINDOW
199
200
201 Option setting routines require a Boolean flag bf with the value TRUE
202 or FALSE; bf is always of type bool. The variables ch and attrs below
203 are always of type chtype. The types WINDOW, SCREEN, bool, and chtype
204 are defined in <curses.h>. The type TERMINAL is defined in <term.h>.
205 All other arguments are integers.
206
207 Routine Name Index
208 The following table lists each curses routine and the name of the man‐
209 ual page on which it is described.
210
211 curses Routine Name Manual Page Name
212
213
214 addch curs_addch(3CURSES)
215
216
217 addchnstr curs_addchstr(3CURSES)
218
219
220 addchstr curs_addchstr(3CURSES)
221
222
223 addnstr curs_addstr(3CURSES)
224
225
226 addnwstr curs_addwstr(3CURSES)
227
228
229 addstr curs_addstr(3CURSES)
230
231
232 addwch curs_addwch(3CURSES)
233
234
235 addwchnstr curs_addwchstr(3CURSES)
236
237
238 addwchstr curs_addwchstr(3CURSES)
239
240
241 addwstr curs_addwstr(3CURSES)
242
243
244 adjcurspos curs_alecompat(3CURSES)
245
246
247 attroff curs_attr(3CURSES)
248
249
250 attron curs_attr(3CURSES)
251
252
253 attrset curs_attr(3CURSES)
254
255
256 baudrate curs_termattrs(3CURSES)
257
258
259 beep curs_beep(3CURSES)
260
261
262 bkgd curs_bkgd(3CURSES)
263
264
265 bkgdset curs_bkgd(3CURSES)
266
267
268 border curs_border(3CURSES)
269
270
271 box curs_border(3CURSES)
272
273
274 can_change_color curs_color(3CURSES)
275
276
277 cbreak curs_inopts(3CURSES)
278
279
280 clear curs_clear(3CURSES)
281
282
283 clearok curs_outopts(3CURSES)
284
285
286 clrtobot curs_clear(3CURSES)
287
288
289 clrtoeol curs_clear(3CURSES)
290
291
292 color_content curs_color(3CURSES)
293
294
295 copywin curs_overlay(3CURSES)
296
297
298 curs_set curs_kernel(3CURSES)
299
300
301 def_prog_mode curs_kernel(3CURSES)
302
303
304 def_shell_mode curs_kernel(3CURSES)
305
306
307 del_curterm curs_terminfo(3CURSES)
308
309
310 delay_output curs_util(3CURSES)
311
312
313 delch curs_delch(3CURSES)
314
315
316 deleteln curs_deleteln(3CURSES)
317
318
319 delscreen curs_initscr(3CURSES)
320
321
322 delwin curs_window(3CURSES)
323
324
325 derwin curs_window(3CURSES)
326
327
328 doupdate curs_refresh(3CURSES)
329
330
331 dupwin curs_window(3CURSES)
332
333
334 echo curs_inopts(3CURSES)
335
336
337 echochar curs_addch(3CURSES)
338
339
340 echowchar curs_addwch(3CURSES)
341
342
343 endwin curs_initscr(3CURSES)
344
345
346 erase curs_clear(3CURSES)
347
348
349 erasechar curs_termattrs(3CURSES)
350
351
352 filter curs_util(3CURSES)
353
354
355 flash curs_beep(3CURSES)
356
357
358 flushinp curs_util(3CURSES)
359
360
361 getbegyx curs_getyx(3CURSES)
362
363
364 getch curs_getch(3CURSES)
365
366
367 getmaxyx curs_getyx(3CURSES)
368
369
370 getnwstr curs_getwstr(3CURSES)
371
372
373 getparyx curs_getyx(3CURSES)
374
375
376 getstr curs_getstr(3CURSES)
377
378
379 getsyx curs_kernel(3CURSES)
380
381
382 getwch curs_getwch(3CURSES)
383
384
385 getwin curs_util(3CURSES)
386
387
388 getwstr curs_getwstr(3CURSES)
389
390
391 getyx curs_getyx(3CURSES)
392
393
394 halfdelay curs_inopts(3CURSES)
395
396
397 has_colors curs_color(3CURSES)
398
399
400 has_ic curs_termattrs(3CURSES)
401
402
403 has_il curs_termattrs(3CURSES)
404
405
406 idcok curs_outopts(3CURSES)
407
408
409 idlok curs_outopts(3CURSES)
410
411
412 immedok curs_outopts(3CURSES)
413
414
415 inch curs_inch(3CURSES)
416
417
418 inchnstr curs_inchstr(3CURSES)
419
420
421 inchstr curs_inchstr(3CURSES)
422
423
424 init_color curs_color(3CURSES)
425
426
427 init_pair curs_color(3CURSES)
428
429
430 initscr curs_initscr(3CURSES)
431
432
433 innstr curs_instr(3CURSES)
434
435
436 innwstr curs_inwstr(3CURSES)
437
438
439 insch curs_insch(3CURSES)
440
441
442 insdelln curs_deleteln(3CURSES)
443
444
445 insertln curs_deleteln(3CURSES)
446
447
448 insnstr curs_insstr(3CURSES)
449
450
451 insnwstr curs_inswstr(3CURSES)
452
453
454 insstr curs_insstr(3CURSES)
455
456
457 instr curs_instr(3CURSES)
458
459
460 inswch curs_inswch(3CURSES)
461
462
463 inswstr curs_inswstr(3CURSES)
464
465
466 intrflush curs_inopts(3CURSES)
467
468
469 inwch curs_inwch(3CURSES)
470
471
472 inwchnstr curs_inwchstr(3CURSES)
473
474
475 inwchstr curs_inwchstr(3CURSES)
476
477
478 inwstr curs_inwstr(3CURSES)
479
480
481 is_linetouched curs_touch(3CURSES)
482
483
484 is_wintouched curs_touch(3CURSES)
485
486
487 isendwin curs_initscr(3CURSES)
488
489
490 keyname curs_util(3CURSES)
491
492
493 keypad curs_inopts(3CURSES)
494
495
496 killchar curs_termattrs(3CURSES)
497
498
499 leaveok curs_outopts(3CURSES)
500
501
502 longname curs_termattrs(3CURSES)
503
504
505 meta curs_inopts(3CURSES)
506
507
508 move curs_move(3CURSES)
509
510
511 movenextch curs_alecompat(3CURSES)
512
513
514 moveprevch curs_alecompat(3CURSES)
515
516
517 mvaddch curs_addch(3CURSES)
518
519
520 mvaddchnstr curs_addchstr(3CURSES)
521
522
523 mvaddchstr curs_addchstr(3CURSES)
524
525
526 mvaddnstr curs_addstr(3CURSES)
527
528
529 mvaddnwstr curs_addwstr(3CURSES)
530
531
532 mvaddstr curs_addstr(3CURSES)
533
534
535 mvaddwch curs_addwch(3CURSES)
536
537
538 mvaddwchnstr curs_addwchstr(3CURSES)
539
540
541 mvaddwchstr curs_addwchstr(3CURSES)
542
543
544 mvaddwstr curs_addwstr(3CURSES)
545
546
547 mvcur curs_terminfo(3CURSES)
548
549
550 mvdelch curs_delch(3CURSES)
551
552
553 mvderwin curs_window(3CURSES)
554
555
556 mvgetch curs_getch(3CURSES)
557
558
559 mvgetnwstr curs_getwstr(3CURSES)
560
561
562 mvgetstr curs_getstr(3CURSES)
563
564
565 mvgetwch curs_getwch(3CURSES)
566
567
568 mvgetwstr curs_getwstr(3CURSES)
569
570
571 mvinch curs_inch(3CURSES)
572
573
574 mvinchnstr curs_inchstr(3CURSES)
575
576
577 mvinchstr curs_inchstr(3CURSES)
578
579
580 mvinnstr curs_instr(3CURSES)
581
582
583 mvinnwstr curs_inwstr(3CURSES)
584
585
586 mvinsch curs_insch(3CURSES)
587
588
589 mvinsnstr curs_insstr(3CURSES)
590
591
592 mvinsnwstr curs_inswstr(3CURSES)
593
594
595 mvinsstr curs_insstr(3CURSES)
596
597
598 mvinstr curs_instr(3CURSES)
599
600
601 mvinswch curs_inswch(3CURSES)
602
603
604 mvinswstr curs_inswstr(3CURSES)
605
606
607 mvinwch curs_inwch(3CURSES)
608
609
610 mvinwchnstr curs_inwchstr(3CURSES)
611
612
613 mvinwchstr curs_inwchstr(3CURSES)
614
615
616 mvinwstr curs_inwstr(3CURSES)
617
618
619 mvprintw curs_printw(3CURSES)
620
621
622 mvscanw curs_scanw(3CURSES)
623
624
625 mvwaddch curs_addch(3CURSES)
626
627
628 mvwaddchnstr curs_addchstr(3CURSES)
629
630
631 mvwaddchstr curs_addchstr(3CURSES)
632
633
634 mvwaddnstr curs_addstr(3CURSES)
635
636
637 mvwaddnwstr curs_addwstr(3CURSES)
638
639
640 mvwaddstr curs_addstr(3CURSES)
641
642
643 mvwaddwch curs_addwch(3CURSES)
644
645
646 mvwaddwchnstr curs_addwchstr(3CURSES)
647
648
649 mvwaddwchstr curs_addwchstr(3CURSES)
650
651
652 mvwaddwstr curs_addwstr(3CURSES)
653
654
655 mvwdelch curs_delch(3CURSES)
656
657
658 mvwgetch curs_getch(3CURSES)
659
660
661 mvwgetnwstr curs_getwstr(3CURSES)
662
663
664 mvwgetstr curs_getstr(3CURSES)
665
666
667 mvwgetwch curs_getwch(3CURSES)
668
669
670 mvwgetwstr curs_getwstr(3CURSES)
671
672
673 mvwin curs_window(3CURSES)
674
675
676 mvwinch curs_inch(3CURSES)
677
678
679 mvwinchnstr curs_inchstr(3CURSES)
680
681
682 mvwinchstr curs_inchstr(3CURSES)
683
684
685 mvwinnstr curs_instr(3CURSES)
686
687
688 mvwinnwstr curs_inwstr(3CURSES)
689
690
691 mvwinsch curs_insch(3CURSES)
692
693
694 mvwinsnstr curs_insstr(3CURSES)
695
696
697 mvwinsstr curs_insstr(3CURSES)
698
699
700 mvwinstr curs_instr(3CURSES)
701
702
703 mvwinswch curs_inswch(3CURSES)
704
705
706 mvwinswstr curs_inswstr(3CURSES)
707
708
709 mvwinwch curs_inwch(3CURSES)
710
711
712 mvwinwchnstr curs_inwchstr(3CURSES)
713
714
715 mvwinwchstr curs_inwchstr(3CURSES)
716
717
718 mvwinwstr curs_inwstr(3CURSES)
719
720
721 mvwprintw curs_printw(3CURSES)
722
723
724 mvwscanw curs_scanw(3CURSES)
725
726
727 napms curs_kernel(3CURSES)
728
729
730 newpad curs_pad(3CURSES)
731
732
733 newterm curs_initscr(3CURSES)
734
735
736 newwin curs_window(3CURSES)
737
738
739 nl curs_outopts(3CURSES)
740
741
742 nocbreak curs_inopts(3CURSES)
743
744
745 nodelay curs_inopts(3CURSES)
746
747
748 noecho curs_inopts(3CURSES)
749
750
751 nonl curs_outopts(3CURSES)
752
753
754 noqiflush curs_inopts(3CURSES)
755
756
757 noraw curs_inopts(3CURSES)
758
759
760 notimeout curs_inopts(3CURSES)
761
762
763 overlay curs_overlay(3CURSES)
764
765
766 overwrite curs_overlay(3CURSES)
767
768
769 pair_content curs_color(3CURSES)
770
771
772 pechochar curs_pad(3CURSES)
773
774
775 pechowchar curs_pad(3CURSES)
776
777
778 pnoutrefresh curs_pad(3CURSES)
779
780
781 prefresh curs_pad(3CURSES)
782
783
784 printw curs_printw(3CURSES)
785
786
787 putp curs_terminfo(3CURSES)
788
789
790 putwin curs_util(3CURSES)
791
792
793 qiflush curs_inopts(3CURSES)
794
795
796 raw curs_inopts(3CURSES)
797
798
799 redrawwin curs_refresh(3CURSES)
800
801
802 refresh curs_refresh(3CURSES)
803
804
805 reset_prog_mode curs_kernel(3CURSES)
806
807
808 reset_shell_mode curs_kernel(3CURSES)
809
810
811 resetty curs_kernel(3CURSES)
812
813
814 restartterm curs_terminfo(3CURSES)
815
816
817 ripoffline curs_kernel(3CURSES)
818
819
820 savetty curs_kernel(3CURSES)
821
822
823 scanw curs_scanw(3CURSES)
824
825
826 scr_dump curs_scr_dump(3CURSES)
827
828
829 scr_init curs_scr_dump(3CURSES)
830
831
832 scr_restore curs_scr_dump(3CURSES)
833
834
835 scr_set curs_scr_dump(3CURSES)
836
837
838 scroll curs_scroll(3CURSES)
839
840
841 scrollok curs_outopts(3CURSES)
842
843
844 set_curterm curs_terminfo(3CURSES)
845
846
847 set_term curs_initscr(3CURSES)
848
849
850 setscrreg curs_outopts(3CURSES)
851
852
853 setsyx curs_kernel(3CURSES)
854
855
856 setterm curs_terminfo(3CURSES)
857
858
859 setupterm curs_terminfo(3CURSES)
860
861
862 slk_attroff curs_slk(3CURSES)
863
864
865 slk_attron curs_slk(3CURSES)
866
867
868 slk_attrset curs_slk(3CURSES)
869
870
871 slk_clear curs_slk(3CURSES)
872
873
874 slk_init curs_slk(3CURSES)
875
876
877 slk_label curs_slk(3CURSES)
878
879
880 slk_noutrefresh curs_slk(3CURSES)
881
882
883 slk_refresh curs_slk(3CURSES)
884
885
886 slk_restore curs_slk(3CURSES)
887
888
889 slk_set curs_slk(3CURSES)
890
891
892 slk_touch curs_slk(3CURSES)
893
894
895 srcl curs_scroll(3CURSES)
896
897
898 standend curs_attr(3CURSES)
899
900
901 standout curs_attr(3CURSES)
902
903
904 start_color curs_color(3CURSES)
905
906
907 subpad curs_pad(3CURSES)
908
909
910 subwin curs_window(3CURSES)
911
912
913 syncok curs_window(3CURSES)
914
915
916 termattrs curs_termattrs(3CURSES)
917
918
919 termname curs_termattrs(3CURSES)
920
921
922 tgetent curs_termcap(3CURSES)
923
924
925 tgetflag curs_termcap(3CURSES)
926
927
928 tgetnum curs_termcap(3CURSES)
929
930
931 tgetstr curs_termcap(3CURSES)
932
933
934 tgoto curs_termcap(3CURSES)
935
936
937 tigetflag curs_terminfo(3CURSES)
938
939
940 tigetnum curs_terminfo(3CURSES)
941
942
943 tigetstr curs_terminfo(3CURSES)
944
945
946 timeout curs_inopts(3CURSES)
947
948
949 touchline curs_touch(3CURSES)
950
951
952 touchwin curs_touch(3CURSES)
953
954
955 tparm curs_terminfo(3CURSES)
956
957
958 tputs curs_terminfo(3CURSES)
959
960
961 typeahead curs_inopts(3CURSES)
962
963
964 unctrl curs_util(3CURSES)
965
966
967 ungetch curs_getch(3CURSES)
968
969
970 ungetwch curs_getwch(3CURSES)
971
972
973 untouchwin curs_touch(3CURSES)
974
975
976 use_env curs_util(3CURSES)
977
978
979 vidattr curs_terminfo(3CURSES)
980
981
982 vidputs curs_terminfo(3CURSES)
983
984
985 vwprintw curs_printw(3CURSES)
986
987
988 vwscanw curs_scanw(3CURSES)
989
990
991 waddch curs_addch(3CURSES)
992
993
994 waddchnstr curs_addchstr(3CURSES)
995
996
997 waddchstr curs_addchstr(3CURSES)
998
999
1000 waddnstr curs_addstr(3CURSES)
1001
1002
1003 waddnwstr curs_addwstr(3CURSES)
1004
1005
1006 waddstr curs_addstr(3CURSES)
1007
1008
1009 waddwch curs_addwch(3CURSES)
1010
1011
1012 waddwchnstr curs_addwchstr(3CURSES)
1013
1014
1015 waddwchstr curs_addwchstr(3CURSES)
1016
1017
1018 waddwstr curs_addwstr(3CURSES)
1019
1020
1021 wadjcurspos curs_alecompat(3CURSES)
1022
1023
1024 wattroff curs_attr(3CURSES)
1025
1026
1027 wattron curs_attr(3CURSES)
1028
1029
1030 wattrset curs_attr(3CURSES)
1031
1032
1033 wbkgd curs_bkgd(3CURSES)
1034
1035
1036 wbkgdset curs_bkgd(3CURSES)
1037
1038
1039 wborder curs_border(3CURSES)
1040
1041
1042 wclear curs_clear(3CURSES)
1043
1044
1045 wclrtobot curs_clear(3CURSES)
1046
1047
1048 wclrtoeol curs_clear(3CURSES)
1049
1050
1051 wcursyncup curs_window(3CURSES)
1052
1053
1054 wdelch curs_delch(3CURSES)
1055
1056
1057 wdeleteln curs_deleteln(3CURSES)
1058
1059
1060 wechochar curs_addch(3CURSES)
1061
1062
1063 wechowchar curs_addwch(3CURSES)
1064
1065
1066 werase curs_clear(3CURSES)
1067
1068
1069 wgetch curs_getch(3CURSES)
1070
1071
1072 wgetnstr curs_getstr(3CURSES)
1073
1074
1075 wgetnwstr curs_getwstr(3CURSES)
1076
1077
1078 wgetstr curs_getstr(3CURSES)
1079
1080
1081 wgetwch curs_getwch(3CURSES)
1082
1083
1084 wgetwstr curs_getwstr(3CURSES)
1085
1086
1087 whline curs_border(3CURSES)
1088
1089
1090 winch curs_inch(3CURSES)
1091
1092
1093 winchnstr curs_inchstr(3CURSES)
1094
1095
1096 winchstr curs_inchstr(3CURSES)
1097
1098
1099 winnstr curs_instr(3CURSES)
1100
1101
1102 winnwstr curs_inwstr(3CURSES)
1103
1104
1105 winsch curs_insch(3CURSES)
1106
1107
1108 winsdelln curs_deleteln(3CURSES)
1109
1110
1111 winsertln curs_deleteln(3CURSES)
1112
1113
1114 winsnstr curs_insstr(3CURSES)
1115
1116
1117 winsnwstr curs_inswstr(3CURSES)
1118
1119
1120 winsstr curs_insstr(3CURSES)
1121
1122
1123 winstr curs_instr(3CURSES)
1124
1125
1126 winswch curs_inswch(3CURSES)
1127
1128
1129 winswstr curs_inswstr(3CURSES)
1130
1131
1132 winwch curs_inwch(3CURSES)
1133
1134
1135 winwchnstr curs_inwchstr(3CURSES)
1136
1137
1138 winwchstr curs_inwchstr(3CURSES)
1139
1140
1141 winwstr curs_inwstr(3CURSES)
1142
1143
1144 wmove curs_move(3CURSES)
1145
1146
1147 wmovenextch curs_alecompat(3CURSES)
1148
1149
1150 wmoveprevch curs_alecompat(3CURSES)
1151
1152
1153 wnoutrefresh curs_refresh(3CURSES)
1154
1155
1156 wprintw curs_printw(3CURSES)
1157
1158
1159 wredrawln curs_refresh(3CURSES)
1160
1161
1162 wrefresh curs_refresh(3CURSES)
1163
1164
1165 wscanw curs_scanw(3CURSES)
1166
1167
1168 wscrl curs_scroll(3CURSES)
1169
1170
1171 wsetscrreg curs_outopts(3CURSES)
1172
1173
1174 wstandend curs_attr(3CURSES)
1175
1176
1177 wstandout curs_attr(3CURSES)
1178
1179
1180 wsyncdown curs_window(3CURSES)
1181
1182
1183 wsyncup curs_window(3CURSES)
1184
1185
1186 wtimeout curs_inopts(3CURSES)
1187
1188
1189 wtouchln curs_touch(3CURSES)
1190
1191
1192 wvline curs_border(3CURSES)
1193
1194
1196 Routines that return an integer return ERR upon failure and an integer
1197 value other than ERR upon successful completion, unless otherwise noted
1198 in the routine descriptions.
1199
1200
1201 All macros return the value of the w version, except setscrreg(),
1202 wsetscrreg(), getyx(), getbegyx(), and getmaxyx(). The return values of
1203 setscrreg(), wsetscrreg(), getyx(), getbegyx(), and getmaxyx() are
1204 undefined (that is, these should not be used as the right-hand side of
1205 assignment statements).
1206
1207
1208 Routines that return pointers return NULL on error.
1209
1211 See attributes(5) for descriptions of the following attributes:
1212
1213
1214
1215
1216 ┌─────────────────────────────┬─────────────────────────────┐
1217 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
1218 ├─────────────────────────────┼─────────────────────────────┤
1219 │MT-Level │Unsafe │
1220 └─────────────────────────────┴─────────────────────────────┘
1221
1223 curses(3XCURSES), libcurses(3LIB), libcurses(3XCURSES), terminfo(4),
1224 attributes(5)
1225
1227 The header <curses.h> automatically includes the headers <stdio.h> and
1228 <unctrl.h>.
1229
1230
1231
1232SunOS 5.11 23 Oct 2001 curses(3CURSES)