DeleteAllElements

Top  Previous  Next

 

Löschte alle durch die Parameter näher bestimmten Elemente in der Selektionsmenge.

Mit dieser Funktion lassen sich bestimmte Elemente aus allen Objekten der Selektionsmenge löschen. Der Elementtyp wird über die Parameter bestimmt.

Voraussetzung

Die Selektionsmenge darf nicht leer sein.

Es muß ein Parameter angegeben sein.

Parameter

/TEXT

Steht dieser Parameter alleine (ohne DKY/nnn), werden alle Texte in der Selektionsmenge gelöscht.

/ATT

Steht dieser Parameter alleine (ohne NAME/s), werden alle Attribute in der Selektionsmenge gelöscht.

/STR

Steht dieser Parameter alleine (ohne DKY/nnn), werden alle Stringelemente in der Selektionsmenge gelöscht.

/SYM

Steht dieser Parameter alleine (ohne NUM/nnn), werden alle Symbole in der Selektionsmenge gelöscht.

DKY/nnn

Wenn zusätzlich der Parameter /STR oder /TEXT gesetzt ist, werden von allen Texten oder Strings in der Selektionsmenge nur solche mit dem angegebenen Zeichenschlüssel(n) gelöscht. Für nnn können auch mehrere DKY, durch Komma getrennt, angegeben werden.

NUM/nnn

Wenn zusätzlich der Parameter /SYM gesetzt ist, werden alle Symbole mit der angegebenen Symbolnummer (den angegebenen Symbolnummern) gelöscht. Alle anderen Symbole bleiben erhalten. Sollen Symbole mit unterschiedlichen Symbolnummern gelöscht werden, können für nnn auch mehrere Symbolnummern, durch Komma getrennt, angegeben werden.

NAME/s

Wenn zusätzlich der Parameter /ATT gesetzt ist, werden aus der Selektionsmenge alle Attribute mit dem angegebenen Attributnamen gelöscht.

/h

Es wird eine Kurzhilfe zu dem Befehl ausgegeben.

Rückgabewert

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

sonst

Fehler aufgetreten

Beispiel

DeleteAllElements /STR DKY/12

Aus der Selektionsmenge werden alle Stringelemente mit dem Zeichenschlüssel 12 gelöscht.

DeleteAllElements /STR /ATT /SYM NAME/Karl NUM/33

Aus der Selektionsmenge werden alle Stringelemente, alle Attribute mit dem Namen Karl und alle Symbole mit der Symbolnummer 33 gelöscht.

Bemerkung

Vorsicht! Der Löschvorgang erfolgt ohne Rückfrage und erstreckt sich auf die gesamte Selektionsmenge! Dieser Befehl kann erheblichen Schaden in den Daten anrichten und sollte nur dann verwendet werden, wenn man auch ganz genau weiß, was man tut.

Siehe auch

DeleteElement [DEL]

DeleteObject [DOB]

DeleteAttribute [DQL]