DESCRIPTION.

La fonction FNinkey() attend un certain temps qu'une touche soit enfoncée et retourne le code ASCII de celle-ci.

La fonction FNinkey$() attend un certain temps qu'une touche soit enfoncée et retourne le symbole de celle-ci.

SYNTAXE.

kvaleur = FNinkey( option )

kcaractère$ =  FNinkey$( option )

REMARQUES.

option doit être un nombre entier.

Si option est positif ou nul, il précise le temps d'attente maximum en millisecondes (ms) avant de reprendre l'exécution du programme.

Si cette durée est écoulé sans qu'une touche ait été enfoncé FNinkey() retournera -1 et FNinkey$() retournera une chaine de caractères vide.

Si tampon du clavier n'est pas vide, ou s'il reçoit une valeur, parce qu'une touche viens d'être actionnée, durant le délai défini par option, l'instruction FNinkey() retournera un nombre entier compris entre 0 et 255, correspondant au code ASCII de la touche du clavier qui viens d'être enfoncée et l'instruction FNinkey$() retourne une chaine d'un unique caractère, correspondant à la touche du clavier qui viens d'être enfoncée.

Si option vaut 0, l'instruction FNinkey() et/ou FNinkey$() retournera une valeur immédiatement.

Si option est négatif, il précise le un code identifiant la touche à tester.

Si cette touche est enfoncée quand le programme rencontre cette instruction FNinkey() retournera -1, c'est-à-dire TRUE, vraie, sinon FNinkey() retournera 0, c'est-à-dire FALSE, faux.

Les codes des touches dépendent du type de disposition du clavier : AZERTY, QWERTY, ... il faudra donc être prudent, en particulier sur la région de diffusion de votre programme, lors de l'utilisation des instructions FNinkey() et/ou FNinkey$() avec des valeurs négatives.

Voir l'instruction INKEY() pour plus de détails sur son utilisation.

Voir l'instruction INKEY$() pour plus de détails sur son utilisation.

Les fonctions FNinkey() et FNinkey$() sont importées depuis le module nowait.bbc. 

EXEMPLES.

1. Utilisation de FNinkey$() pour obtenir le symbole de la touche.

INSTALL @lib$ + "nowait.bbc"

REPEAT

PRINT "Appuyer sur Q pour arreter ... " ; 

ktouche$ =FNinkey$( 80 ) 

IF ktouche$ = "" THEN PRINT "pas de touche utilisee." ELSE PRINT "Vous avez appuyez sur " ; ktouche$

UNTIL ktouche$ = "Q" OR ktouche$ = "q"

PRINT "Test termine. Au revoir."

END

2. Utilisation de FNinkey() pour obtenir le code ASCII de la touche.

INSTALL @lib$ + "nowait.bbc"

REPEAT

PRINT "Appuyer sur Q pour arreter ... " ; 

ktouche = FNinkey( 80 ) 

IF ktouche = 0 THEN PRINT "pas de touche utilisee." ELSE PRINT "Vous avez appuyez sur " ; CHR$( ktouche )

UNTIL ktouche = 81 OR ktouche = 113

PRINT "Test termine. Au revoir."

END