Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com
- 4D - Langage
-
- Collections
-
-
Présentation des collections
-
Conversions de type entre les collections et les tableaux 4D
-
collection.length
-
collection.average( )
-
collection.clear( )
-
collection.combine( )
-
collection.concat( )
-
collection.copy( )
-
collection.count( )
-
collection.countValues( )
-
collection.distinct( )
-
collection.equal( )
-
collection.every( )
-
collection.extract( )
-
collection.fill( )
-
collection.filter( )
-
collection.find( )
-
collection.findIndex( )
-
collection.indexOf( )
-
collection.indices( )
-
collection.insert( )
-
collection.join( )
-
collection.lastIndexOf( )
-
collection.map( )
-
collection.max( )
-
collection.min( )
-
collection.orderBy( )
-
collection.orderByMethod( )
-
collection.pop( )
-
collection.push( )
-
collection.query( )
-
collection.reduce( )
-
collection.remove( )
-
collection.resize( )
-
collection.reverse( )
-
collection.shift( )
-
collection.slice( )
-
collection.some( )
-
collection.sort( )
-
collection.sum( )
-
collection.unshift( )
-
COLLECTION VERS TABLEAU
-
Creer collection
-
Creer collection partagee
-
TABLEAU VERS COLLECTION
-
collection.extract( )
| collection.extract ( cheminPropriété {; cheminCible}{; cheminPropriété2 ; cheminCible2 ; ... ; cheminPropriétéN ; cheminCibleN}{; option}) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| cheminPropriété | Texte |
|
Chemin de propriété d'objet dont les valeurs doivent être extraites dans la nouvelle collection | |||||
| cheminCible | Texte |
|
Chemin ou nom de propriété cible | |||||
| option | Entier long |
|
ck keep null : inclure les propriétés null dans la collection retournée (ignorées par défaut). Paramètre ignoré si cheminCible passé | |||||
| Résultat | Collection |
|
Nouvelle collection contenant les valeurs extraites | |||||
La méthode collection.extract( ) crée et retourne une nouvelle collection contenant les valeurs de cheminPropriété extraites depuis la collection d'objets d'origine.
Note : Cette méthode ne modifie pas la collection d'origine.
Le contenu de la collection retournée dépend du paramètre cheminCible :
- Si le paramètre cheminCible est omis, collection.extract( ) remplit la nouvelle collection avec les valeurs de cheminPropriété de la collection d'origine.
Par défaut, les éléments pour lesquels cheminPropriété est null ou undefined sont ignorés dans la collection résultante. Vous pouvez passer la constante ck keep null dans le paramètre option pour inclure ces valeurs tant qu'éléments null dans la collection résultante.
- Si un ou plusieurs paramètre(s) cheminCible sont passés, collection.extract( ) remplit la nouvelle collection avec les propriétés cheminPropriété et chaque élément de la nouvelle collection est un objet contenant les propriétés cheminCible dont les valeurs sont celles des propriétés cheminPropriété correspondantes. Les valeurs null sont conservées (le paramètre option est ignoré avec cette syntaxe).
C_COLLECTION($c)
$c:=Creer collection
$c.push(Creer objet("name";"Cleveland"))
$c.push(Creer objet("zip";5321))
$c.push(Creer objet("name";"Blountsville"))
$c.push(42)
$c2:=$c.extract("name") // $c2=[Cleveland,Blountsville]
$c2:=$c.extract("name";ck keep null) //$c2=[Cleveland,null,Blountsville,null] C_COLLECTION($c)
$c:=Creer collection
$c.push(Creer objet("zc";35060))
$c.push(Creer objet("name";Null;"zc";35049))
$c.push(Creer objet("name";"Cleveland";"zc";35049))
$c.push(Creer objet("name";"Blountsville";"zc";35031))
$c.push(Creer objet("name";"Adger";"zc";35006))
$c.push(Creer objet("name";"Clanton";"zc";35046))
$c.push(Creer objet("name";"Clanton";"zc";35045))
$c2:=$c.extract("name";"City") //$c2=[{City:null},{City:Cleveland},{City:Blountsville},{City:Adger},{City:Clanton},{City:Clanton}]
$c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:35049},{City:Cleveland,Zip:35049},{City:Blountsville,Zip:35031},{City:Adger,Zip:35006},{City:Clanton,Zip:35046},{City:Clanton,Zip:35045}]
Produit : 4D
Thème : Collections
Numéro :
805251
Nom intl. : collection.extract( )
Créé : 4D v16 R6
4D - Langage ( 4D v19)
4D - Langage ( 4D v19.1)
4D - Langage ( 4D v19.4)
4D - Langage ( 4D v19.5)
4D - Langage ( 4D v19.6)
4D - Langage ( 4D v19.7)
4D - Langage ( 4D v19.8)
