INKEY$

Syntaxe

Description

Cette fonction retourne sous forme de chaîne de caractères la valeur du caractère en attente sur clavier s'il y a lieu.

Remarques

• La fonction INKEY$ renvoie une chaîne de caractères de 0, 1 ou 2 caractères reflétant l'état du tampon clavier.
• Une chaîne de caractères nulle (LEN(s$) = 0) signifie que le tampon est vide. Une chaîne de caractères de longueur (LEN(S$) = 1) signifie que la chaîne de caractères contient la valeur ASCII de la dernière touche enfoncée. Par exemple, 13 pour Enter (également appelé retour chariot), 65 pour A.
• Une chaîne de deux caractères (LEN(s$) = 2) signifie qu'une touche non-ASCII a été enfoncée. Le premier caractère de la chaîne de caractères a la valeur 0 et le second, un code de clavier étendu, représente l'une des touches non-ASCII du clavier, telles que Home, PgDn ou les touches de flèches.
• Si vous appuyez sur une touche de fonction définie (voir l'instruction KEY), la fonction INKEY$ renvoie la séquence de caractères (un par appel de INKEY$) ayant été obtenue si les caractères de la définition avaient été saisis indépendamment.
• La fonction INKEY$ est conçu comme un mécanisme à toute épreuve pour obtenir une entrée utilisateur dans votre programme sans les restrictions de l'instruction INPUT. Comme INKEY$ n'attend pas qu'un caractère soit pressé avant de renvoyer un résultat, vous l'utiliserez généralement dans une boucle d'un sous-programme de bas niveau, en le vérifiant continuellement et en construisant une chaîne de caractères d'entrée devant être vérifiée par des routines de niveau supérieur.
• La fonction INKEY$ transmet toutes les combinaisons de touches, y compris les touches de contrôle telles que Tab, Enter et BackSpace, à votre programme sans les afficher ni les traiter, à l'exception des cas suivants : Ctrl+Break termine le programme sauf si l'option de pause au clavier a été désactivée lors de la compilation du programme. Ctrl+Alt+Delete provoque une réinitialisation du système, Shift+PrintScreen effectue un vidage d'écran.

Exemple

Voici un exemple typique de l'utilisation de cette fonction :

on obtiendra le résultat suivant :

Références

INFOGUIDE - Turbo Basic, Editions P.S.I., Bénédicte Hudault, 1988, ISBN: 2-86595-531-1, page 52