EXTRACT

Eine Spalte mit booleschen Werten oder ein Ausdruck, dessen Auswertung eine einzelne Spalte mit booleschen Werten ergibt. Boolesche Werte werden als null oder ungleich null interpretiert. Diese Spalte sollte mindestens so viele Zeilen enthalten wie der Datenbereich, aus dem die Daten extrahiert werden. Andernfalls wird Prädikatspalte auf die Anzahl der Zeilen begrenzt, die von der Makrofunktion EXTRACT verarbeitet werden (siehe die folgende "Beschreibung").

Daten

Die Werte, die extrahiert werden sollen. Dabei kann es sich um einen konstanten Wert, eine Spalte, einen Zellenbereich oder einen Ausdruck handeln, dessen Auswertung einen dieser Typen ergibt. Informationen zur Formatdefinition von Daten finden Sie im Abschnitt "Makrofunktionsparameter" im Kapitel des vorliegenden Handbuchs für Ihr IBM® Produkt.

Beschreibung

EXTRACT gibt die Zeilen im angegebenen Datenbereich zurück, die in der entsprechenden Zeile der Prädikatspalte den Wert eins aufweisen. Diese Makrofunktion reduziert Daten, indem sie alle Zeilen aussondert, deren entsprechender Wert in Prädikatspalte null ist. EXTRACT gibt für jede Eingabespalte eine neue Spalte zurück, die die Werte in der jeweiligen Eingabespalte enthält, deren entsprechender Wert in Prädikatspalte eins ist. Die extrahierten Zeilen von Daten belegen die ersten n Zellen der Ausgabespalten, wobei n die Anzahl der Einsen in Prädikatspalte ist.

Da EXTRACT zeilenweise vorgeht, wird für jede Zeile bis zum letzten Wert der kürzesten Spalte (d. h. der kürzesten Spalte von Prädikatspalte und den Spalten im Datenbereich Daten) ein Ergebnis erzeugt. Alle Werte ungleich null in Prädikatspalte ergeben in der Auswertung eins.

In der Regel empfiehlt es sich, eine Prädikatspalte zu erstellen, die eine der Vergleichsmakrofunktionen verwendet (==, >, <, ISEVEN, ISODD usw.). Dann können die fraglichen Zeilen mithilfe der Makrofunktion EXTRACT aus einem angegebenen Datenbereich extrahiert werden. Dies kann dazu verwendet werden, ungültige Dateneinträge auszusondern (etwa wenn ein bestimmter Wert den Maximal- oder Minimalwert für eine Datenvariable überschreitet). Darüber hinaus können alle Beispiele einer bestimmten Klasse konsolidiert werden (wenn z. B. die Spalte W3 bei einer der Ausgabeklassen Einsen und Nullen enthält, können Sie mit W4=EXTRACT(W3, W1:W2) die Eingaben W1 und W2 extrahieren). Da EXTRACT alle extrahierten Zeilen zu einem Datenblock komprimiert (d. h., den Zellenbereich WX[1:n]:WY füllt, wobei n die Anzahl der extrahierten Zeilen ist), kann die Funktion dazu verwendet werden, einen Zellenbereich von den aktuellen Zeilenpositionen in Zeile 1 bis n des Arbeitsblatts zu kopieren.

Beispiele

TEMP = EXTRACT(1, W1)

Erstellt eine neue Spalte TEMP, die eine Kopie von Spalte W1 enthält.

TEMP = EXTRACT(1, W1[50:100]:W2)

Erstellt zwei neue Spalten TEMP und WX, die in den ersten 51 Zellen Werte enthalten. Die Werte in der Spalte TEMP sind die Zellen 50-100 von Spalte W1, die Werte in der Spalte WX sind die Zellen 50-100 von Spalte W2.

TEMP = EXTRACT(W3, W1:W2)

Erstellt zwei neue Spalten TEMP und WX. Bei jeder Zeile, bei der der Wert in Spalte W3 eins ist, wird die entsprechende Zeile in den Spalten W1 und W2 in Spalte TEMP bzw. WX extrahiert.

TEMP = EXTRACT(W1>W2, W1)

Erstellt eine neue Spalte TEMP, die alle Werte in Spalte W1 enthält, die größer als die entsprechenden Werte in Spalte W2 sind.

TEMP = EXTRACT(W3[10:20], W1[10:20]:W2)

Erstellt zwei neue Spalten TEMP und WX. Bei den Zeilen 10-20, bei denen der Wert in Spalte W3 eins ist, wird die entsprechende Zeile in den Spalten W1 und W2 in Spalte TEMP bzw. WX extrahiert.

Zugehörige Funktionen

Funktion	Beschreibung
IF	Leitet eine If-then-else-Anweisung einer bedingten Aussage ein.
SELECT	Gibt die angegebene(n) Spalte(n) aus einem Datenbereich zurück.
SUBSAMPLE	Reduziert Daten durch Rückgabe jedes n-ten Zeilenwerts.
SUBSTITUTE	Ersetzt Werte in einer Spalte durch einen Wert, der in einer Konvertierungstabelle angegeben ist.