Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

DBEval

DBEval( <bBlock>, [bFirstCondition], [bSecondCondition], [nCount], [nRecno], [lRest] ) --> Nil

Evalúa bloque para registros del ámbito elegido.

DBEvalAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

DBEval ejecuta bloque según condiciones/límites. Devuelve Nil, no lista de resultados. Ejemplo cuenta hasta tres registros de prueba sin escribir campos. Llamador define ámbito y orden/filtro; no ocultar actualización masiva en callback presentado como lectura. EDTRB identifica exclusivamente tabla propia de prueba abierta con estructura y permisos necesarios; ejemplos no se destinan a tablas estándar. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

DBEval( <bBlock>, [bFirstCondition], [bSecondCondition], [nCount], [nRecno], [lRest] ) --> Nil

Parámetros

bBlock
Bloque de códigoObligatorio

Bloque por registro.

bFirstCondition
Bloque de códigoOpcional

Primera condición de ámbito.

bSecondCondition
Bloque de códigoOpcional

Segunda condición de ámbito.

nCount
NuméricoOpcional

Límite de registros.

nRecno
NuméricoOpcional

Registro específico del ámbito.

lRest
LógicoOpcional

Opción de procesar registros restantes.

Retorno

Nil; no es indicador lógico de éxito.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed331()
    Local nCuenta := 0
    // Solo tabla propia sin cambios pendientes.
    If Select("EDTRB") > 0
        EDTRB->(DBGoTop())
        EDTRB->(DBEval({|| nCuenta++},,,3))
        ConOut(cValToChar(nCuenta))
    EndIf
Return Nil
Resultado esperado

Cuenta esperada de 0 a 3 según datos/filtro; cambia posición del alias. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Comprobar RDD, alias y operaciones pendientes. Navegación puede guardar cambios; preservar contexto según contrato y tratar errores en rutina completa.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. DBEval. TDN. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha