entitySelection.minus( )

4D v19.8


entitySelection.minus ( entidade\|seleçãoEntidade ) -> Resultado

Parâmetro	Tipo	Descrição
entidade\|seleçãoEntidade	Entity, EntitySelection	Entidade ou seleção de entidade a subtrair
Resultado	EntitySelection	Nova seleção de entidade ou uma nova referência na seleção de entidade existente

Descrição

O método entitySelection.minus( ) exclui da seleção de entidade à qual se aplica à entidade ou às entidades de seleçãoEntidade e retorna a seleção de entidade resultante.

Se passar entidade como parâmetro, o método cria uma nova seleção de entidad sem entidade (se entidade pertencer à seleção de entidade). Se entidade não for incluída na seleção da entidade original,uma nova referência à seleção da entidade é retornada.
Se passar seleçãoEntidade como parâmetro, o método retorna uma seleção de entidade que contém as entidades que pertencem à seleção de entidade original da qual foram eliminadas as entidades que pertencem a seleçãoEntidade.

Nota: é possível comparar seleções de entidades ordenadas ou não ordenadas. A seleção resultante sempre está desordenada. Para saber mais, consulte o parágrafo Entity selections Ordenadas vs não ordenadas em Guia do desenvolvedor 4D.

Se a seleção de entidade original ou tanto a seleção de entidade original quanto o parâmetro seleçãoEntidade estiverem vazios, se retorna uma seleção de entidade vazia.
Se seleçãoEntidade estiver vazia ou se entidade for Null, se retorna uma nova referência à seleção da entidade original.

Se a seleção de entidade original e o parâmetro não estiverem relacionados com a mesma classe de dados, um erro é gerado.

Exemplo 1

 C_OBJECT($employees;$employee;$result)

 

 $employees:=ds.Employee.query("lastName = :1";"H@") // A seleção de entidades $employees contém a entidade com a chave primária 710 e outras entidades

  // por ex. "Colin Hetrick", "Grady Harness", "Sherlock Holmes" (chave primária 710)

 

 $employee:=ds.Employee.get(710) // Retorna "Sherlock Holmes"

 

 $result:=$employees.minus($employee) //$result contém "Colin Hetrick", "Grady Harness"

Exemplo 2

Queremos ter uma seleção de empregados chamados "Jones" que morem em Nova York:

 C_OBJECT($sel1;$sel2;$sel3)

 $sel1:=ds.Employee.query("name =:1";"Jones")

 $sel2:=ds.Employee.query("city=:1";"New York")

 $sel3:=$sel1.and($sel2).minus(ds.Employee.query("gender='male'"))

Ver também

DIFFERENCE
entitySelection.add( )