Sous-routine setupterm
Objectif
Initialise la structure de terminal avec les valeurs de la base de données terminfo .
Bibliothèque
Bibliothèque Curses (libcurses.a)
Syntaxe
#include <curses.h>#include <term.h>Descriptif
La sous-routine setupterm détermine le nombre de lignes et de colonnes disponibles sur le terminal de sortie. La sous-routine setupterm appelle la sous-routine termdef pour définir le nombre de lignes et de colonnes affichées. Si la sous-routine termdef ne peut pas fournir ces informations, la sous-routine setupterm utilise les valeurs de la base de données terminfo .
La sous-routine setupterm initialise la structure du terminal avec les fonctions dépendantes du terminal à partir de terminfo. Cette routine est automatiquement appelée par les sous-routines initscr et newterm . La sous-routine setupterm traite directement la base de données terminfo .
Deux des fonctions dépendantes du terminal sont les lignes et les colonnes. La sous-routine setupterm remplit les zones des lignes et des colonnes dans la structure du terminal de la manière suivante:
- Si les variables d'environnement LINES et COLUMNS sont définies, la sous-routine setupterm utilise ces valeurs.
- Si les variables d'environnement ne sont pas définies, la sous-routine setupterm obtient les informations sur les lignes et les colonnes du sous-système tty.
- En dernier ressort, la sous-routine setupterm utilise les valeurs définies dans la base de données terminfo .Remarque: Ces valeurs peuvent ou non être identiques à celles de la base de données terminfo .
L'appel le plus simple est setupterm (((char *) 0, 1, (int *) 0), qui utilise toutes les valeurs par défaut.
Après l'appel à la sous-routine setupterm , la variable globale cur_term est définie pour pointer vers la structure actuelle des fonctions du terminal. Un programme peut utiliser plusieurs terminaux à la fois en appelant la sous-routine setupterm pour chaque terminal, puis en enregistrant et en restaurant la variable cur_term .
Paramètres
| Article | Descriptif |
|---|---|
| ErrorCode | Indique un pointeur vers un entier vers lequel renvoyer le code d'erreur. Si un pointeur null (0) est transmis pour ce paramètre, aucun statut n'est renvoyé. Une erreur entraîne le sous-programme setupterm à imprimer un message d'erreur et à quitter au lieu de le renvoyer. |
| FileNumber | Indique le descripteur de fichier des fichiers de sortie (1 correspond à la sortie standard). |
| Terme | Indique le nom du terminal. Si 0 est transmis pour ce paramètre, la valeur de la variable d'environnement $TERM est utilisée. |
Valeurs renvoyées
L'une des valeurs de statut suivantes est stockée dans l'entier désigné par le paramètre ErrorCode :
| Article | Descriptif |
|---|---|
| 1 seul | L'opération a abouti. |
| 0 % | Aucun terminal de ce type. |
| -1 | Une erreur s'est produite lors de la localisation de la base de données terminfo . |
Exemple
Pour déterminer les capacités du terminal en cours en utilisant $TERM comme nom de terminal, la sortie standard comme sortie et en ne renvoyant aucun code d'erreur, entrez:
setupterm((char*) 0, 1, (int*) 0);