bBlockBloco de códigoObrigatório
Bloco por registro.
FUNçãOEm revisão
DBEval
DBEval( <bBlock>, [bFirstCondition], [bSecondCondition], [nCount], [nRecno], [lRest] ) --> NilAvalia um bloco para os registros do escopo escolhido.
Visão geral
DBEval executa o bloco para registros segundo condições e limites informados. Seu retorno é Nil, não uma lista de resultados. O exemplo conta no máximo três registros a partir de uma navegação de teste, sem escrever campos. Condições de escopo e estado de ordem/filtro devem ser definidos pelo chamador; não esconder uma atualização em massa num callback descrito como leitura. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)
Sintaxe
DBEval( <bBlock>, [bFirstCondition], [bSecondCondition], [nCount], [nRecno], [lRest] ) --> NilParâmetros
bFirstConditionBloco de códigoOpcional
Primeira condição de escopo.
bSecondConditionBloco de códigoOpcional
Segunda condição de escopo.
nCountNuméricoOpcional
Limite de registros.
nRecnoNuméricoOpcional
Registro específico no escopo.
lRestLógicoOpcional
Opção de processamento dos registros restantes.
Retorno
Nil; não é um indicador lógico de sucesso.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed331()
Local nContagem := 0
// Somente tabela propria, sem edicoes pendentes.
If Select("EDTRB") > 0
EDTRB->(DBGoTop())
EDTRB->(DBEval({|| nContagem++},,,3))
ConOut(cValToChar(nContagem))
EndIf
Return NilResultado esperado
Contagem esperada entre 0 e 3, conforme dados e filtro; a posição do alias é alterada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.