Returns the value of a terminal's string capability.
Curses Library (libcurses.a)
#include <curses.h> #include <term.h>
tigetstr(Capname) register char *Capname;
The tigetstr subroutine returns the value of terminal's string capability. Use this subroutine to get a capability for the current terminal pointed to by cur_term. When successful, this subroutine returns the current value of the capability specified by the Capname parameter. Otherwise, if it is not a string value, this subroutine returns (char*) -1.
Note: The tigetstr subroutine is a low-level routine. Use this subroutine only if your application must deal directly with the terminfo database to handle certain terminal capabilities (for example, programming function keys).
|Capname||Identifies the terminal capability to check.|
To determine if "turn on soft labels " is a defined string capability for the current terminal, do the following:
rc = tigetstr("smln");
Upon successful completion, the tigetstr subroutine returns the value of terminal's string capability.
|(char *)-1||Indicates the value specified by the Capname parameter is not a string.|
This routine is part of Base Operating System (BOS) Runtime.
|/usr/include/curses.h||Contains C language subroutines and define statements for curses.|
List of Curses Subroutines, Curses Overview for Programming, Understanding Terminals with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.