4D v14.3

CREATE SELECTION FROM ARRAY

Home

 
4D v14.3
CREATE SELECTION FROM ARRAY

CREATE SELECTION FROM ARRAY 


 

CREATE SELECTION FROM ARRAY ( Tabellenname ; DatensatzArray {; Auswahlname} ) 
Parameter Typ   Beschreibung
Tabellenname  Tabelle in Tabelle zum Erstellen der Auswahl
DatensatzArray  Lange Ganzzahl, Array Boolean in Array der Datensatznummern oder Array der Booleans:
Wahr = Datensatz in Auswahl
Falsch = Datensatz nicht in Auswahl
Auswahlname  String in Name der zu erstellenden temporären Auswahl
Ohne Angabe Befehl auf die aktuelle Auswahl anwenden

Der Befehl CREATE SELECTION FROM ARRAY erstellt die temporäre Auswahl Auswahlname:

  • entweder aus einem Array der absoluten Datensatznummern DatensatzArray aus Tabellenname,
  • oder aus einem Array mit Booleans. In diesem Fall geben die Werte des Array für jeden Datensatz an, ob er in Tabellenname zu Auswahlname gehört (True) oder nicht (False).

Übergeben Sie den Parameter Auswahlname nicht oder einen leeren String, arbeitet der Befehl mit der aktuellen Auswahl, die dann aktualisiert wird.

Verwenden Sie mit diesem Befehl ein Array vom Typ Lange Ganzzahl, entsprechen die Nummern des Array den Datensatznummern in Auswahlname. Ist eine Nummer nicht korrekt (nicht erstellter Datensatz), wird der Fehler -10503 erzeugt.

Hinweis: Stellen Sie sicher, dass das Array keine Zeilen enthält, die denselben Wert haben, denn dann erhalten Sie als Ergebnis eine nicht korrekte Auswahl.

Verwenden Sie mit diesem Befehl ein Array vom Typ Boolean, gibt das N-te Element des Array an, ob der Datensatz mit der Nummer N in Auswahlname (True) ist oder nicht (False) ist. Die Anzahl der Elemente in DatensatzArray muss mit der Anzahl der Datensätze in Tabellenname übereinstimmen. Ist das Array kleiner als die Anzahl der Datensätze, können nur die im Array definierten Datensätze für die Auswahl verwendet werden.

Hinweis: Bei einem Array mit Booleans verwendet der Befehl Elemente der Nummern 0 bis N-1.

Warnung: Eine temporäre Auswahl wird im Speicher erstellt und geladen. Sorgen Sie deshalb vor Ausführen dieses Befehls für ausreichend Speicherplatz.

Bei einer ungültigen Datensatznummer (Datensatz wird nicht erstellt) wird der Fehler -10503 generiert. Sie können ihn mit einer Methode abfangen, die über den Befehl ON ERR CALL aufgerufen wird.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Temporäre Auswahl
Nummer: 640

Dieser Befehl ändert die Systemvariable ErrorDieser Befehl ändert die aktuelle Auswahl

 
GESCHICHTE 

Geändert: 4D v6.7

 
SIEHE AUCH 

CLEAR NAMED SELECTION
COPY NAMED SELECTION
CREATE SET FROM ARRAY
Konventionen
LONGINT ARRAY FROM SELECTION
USE NAMED SELECTION

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)