FunktionenWertelisten (Arrays) erlauben die Zusammenfassung verschiedener Werte in eine Liste. Ein Werteliste kann Werter verschiedener Datentypen sowie null beinhalten.
| Wertebereich Funktionen | Syntax | |
|---|---|---|
|
VALUES - WERTE - ARRAY |
Erzeugt eine Werteliste aus den übergebenen Parametern.
Beispiel: =VALUES("a", "b", "c") oder =VALUES(1, 2+5, 4) Siehe auch Einträge von Listenkomponenten setzen |
VALUES(number Wert1; [number Wert2]; [number ...]) Wert1: einen beliebigen Wert der in die Werteliste aufgenommen werden soll. |
|
AREAS - BEREICHE |
Erzeugt einen Werteliste aus den zugrundeligenden Datenbankdaten einer Komponente die das Interface DataBean implementiert. Dies triff
auf die folgenden eva/3 Application Builder Komponenten zu:
Bei angabe mehrerer Komponenten, werden die Wertelisten in der Reihenfolge der Komponentenaufzählung gebildet. Beispiel: =AREAS([txt_personen_id]) Bildet eine Werteliste aus der Datenbankspalte die mit der Eigenschaft ControlSource in der Komponente mit dem Namen txt_personen_id festgelegt wurde. =AREAS([txt_personen_id1], [txt_personen_id2]) Bildet eine Werteliste aus den Datenbankspalten beider genannten Komponenten. Hinweis: Die Daten der Spalten werden für die Wertelistenbildung vollständig in den Speicher geladen. Die Funktion ist nicht für große Tabellen geeignet! Siehe auch Leeren Eintrag in die Liste einer SComboBox oder SList generieren |
AREAS(variant Verweis1; [variant Verweis2]; [variant ...]]) Verweis1: Verweis auf eine Komponente aus der eine Werteliste zu bilden ist. |
|
ISARRAY - ISTDATENFELD |
Prüft ob der übergebene Wert eine Werteliste ist. Gibt die boolsche Konstante true zurück,
wenn es sich bei dem übergebenen Wert um eine Werteliste handelt, false wenn nicht.
Beispiel: =ISARRAY(VALUES("a", "b", "c")) mit dem Ergebnis true. |
ISARRAY(values Wert) Wert: Wert der auf eine Werteliste zu prüfen ist. |
|
JOIN - VERBINDEN |
Erzeugt eine Zeichenkette aus den Werten einer ein- oder mehrdimensionalen Werteliste. Bei Spezifizierung eines Trennzeichens wird außerdem das Trennzeichen
zwischen jeden Wert und dessen Folgewert der Werteliste eingefügt.
Beispiel: =JOIN(VALUES("a"; "b"); "_"]) mit dem Ergebnis a_b. |
JOIN(values Werteliste; [literal Trennzeichen]) Werteliste: Werteliste aus der die Zeichenkette gebildet werden soll. Trennzeichen: Trennzeichen das zwischen die Werte der Werteliste eingefügt werden soll. Standardwert ist ein Leerzeichen. |
|
SPLIT - TEILEN |
Erzeugt eine Werteliste aus einer Zeichenkette, wobei das Trennzeichen verwendet wird um die Abgrenzungen für die Einträge der
Werteliste festzulegen.
Beispiel: =SPLIT("Hallo Welt"; " "; -1;) erzeugt eine Werteliste mit den Einträgen Hallo und Welt. |
=SPLIT(literal Zeichenkette; [literal Trennzeichen]; [number Obergrenze]; [number Modus]) Zeichenkette: Eine Zeichenkette die in eine Werteliste aufgeteielt werden soll. Trennzeichen: Trennzeichen das die Werte der Zeichenkette abgrenzt. Standardwert ist ein Leerzeichen. Obergrenze: Anzahl der maximal zu erzeugenden Werte. Werte die das Limit überschreiten werden nicht in die Werteliste aufgenommen. Der Standardwert ist -1 für die Aufnahme aller erzeugten Werte. Modus: Vergleichsmodus 0 für den Binären (Groß-/Kleinschreibung beachtend) Vergleichsmodus oder 1 für den Textvergleichsmodus (Groß-/Kleinschreibung wird ignoriert). (Standardwert 1) |
|
FILTER |
Erlaubt die Reduzierung einer ein- oder mehrdimensionalen Wertliste auf jene Werte die dem Filter entsprechen.
Beispiel: =FILTER(VALUES("A", "b"), "a") erzeugt eine Werteliste mit dem Eintrag A. |
=FILTER(values Werteliste; literal Filterwert; [boolean Inklusive]; [number Modus]; [boolean Regulärer Ausdruck]) Werteliste: Die zu filternde Werteliste. Filterwert: Eine Zeichenkette die den Filterwert enthält. Inklusive: Eine boolsche Konstante die entscheidet ob alle zutreffenden Werte übernommen werden oder alle nicht zutreffenden. Besitzt dieses Parameter den Wert true, so werden alle zutreffenden Werte in die gefilterte Werteliste übernommen. Andernfalls werden alle nicht zutreffenden Werte in die Werteliste übernommen. Der Standardwert ist true. Modus: Vergleichsmodus 0 für den Binären (Groß-/Kleinschreibung beachtend) Vergleichsmodus oder 1 für den Textvergleichsmodus (Groß-/Kleinschreibung wird ignoriert). (Standardwert 1) Regulärer Ausdruck: Ermöglicht die Verwendung des Parameter Filterwert als regulären Ausdruck. Wird Regulärer Ausdruck der Wert true übergeben, so wird der Filterwert als regulärer Ausdruck verwendet. Ergibt der Reguläre Ausdruck auf den Wert der Werteliste true, so wird der Wert in die gefilterte Werteliste übernommen. Wird Regulärer Ausdruck der Wert false übergeben, so wird nach dem Vorkommen des Filterwert im Eintrag der Werteliste geprüft. |
|
UBOUND - GRENZEO |
Gibt die Position des letzten Wertes der Werteliste zurück. Die erste Position wird von 0 an ermittelt. Der Rückgabewert ist immer ein Zahlenwert.
Beispiel: =UBOUND(VALUES("a", "b")) mit dem Ergebnis 1. |
=UBOUND(values Werteliste) Werteliste: Die Werteliste dessen Position des letzten Eintrages ermittelt werden soll. |
|
UNION - VEREINIGUNG |
Gibt ein Array zurück, das aus den Werten zwei verschiedener Arrays besteht.
Beispiel: =UNION(VALUES(4,1,7,3), VALUES(1,9,3,2)) mit dem Ergebnis VALUES(4, 1, 7, 3, 1, 9, 3 ,2). |
=UNION(values first, values second, ) first: Die Werteliste die mit der zweiten kombiniert wird. second: Die Werteliste die mit der ersten kombiniert wird. |
|
DUPLICATES - DOPPELTE |
Findet alle Werte raus die in beiden Arrays vorkommen und gibt ein neues Array zurück, das aus den doppelten Werten besteht.
Beispiel: =DUPLICATES(VALUES(4,1,7,3), VALUES(1,9,3,2)) mit dem Ergebnis VALUES(1, 3). |
=DUPLICATES(values first, values second, ) first: Die Werteliste die nach Werten durchsucht wird, die auch in dem zweiten Array vorhanden sind. second: Die Werteliste die nach Werten durchsucht wird, die auch in dem ersten Array vorhanden sind. |
|
DIFFERENCE - UNTERSCHIED |
Findet alle Werte raus die nicht in beiden Arrays vorkommen und gibt ein neues Array zurück, das aus den nicht doppelten Werten besteht.
Beispiel: =DIFFERENCE(VALUES(4,1,7,3), VALUES(1,9,3,2)) mit dem Ergebnis VALUES(4, 9, 7, 2). |
=DIFFERENCE(values first, values second) first: Die Werteliste die nach Werten durchsucht wird, die nicht in dem zweiten Array vorhanden sind. second: Die Werteliste die nach Werten durchsucht wird, die nicht in dem ersten Array vorhanden sind. |
|
RESIZE |
Verändert die Größe eines einer bestehenden Werteliste. Ist die neue Größe der Werteliste kleiner als der der Alten, so werden die
Werte am Ende der alten Werteliste verworfen. Ist die neue Größe größer, so enthalten die neu entstanden Felder null.
Beispiel: =RESIZE(VALUES(4,1,7,3), 2) mit dem Ergebnis VALUES(4, 1). |
=RESIZE(values Werteliste; number größe) Werteliste: Die Werteliste deren Größe verändert werden soll. größe: Die neue Größe der Werteliste. |
|
EXISTS |
Sucht nach einem Wert in einer ein- oder mehrdimensionalen Werteliste und gibt true zurück, wenn der Wert gefunden wurde, oder false, wenn nicht.
Beispiel: =EXISTS(VALUES(4,1,7,3), 2) mit dem Ergebnis false. |
=EXISTS(values Werteliste; literal Suchwert; [number Modus]; [boolean Regulärer Ausdruck]) Werteliste: Die Werteliste, die durchsucht werden soll. Suchwert: Der Wert, der in der Werteliste zu suchen ist. Modus: Vergleichsmodus 0 für den Binären (Groß-/Kleinschreibung beachtend) Vergleichsmodus oder 1 für den Textvergleichsmodus (Groß-/Kleinschreibung wird ignoriert). (Standardwert 1) Regulärer Ausdruck: Ermöglicht die Verwendung des Parameter Suchwert als regulären Ausdruck. Wird Regulärer Ausdruck der Wert true übergeben, so wird der Suchwert als regulärer Ausdruck verwendet. Ergibt der Reguläre Ausdruck auf den Wert der Werteliste true, so ist auch der Rückgabewert true. |
|
APPEND |
Hängt einen Eintrag an das Ende der Werteliste an. Die Werteliste wird in Ihrer Größe um eins erhöht.
Beispiel: =APPEND(VALUES(4,1,7,3), 2) mit dem Ergebnis VALUES(4,1,7,3, 2). |
=APPEND(values Werteliste; variant Wert) Werteliste: Die Werteliste, an die ein weiterer Wert angehängt werden soll. Wert: Der Wert, der an das Ende der Werteliste anzuhängen ist. |
|
PREPEND |
Fügt einen Eintrag an den Beginn der Werteliste an. Die Werteliste wird in Ihrer Größe um eins erhöht.
Beispiel: =PREPEND(VALUES(4,1,7,3), 2) mit dem Ergebnis VALUES(2, 4,1,7,3). |
=PREPEND(values Werteliste; variant Wert) Werteliste: Die Werteliste, an die ein weiterer Wert eingefügt werden soll. Wert: Der Wert, der an den Anfang der Werteliste anzuhängen ist. |
|
PUT |
Fügt einen Eintrag in eine Werteliste an den vorgegebenen index ein. Enthält die Werteliste an dem eingegebenen Index
bereits einen Eintrag, so wird dieser durch den neuen ersetzt. Liegt der Index jenseits der vorhandenen Werteliste,
so wird die Werteliste erweitert. Ist der Index ein negativert Wert, so wird der Wert um den Indexwert vor die bestehenden
Einträge eingefügt. Der Wertelisteninhalt verschiebt sich damit um den angegebenen Indexwert.
Beispiel: =PUT(VALUES(4,1,7,3); 2; -2) mit dem Ergebnis VALUES(2,null,4,1,7,3). =PUT(VALUES(4,1,7,3); 2; 0) mit dem Ergebnis VALUES(2,1,7,3). |
=PUT(values Werteliste; variant Wert; number index) Werteliste: Die Werteliste, in die der Wert eingefügt werden soll. Wert: Der Wert, der in die Werteliste eingefügt werden soll. Index: Der index in die der Wert in die Werteliste eingefügt werden soll. Der erste Eintrag beginnt mit dem Index 0. |
|
REVERSE |
Kehrt die Werte einer Werteliste um.
Beispiel: =REVERSE(VALUES(4,1,7,3)) mit dem Ergebnis VALUES(3,7,1,4). |
=REVERSE(values Werteliste) Werteliste: Die umzukehrende Werteliste. |
|
DISTINCT |
Entfernt doppelte Einträge aus einer Werteliste.
Beispiel: =DISTINCT(VALUES("1", "2", "2")) erzeugt eine Werteliste mit dem Ergebnis VALUES("1", "2"). |
=DISTINCT(values Werteliste; [number Modus]) Werteliste: Die zu Werteliste aus der doppelte Einträge zu entfernen sind. Modus: Vergleichsmodus 0 für den Binären (Groß-/Kleinschreibung beachtend) Vergleichsmodus oder 1 für den Textvergleichsmodus (Groß-/Kleinschreibung wird ignoriert). (Standardwert 1) |
|
EXTRACT |
Extrahiert den Teil einer Werteliste zwischen Start- und Endwert. Liegt der Endwert hinter dem letzten Eintrag
der Werteliste, so werden die Werte vom Startwert an bis zum letzten Eintrag extrahiert.
Beispiel: =EXTRACT(VALUES("1", "2", "3"), 0, 2) erzeugt eine Werteliste mit dem Ergebnis VALUES("1", "2"). |
=EXTRACT(values Werteliste; [number Start]; number End) Werteliste: Die Werteliste aus der Einträge extrahiert werden sollen. Start: Definert den Beginn des Wertelistenbereiches der extrahiert werden soll. (Standardwert 0) End: Definert das Ende des Wertelistenbereiches der extrahiert werden soll. |
|
SHUFFLE |
Bringt die Einträge einer Werteliste in eine zufällige Reihenfolge.
Beispiel: =SHUFFLE(VALUES("1", "2", "3")) erzeugt z.B. eine Werteliste mit dem Ergebnis VALUES("2", "3", "1"). |
=SHUFFLE(values Werteliste) Werteliste: Die Werteliste die zufällig gemischt werden soll. |
|
REMOVE |
Entfernt einen Eintrag aus einer Werteliste. Liegt der Index vor oder hinter dem letzten Eintrag der Werteliste,
so wird kein Eintrag entfernt.
Beispiel: =REMOVE(VALUES("1", "2", "3"), 1) erzeugt eine Werteliste mit dem Ergebnis VALUES("1", "3"). |
=REMOVE(values Werteliste; number Index) Werteliste: Die zu Werteliste aus der ein Eintrag entfernt werden soll. Index: Definiert die Position des Eintrages in der Werteliste, der entfernt werden soll. Der Index einer Werteliste beginnt mit 0 für den ersten Eintrag. |
|
RANDOMVALUE |
Extrahiert einen zufälligen Eintrag aus einer Werteliste.
Beispiel: =RANDOMVALUE(VALUES("1", "2", "3")). |
=RANDOMVALUE(values Werteliste) Werteliste: Die zu Werteliste aus der ein zufälliger Eintrag extrahiert werden soll. |
|
DETACHFIRST |
Entfernt den ersten Eintrag aus einer Werteliste.
Beispiel: =DETACHFIRST(VALUES("1", "2", "3")) erzeugt eine Werteliste mit dem Ergebnis VALUES("2", "3"). |
=DETACHFIRST(values Werteliste) Werteliste: Die zu Werteliste aus der der ersten Eintrag entfernt werden soll. |
|
DETACHLAST |
Entfernt den letzten Eintrag aus einer Werteliste.
Beispiel: =DETACHLAST(VALUES("1", "2", "3")) erzeugt eine Werteliste mit dem Ergebnis VALUES("1", "2"). |
=DETACHLAST(values Werteliste) Werteliste: Die zu Werteliste aus der der letzte Eintrag entfernt werden soll. |
|
CLEAR |
Entfernt alle Einträge aus einer Werteliste.
Beispiel: =CLEAR(VALUES("1", "2", "3")) erzeugt eine Werteliste mit dem Ergebnis VALUES(). |
=CLEAR(values Werteliste) Werteliste: Die Werteliste aus der alle Einträge entfernt werden sollen. |
|
DIVIDE |
Verteilt die Werte einer eindimensionale Werteliste linear in mehrere Wertelisten. Der Neubeginn der Verteilung
wird mit dem Parameter "Anzahl" gesteuert.
Beispiel: =DIVIDE(VALUES(1, "ja", 2, "nein", 3, "vielleicht"), 2) erzeugt eine zweidimensionale Werteliste mit dem Ergebnis VALUES(VALUES(1, 2, 3), VALUES("ja", "nein", "vielleicht")). |
=DIVIDE(values Werteliste; [number Anzahl]) Werteliste: Die zu Werteliste deren Werte verteilt werden sollen. Anzahl: Definiert die Anzahl der Wertelisten auf die die Werte verteilt werden. Standardwert ist 2. |
|
CONSOLIDATE |
Vereinigt eine beliebige Anzahl von Wertelisten, wobei diese nicht wie bei UNION untereinander vereinigt werden, sondern
eine mehrdimensionale Werteliste erzeugt, die jeweils einen Eintrag aus allen Wertelisten enthält. Dies ist besonders dann
nützlich, wenn Wertepaare aus mehrern Tabellen zusammengeführt werden sollen.
Beispiel: =CONSOLIDATE(VALUES(1, 2, 3), VALUES("Jan", "John", "Johan")) erzeugt eine zweidimensionale Werteliste mit dem Ergebnis VALUES( VALUES(1, "Jan"), VALUES(2, "John"), VALUES(2, "Johan") ). Siehe auch ShowColumn und BoundColumn aus Tabelle erzeugen |
=CONSOLIDATE(values Werteliste1; [values Werteliste2]; [values Werteliste...]) Werteliste: Die zu Wertelisten deren Werte consolidiert werden sollen. |
|
SORT |
Sortiert eine Werteliste. Die Werte werden in ihrer Wertigkeit auf- oder absteigend sortiert. Null-Werte werden
in ihrer Wertigkeit als Leerstring behandelt.
Beispiel: =SORT(VALUES(1, 3, 2)) erzeugt eine Werteliste mit dem Ergebnis VALUES(1, 2, 3). |
=SORT(values Werteliste; [number Algorithmus]; [number Richtung]; [number Comparator]) Werteliste: Die zu sortierende Werteliste Algorithmus: Der zu verwendende Sortieralgorithmus:
Richtung: Aufsteigende oder Absteigende Sortierung:
Comparator: Entscheidet über die Sortierungsart:
|
|
MIN - KLEINSTE |
s. Aggregatsfunktionen
Beispiel: =MIN(VALUES(5,1,2,3)) mit dem Ergebnis 1. |
|
|
MAX - GRÖSSTE |
s. Aggregatsfunktionen
Beispiel: =MAX(VALUES(5,1,2,3)) mit dem Ergebnis 5. |
|
|
AVG - MITTELWERT |
s. Aggregatsfunktionen
Beispiel: =AVG(VALUES(5,1,2,3)) mit dem Ergebnis 2.75. |
|
|
SUM - SUMME |
s. Aggregatsfunktionen
Beispiel: =SUM(VALUES(5,1,2,3)) mit dem Ergebnis 11. |
|
|
COUNT - ANZAHL |
s. Aggregatsfunktionen
Beispiel: =COUNT(VALUES(5,1,2,3)) mit dem Ergebnis 4. |
|
|
FIRST - ERSTER |
s. Aggregatsfunktionen
Beispiel: =FIRST(VALUES(5,1,2,3)) mit dem Ergebnis 5. |
|
|
LAST - LETZTER |
s. Aggregatsfunktionen
Beispiel: =LAST(VALUES(5,1,2,3)) mit dem Ergebnis 3. |
|