☜	KILL 1984 Version of ANSI Standard					☞

3.6.10 KILL

K[ILL] postcond

│ │ │

[ ] L killargument

│ │ │

The three argument forms of KILL are given the following names.

1. Empty argument list: Kill All.
2. glvn: Selective Kill.
3. (L lvn): Exclusive Kill.

Killing the variable M sets $D(M) = 0 and causes the value of M to be undefined. Any attempt to obtain the value of M while it is undefined is erroneous. Killing a variable whose $D = 0 has no effect except for possible side effects on the naked indicator.

To kill a variable with the unsubscripted name N also kills all subscripted variables with the same name N.

To kill an m-tuply subscripted variable N(v₁, v₂, ..., v_m) with name N and subscript values v₁, v₂, ..., v_m also kills all n-tuply subscripted variables N(v₁, v₂, ..., v_m, v_m+1, ..., v_n), for all n > n, with the same N and identical values for the first subscripts. (These derived n-tuply subscripted variables are called the "descendants" of the m-tuply subscripted variable.)

• The Kill All form kills all local variables.
• The Selective Kill form kills the variables named.

In the Exclusive Kill form lvn must not contain subscripts, although lvn may have descendants. Exclusive Kill kills all local variables except those named and their descendants.

If M is not killed but N, a descendant of M, is killed, the killing of N effects the value of $D(M) as follows: if N is not the only descendant of M, $D(M) is unchanged; if M has a defined value $D(M) changes from 11 to 1; if M does not have a defined value $D(M) changes from 10 to 0.

See also the transition diagram for Kill.

Copyright © Standard Documents; 1977-2024 MUMPS Development Committee;
Copyright © Examples: 1995-2024 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2024 Ed de Moel.

This page most recently updated on 15-Nov-2023, 14:44:03.

For comments, contact Ed de Moel (demoel@jacquardsystems.com)