Keyname, nom_clé Sous-routine

Objectif

Extrait le nom des clés.

Bibliothèque

Bibliothèque Curses (libcurses.a)

Syntaxe

#include <curses.h>

char *keyname(int c);

char *key_name(wchar_t c);

Descriptif

Les sous-programmes Nom de clé et Nom_clé génèrent une chaîne de caractères dont la valeur décrit la clé C. L'argument C de Nom de clé peut être un caractère à 8 bits ou un code de clé. L'argument C de Nom_clé doit être un caractère large.

La chaîne a un format selon la première ligne applicable dans le tableau suivant:

Tableau 1. Chaînes de caractères
Article Descriptif
Input Format de la chaîne renvoyée
Visible character Le même caractère
Control character ^X
Meta-character (keyname only) M-X
Key value defined in <curses.h> (keyname only) KEY_NAME
None of the above CLÉ INCONNUE

La notation des métacaractères indiquée précédemment est utilisée uniquement si les métacaractères sont activés.

Paramètre

c

Valeurs renvoyées

Une fois l'opération terminée, la sous-routine keyname renvoie un pointeur vers une chaîne, comme décrit précédemment. Sinon, elle renvoie un pointeur null.

Exemples

int key;
char *name;
keypad(stdscr, TRUE);
addstr("Hit a key");
key=getch();
name=keyname(key);
Remarque: Si la touche Page Up est enfoncée, le nom de clé renvoie PAGE DE CLÉS.