Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19.8
collection.slice( )

collection.slice( ) 


 

collection.slice ( StartAb {; Ende} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
StartAb  Lange Ganzzahl in Start Index (enthalten)
Ende  Lange Ganzzahl in Ende Index (nicht enthalten)
Funktionsergebnis  Collection in Neue Collection mit ausgeschnittenen Elementen (flache Kopie)

Die Funktion collection.slice( ) gibt einen Ausschnitt einer Collection in einer neuen Collection zurück, definiert von StartAb bis Ende (Ende ist nicht enthalten). Diese Funktion gibt eine flache Kopie der Collection zurück. Ist die ursprüngliche Collection eine shared collection, ist die zurückgegebene Collection auch eine shared collection.

Hinweis: Dieser Befehl ändert nicht die ursprüngliche Collection.

Die zurückgegebene Collection enthält das in StartAb angegebene Element und alle darauffolgenden Element bis zum in Ende angegebenen Element (nicht enthalten) Ist nur der Parameter StartAb angegeben, enthält die zurückgegebene Collection alle Elemente ab StartAb bis zum letzten Element der ursprünglichen Collection.

  • Ist StartAb < 0, wird es als StartAb:=StartAb+Länge neu berechnet (es wird als Versatz vom Ende der Collection gewertet).
  • Ist der berechnete Wert < 0, wird StartAb auf 0 gesetzt.
  • Ist Ende < 0, wird es als Ende:=Ende+Länge.
  • Ist Ende < StartAb (übergebener oder berechneter Wert), führt die Funktion nichts aus. 

 C_COLLECTION($c;$nc)
 $c:=New collection(1;2;3;4;5)
 $nc:=$c.slice(0;3) //$nc=[1,2,3]
 $nc:=$c.slice(3) //$nc=[4,5]
 $nc:=$c.slice(1;-1) //$nc=[2,3,4]
 $nc:=$c.slice(-3;-2) //$nc=[3]



Siehe auch 

collection.extract( )

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Collections
Nummer: 805250

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v16 R6

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)
4D Programmiersprache ( 4D v19.4)
4D Programmiersprache ( 4D v19.5)
4D Programmiersprache ( 4D v19.6)
4D Programmiersprache ( 4D v19.7)
4D Programmiersprache ( 4D v19.8)