$MAPDEL
Function:
Deletes the line specified by the key from a sorted work area.
Format:
$MAPDEL <ctrlf> <key1> [...<key8>]
Parameters:
|
<ctrlf> |
Specifies how the individual key values <key1> to <key8> are interpreted:
|
|
<key1> ... <key8> |
Key values for accessing the work area |
Description:
| • | The command looks in the current work area for the key specified in <key1> to <key8>. If the specified key is found, the line which contains it is deleted from the work area. |
| • | The characters N and S used in the string in <ctrlf> define how the key values specified in <key1> to <key8> are interpreted: |
| – | N signifies that the corresponding key value <keyn> should be interpreted as a numeric value, either an integer or a floating point number. A plus or minus sign may appear before the numeric value. |
| – | S signifies that the corresponding key value <keyn> should be interpreted as a string. |
The string in <ctrlf> can have a maximum of 8 characters.
Example:
This example demonstrates how to delete a line that contains a particular key value.
Consider a work area with this structure:
CS Cornelia Schollbach
EG Ellen Gorlow LT
GG Guenter Gehl LTS
UF Ursula Flohrer
Then this command will delete the line containing the key CS from the work area:
$MAPDEL S CS
After the command is executed, the work area will have this content:
EG Ellen Gorlow LT
GG Guenter Gehl LTS
UF Ursula Flohrer
Return Codes:
|
1 to 8 |
The value corresponding to <keyn> is missing or does not have the specified format. |
|
B |
The content of the work area does not match the key specified by <keyn>; not enough words in the work area or the words do not have the data type specified in <ctrlf>. |
|
F |
No line with a matching key was found in the work area |
|
S |
One of the characters specified in <ctrlf> is invalid or the string exceeds 8 characters. |
|
T |
Command executed successfully |