Simscript III/Dictionnaire des instructions/DESTROY
L’énoncé destroy libère la zone mémoire allouée à une entité temporaire, un processus, un objet ou une entité permanente ou une ressource.
| Syntaxe : |
|
![{\displaystyle \color {blue}{\text{destroy }}\color {black}\left[{\begin{aligned}&\color {blue}{\text{the}}\\&\color {blue}{\text{this}}\\\end{aligned}}\color {black}\right]\left\{{\begin{aligned}&\left\{{\begin{aligned}&Nom{\text{ }}\!\!\_\!\!{\text{ }}Entit{\acute {e}}{\text{ }}\!\!\_\!\!{\text{ }}Temporaire\\&Nom{\text{ }}\!\!\_\!\!{\text{ }}Processus\\&Nom{\text{ }}\!\!\_\!\!{\text{ }}Objet\\\end{aligned}}\right\}{\text{ }}\!\![\!\!\color {blue}{\text{ called }}\color {black}Variable{\text{ }}\!\!\_\!\!{\text{ }}Pointeur{\text{ }}\!\!]\!\!{\text{ }}\\&\color {blue}{\text{each }}\color {black}\left\{{\begin{aligned}&Entit{\acute {e}}\_Permanente\\&Nom\_Ressource\\\end{aligned}}\right\}\\\end{aligned}}\right\}}](https://wikimedia.org/api/rest_v1/media/math/render/svg/bdca4e3eae95b645f7b23d7314bfa24a533477ce)
Nom_Entité_Temporaire est le nom d’une entité temporaire, Nom_Processus est le nom d’un processus, Nom_Objet est le nom d’un objet déclaré dans le preamble. Si called ... n’apparaît pas, c’est que la variable globale de même nom que l’entité contient effectivement le pointeur de l’entité que l’on veut détruire; sinon ce pointeur est dans Variable_Pointeur.
Attention!
- 1. Une entité qui est dans un ensemble ne peut être détruite; il faut auparavant la retirer (par un "remove") pour récupérer son pointeur.
- 2. Ne jamais détruire un processus interrompu ou suspendu, car la zone mémoire occupée par les variables locales n’est pas libérée. Il faut laisser le processus se détruire lui-même sur un return. On ne doit employer destroy sur un processus qu’après un cancel.
Exemple :
destroy each Train
destroy the Vol called AT_111
destroy une_Commande;
destroy this Unité_Sang;