entitySelection.minus( )

4D v19.8


entitySelection.minus ( entity \| entitySelection ) -> Résultat

Paramètre	Type	Description
entity \| entitySelection	Entity, EntitySelection	Entité ou sélection d'entités à soustraire
Résultat	EntitySelection	Nouvelle sélection d'entités ou une nouvelle référence sur la sélection d'entités existante

Description

La méthode entitySelection.minus( ) exclut à partir de la sélection d'entités à laquelle elle est appliqué l'entity ou les entités de entitySelection et renvoie la sélection d'entités résultante.

Si vous passez entity en paramètre, la méthode crée une nouvelle sélection d'entités sans entity (si entity appartient à la sélection d'entités). Si entity n'était pas inclut dans la sélection d'entités d'origine, une nouvelle référence à la sélection d'entités est renvoyée.
Si vous passez entitySelection en paramètre, la méthode retourne une sélection d'entités contenant les entités appartenant à la sélection d'entités d'origine, sans les entités appartenant à entitySelection.

Note : Vous pouvez comparer des sélections d'entités ordonnées et non ordonnées. La sélection d'entités résultante est toujours non-ordonnée. Pour plus d'information, veuillez vous reporter au paragraphe Sélections d'entités triées vs Sélections d'entités non-triées dans le Guide du développeur 4D.

Si la sélection d'entités initiale ou la sélection d'entités d'origine et celle du paramètre entitySelection sont vides, une sélection d'entités vide est retournée.
Si entitySelection est vide ou si entity est Null, une nouvelle référence à la sélection d'entité d'origine est renvoyée.

Si la sélection d'entités d'origine et le paramètre ne sont pas reliés à la même dataClass, une erreur est retournée.

Exemple 1

 C_OBJET($employees;$employee;$result)

 

 $employees:=ds.Employee.query("lastName = :1";"H@") // la sélection d'entités $employees contient l'entité avec la clé primaire 710 ainsi que d'autres entités.

  // Par exemple : "Colin Hetrick", "Grady Harness", "Sherlock Holmes" (clé primaire 710)

 

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

 

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

Exemple 2

Vous voulez avoir une sélection d'employées "femme", nommées "Jones" qui vivent à New York :

 C_OBJET($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'"))

Voir aussi

DIFFERENCE
entitySelection.add( )