ADEL( )-Funktion

  • Artikel

Löscht ein Element aus einem eindimensionalen Array bzw. eine Zeile oder eine Spalte aus einem zweidimensionalen Array.

ADEL(ArrayName, nElementNumber [, 2])

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt das Array an, aus dem das Element, die Zeile oder Spalte gelöscht werden soll.

  • nElementNumber
    Legt die Nummer des Elements, der Zeile oder der Spalte fest, das bzw. die aus dem Array gelöscht werden soll. Wenn es sich um ein multidimensionales Array handelt, wird mit nElementNumber die Zeile angegeben. Um eine Spalte aus einem Array zu löschen, muss das optionale Argument 2 angegeben werden.

    Tipp   Weitere Informationen dazu, wie Sie auf Elemente in einem Array verweisen, finden Sie unter DIMENSION-Befehl.

  • 2
    Löscht eine Spalte aus dem Array.

Hinweise

Durch Löschen eines Elements oder einer Zeile aus einem Array wird die Größe des Arrays nicht geändert. Stattdessen werden die nachfolgenden Elemente, Zeilen oder Spalten in Richtung des Anfangs des Arrays verschoben, und das letzte Element, die letzte Zeile oder Spalte im Array wird auf Falsch (.F.) gesetzt. Wird eine Spalte gelöscht, werden die Werte der Elemente in der gelöschten Spalte auf Falsch (.F.) gesetzt, die nachfolgenden Elemente werden jedoch nicht verschoben.

Wurde das Element, die Zeile oder Spalte erfolgreich gelöscht, wird 1 zurückgegeben.

Beispiel

Im folgenden Beispiel wird ein Array erstellt und ausgefüllt; anschließend wird nach einem bestimmten Firmennamen gesucht, der nach dem Auffinden aus dem Array gelöscht wird.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE customer     && Open customer table
SELECT company FROM customer ;
   WHERE country = 'UK' ;
   INTO ARRAY gaCompanies
gnCount = _TALLY
gcName = 'Seven Seas Imports'
CLEAR
DISPLAY MEMORY LIKE gaCompanies
gnPos = ASCAN(gaCompanies, gcName)   && Search for company
IF gnPos != 0
   * Company found, remove it from the array
   = ADEL(gaCompanies, gnPos)
   gnCount = gnCount - 1
ENDIF
DISPLAY MEMORY LIKE gaCompanies

Siehe auch

ACOPY( ) | ADIR( ) | AELEMENT( ) | AFIELDS( ) | AINS( ) | ALEN( ) | ASCAN( ) | ASORT( ) | ASUBSCRIPT( ) | DIMENSION