DIFFERENCE

4D v19

DIFFERENCE


DIFFERENCE ( conjunto1 ; conjunto2 ; conjuntoResultado )

Parâmetro	Tipo	Descrição
conjunto1	String	Conjunto
conjunto2	String	Conjunto que será subtraído
conjuntoResultado	String	Conjunto Resultado

Descrição

DIFFERENCE compara conjunto1 e conjunto2 e exclui de conjuntoResultado todos os registros de conjunto2. Em outras palavras, um registro é incluído em conjuntoResultado apenas se estiver em conjunto1, mas não em conjunto2. A seguinte tabela mostra todos os resultados possíveis de uma operação de diferença de conjuntos.

Conjunto1	Conjunto2	Conjunto Resultado
Sim	Não	Sim
Sim	Sim	Não
Não	Sim	Não
Não	Não	Não

O gráfico representa uma operação de diferença entre dois conjuntos. O área sombreada é o conjunto resultante.

O conjuntoResultado é criado por DIFFERENCE O conjuntoResultado substitui qualquer conjunto existente que tenha o mesmo nome, incluindo conjunto1 e conjunto2. Os conjuntos conjunto1 e conjunto2 devem ser da mesma tabela. O conjunto resultado pertence a mesma tabela que conjunto1 e conjunto2.

4D Server: em modo cliente/Servidor, conjuntos são "visíveis" dependendo do tipo (interprocesso, processo e local) e onde eles foram criados (servidor ou cliente). DIFFERENCE exige que todos os três conjuntos sejam visíveis na mesma máquina. Veja o parágrafo 4D Server, conjuntos e seleções temporais no Manual de Referência 4D Server para mais informação.

Exemplo

Este exemplo exclui os registros selecionados pelo usuário. Os registros se mostran na tela com la seguinte instrução:

DISPLAY SELECTION([Clientes]) ` Visualização dos clientes em uma lista

Ao final da lista de registros há um botão com um método de objeto. O método de objeto exclui os registros selecionados pelo usuário (o conjunto sistema chamado “UserSet”), e mostra uma seleção reduzida:

 CREATE SET([Clientes];"$Atual") ` Criação de um conjunto a partir da seleção atual DIFFERENCE ("$Atual";"UserSet";"$Atual") ` Exclusão dos registros selecionados

 &NBSP;USE SET("$Atual") ` Utilização do novo conjunto

 &NBSP;CLEAR SET("$Atual") ` Apagar o conjunto

Ver também

entitySelection.minus( )
INTERSECTION
UNION