collection.extract( )

4D v19.8


collection.extract ( rotaProp {; rotaObj}{; rotaProp2 ; rotaObj2 ; ... ; rotaPropN ; rotaObjN}{; opção}) -> Resultado

Parâmetro	Tipo	Descrição
rotaProp	Texto	Rota de propriedade Objeto cujos valores devem ser extraídos para a nova coleção
rotaObj	Texto	Rota propriedade alvo ou nome propriedade
opção	Inteiro longo	ck keep null: inclui propriedades null na coleção retornada (ignoradas como padrão). Parâmetro ignorado se rotaObj for passado
Resultado	Collection	Nova coleção que contém os valores extraídos

Descrição

A função collection.extract( ) cria e devolve uma nova coleção que contiver os valores rotaProp extraídos da coleção original de objetos.

Nota: este comando não modifica a coleção original.

O conteúdo da coleção devolvida depende do parâmetro rotaObj:

Se for omitido o parâmetro rotaObj, collection.extract( ) preenche a nova coleção com os valores de rotaProp da coleção original.
De forma pré-determinada, os elementos para os quais rotaProp é null ou indefinido são ignorados na coleção resultante. Pode passar a constante ck keep null no parâmetro opção para incluir estes valores como elementos null na coleção devolvida.

Se passar um ou mais parâmetros rotaObj, collection.extract( ) preenche a nova coleção com as propriedades rotaProp e cada elemento da nova coleção é um objeto com as propriedades rotaObj preenchidas com as propriedades rotaProp. Os valores nulos são mantidos (o parâmetro opção são ignorados com esta sintaxe).

Exemplo 1

 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]

Exemplo 2

 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 também

collection.map( )
entitySelection.extract( )