4D v19
collection.extract( )
- Manual de lenguaje 4D
-
- Colecciones
-
- Presentación de las colecciones
- Conversiones de tipo entre las colecciones y los arrays 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 v19
collection.extract( )
collection.extract( )
La función collection.extract( ) crea y devuelve una nueva colección que contiene los valores rutaProp extraídos de la colección original de objetos.
Nota: este comando no modifica la colección original.
El contenido de la colección devuelta depende del parámetro rutaObj:
- Si se omite el parámetro rutaObj, collection.extract( ) llena la nueva colección con los valores de rutaProp de la colección original.
De forma predeterminada, los elementos para los que rutaProp es null o indefinido se ignoran en la colección resultante. Puede pasar la constante ck keep null en el parámetro opcion para incluir estos valores como elementos null en la colección devuelta.
- Si se pasan uno o más parámetros rutaObj, collection.extract( ) llena la nueva colección con las propiedades rutaProp y cada elemento de la nueva colección es un objeto con las propiedades rutaObj llenas con las propiedades rutaProp. Los valores nulos se mantienen (el parámetro opcion se ignora con esta sintaxis).
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}]
Ver también
PROPIEDADES
Producto: 4D
Tema: Colecciones
CONTENIDO DE LA PÁGINA
HISTORIA
ARTICLE USAGE
Manual de lenguaje 4D ( 4D v19)
Manual de lenguaje 4D ( 4D v19.1)
© 4D SAS 1985 - 2021. Todos los derechos reservados.