DESCRIPTION.

L'instruction composée RESTORE LOCAL permet de restaurer les valeurs initiales des paramètres passées lors de l'appel d'une procédure ou d'une fonction personnalisée, ainsi que celle des varaibles locales et privées de cette procédure ou fonction.

SYNTAXE.

RESTORE LOCAL 

REMARQUES.

L'instruction composée RESTORE LOCAL ne peut être utilisé qu'à l'intérieur de la définition d'une procédure ou d'une fonction personnalisé.

Lors de l'appel d'une procédure ou d'une fonction personnalisée, le programme peut avoir besoin de passer une ou plusieurs valeurs à cette procédure ou fonction pour son bon fonctionnement, dans le BBC BASIC ses valeurs son nommées paramètres formelles de la procédure ou de la fonction. De plus, il est possible de déclarer, pour cette procédure ou fonction des variables de portée locales, c'est-à-dire consultable ou modifiable uniquement dans cette procédure ou fonction, soit avec l'instruction LOCAL qui ne préservera pas la dernière affectation, soit avec l'instruction PRIVATE qui préservera la dernière valeur affectée à la variable à la sortie de la procédure ou de la fonction. 

Durant l'exécution de cette procédure ou fonction, ces valeurs souvent modifiées, l'instruction RESTORE LOCAL permet de réaffecter à ces variables, formelles, locales et privées à la valeurs qu'elles avaient à l'entrée de cette procédure ou fonction.

Bien que l'on puisse utiliser l'instruction composée RESTORE LOCAL pour restaurer l'état initiale des valeurs pour n'importe quelle raison, elle sera principalement utilisée après avoir corrigé une erreur dans un gestionnaire d'erreur général, initié avec l'instruction composée ON ERROR ou mais plus généralement dans un gestionnaire d"erreur local activé par l'instruction composée ON ERROR LOCAL.

Note : après avoir restaurée les valeurs initiales l'instruction composée RESTORE LOCAL exécutera les instructions composées RESTORE DATA et RESTORE ERROR. 

Voir l'instruction FN pour plus de détails sur la définition et l'utilisation d'une fonction personnalisée.

Voir l'instruction PROC pour plus de détails sur la définition et l'utilisation d'une procédure personnalisée.

RUBRIQUES.

Gestion de erreurs pour plus de détails sur la gestion des erreurs.

Liste des erreurs pour plus de détails sur la gestion des erreurs.

EXEMPLES.

PROC_Test( 3 )

PROC_Test( 7 )

PRINT "Test termine. Au revoir."

END

DEF PROC_Test( Q )

LOCAL klocal

PRIVATE kprive

RESTORE LOCAL

klocal = 0

kprive = kprive + 4 + Q

ON ERROR LOCAL PRINT "oups!" : klocal = 1

PRINT klocal , kprive , Q

ktest = 10 / klocal

ENDPROC