4D v17.4
collection.extract( )
- 4D - Langage
-
- Collections
-
- Présentation des collections
- Conversions de type entre les collections et les tableaux 4D
- collection.length
- collection.push( )
- collection.insert( )
- collection.countValues( )
- collection.remove( )
- collection.clear( )
- collection.sort( )
- collection.sum( )
- collection.average( )
- collection.pop( )
- collection.indexOf( )
- collection.find( )
- collection.filter( )
- collection.count( )
- collection.min( )
- collection.max( )
- collection.copy( )
- collection.query( )
- collection.shift( )
- collection.unshift( )
- collection.join( )
- collection.orderBy( )
- collection.orderByMethod( )
- collection.extract( )
- collection.indices( )
- collection.concat( )
- collection.combine( )
- collection.reverse( )
- collection.map( )
- collection.every( )
- collection.some( )
- collection.findIndex( )
- collection.lastIndexOf( )
- collection.resize( )
- collection.fill( )
- collection.slice( )
- collection.distinct( )
- collection.equal( )
- collection.reduce( )
- ARRAY TO COLLECTION
- COLLECTION TO ARRAY
- New collection
- New shared collection
4D v17.4
collection.extract( )
collection.extract( )
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:=New collection
$c.push(New object("name";"Cleveland"))
$c.push(New object("zip";5321))
$c.push(New object("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:=New collection
$c.push(New object("zc";35060))
$c.push(New object("name";Null;"zc";35049))
$c.push(New object("name";"Cleveland";"zc";35049))
$c.push(New object("name";"Blountsville";"zc";35031))
$c.push(New object("name";"Adger";"zc";35006))
$c.push(New object("name";"Clanton";"zc";35046))
$c.push(New object("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}]
Voir aussi
PROPRIÉTÉS
Produit : 4D
Thème : Collections
PAGE CONTENTS
HISTORIQUE
UTILISATION DE L'ARTICLE
4D - Langage ( 4D v17)
4D - Langage ( 4D v17.1)
4D - Langage ( 4D v17.2)
4D - Langage ( 4D v17.3)
4D - Langage ( 4D v17.4)
© 1985-2020 4D SAS / 4D, Inc. All rights reserved.