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.
C_OBJET($employees;$employee;$result)
$employees:=ds.Employee.query("lastName = :1";"H@")
$employee:=ds.Employee.get(710)
$result:=$employees.minus($employee)
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'"))