DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV
  • Cas des tableaux
  • Cas des objets
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
VariableRAZ (Fonction)
En anglais : VariableReset
Remet la variable à sa valeur initiale.
Si la variable est une structure, une classe, une variable composée, la fonction remet tous les membres à leurs valeurs initiales.
Si la variable est un tableau, la fonction remet tous les éléments à leurs valeurs initiales sans modifier les dimensions du tableau.
Si la variable est un tableau associatif, une file, une pile ou une liste, la fonction VariableRAZ est équivalente à la fonction SupprimeTout : tous les éléments sont supprimés.
Exemple
MonTableau est un tableau de 5 entiers sur 2
VariableRAZ(MonTableau)
Syntaxe
VariableRAZ(<Nom de la variable>)
<Nom de la variable> : Type de la variable
Variable à réinitialiser.
Remarques

Cas des tableaux

Si la variable est de type Tableau, la taille du tableau ne change pas. Tous les éléments du tableau sont remis à leurs valeurs initiales :
  • Les booléens sont remis à Faux.
  • Les numériques sont remis à 0.
  • Les chaînes sont remises à chaîne vide ("").
  • Les membres des instances et des structures sont remis à leurs valeurs initiales.
  • Les instances, structures et tableaux dynamiques sont libérés.
Pour remettre la taille d'un tableau à une dimension à 0, utilisez la fonction TableauSupprimeTout.

Cas des objets

Si la variable est de type objet :
  • le destructeur est appelé
  • s'il s'agit d'une instance dynamique, l'objet est ensuite libéré.
  • s'il s'agit d'une instance non dynamique, le constructeur est ensuite appelé
Android Cas particulier en Java/Android
La notion de destructeur n'existe pas en Java/Android. Le code situé dans le destructeur d'une classe ne sera par conséquent jamais exécuté.
Un objet est libéré par le ramasse-miette (garbage collector) lorsqu'il n'est plus référencé dans l'application. Le moment où intervient cette libération n'est pas prévisible.
Pour forcer la libération d'un objet, il est possible de l'affecter à NULL ou d'utiliser l'instruction Libérer.
Composante : wd300vm.dll
Voir Aussi
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Variable de type champ
On peut utiliser VariableRAZ() avec une variable de type champ pour ne plus lui associer le champ qui était affecté précédemment.

Si une variable de type champ n'a pas un champ affecté, alors l'exécution de VariableRAZ() déclenche l'exception 1197 :
"No control is referenced by the 'xxxxx' variable"

Si une variable de type champ a été affectée à un champ qui n'est plus valide, alors l'exécution de VariableRAZ() déclenche l'exception 1198 :
"The control referenced by the 'xxxxx' variable is not valid anymore."

C'est la cas par exemple quand le fenêtre qui contient le contrôle a été refermée.
=JBO=
26 juil. 2024

Dernière modification : 22/08/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale