entitySelection.first( )

4D v19.8


entitySelection.first () -> Resultado

Parâmetro	Tipo	Descrição
Resultado	Entity, Null	Faz referência à primeira entidade da seleção de entidades

Descrição

O método entitySelection.first( ) devolve uma referência à entidade na primeira posição da seleção de entidade.

O resultado deste método é similar a:

$entity:=$entitySel[0]

Entretanto há uma diferença entre ambas declarações quando a seleção estiver vazia:

 C_OBJECT($entitySel;$entity)

 $entitySel:=ds.Emp.query("lastName = :1";"Nonexistentname") //não há entidade coincidente

  //a seleção de entidade está vazia

 $entity:=$entitySel.first() //devolve Null

 $entity:=$entitySel[0]  //gera um erro

Exemplo

 C_OBJECT($entitySelection;$entity)

 $entitySelection:=ds.Emp.query("salary > :1";100000)

 If($entitySelection.length#0)

    $entity:=$entitySelection.first()

 End if

Ver também

entity.first( )
entitySelection.last( )
entitySelection[index]