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

NextNumero

NextNumero([cAlias],[nOrdem],[cNomeCpo],[lSomar],[cVar]) -> cNumero

Obtiene candidato al siguiente número secuencial.

NextNumeroAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

Referencia histórica P8.11/P10 describe alias, índice, campo, lSomar/cVar. lSomar verdadero devuelve siguiente número; falso devuelve cVar si no existe o calcula siguiente si existe. Tabla vacía retorna 1 con ceros según ancho. Contrato no documenta reserva atómica entre usuarios. Ejemplo comunitario consulta SC7; adaptación prepara bloque sin leer tablas ni crear pedidos. (Fuentes: refs. 1–2.)

02 · SINTAXIS

Sintaxis

NextNumero([cAlias],[nOrdem],[cNomeCpo],[lSomar],[cVar]) -> cNumero

Parámetros

cAlias
CarácterOpcional

Alias de tabla.

nOrdem
NuméricoOpcional

Índice compatible con clave.

cNomeCpo
CarácterOpcional

Campo secuencial.

lSomar
LógicoOpcional

Verdadero calcula siguiente; falso verifica cVar.

cVar
CarácterOpcional

Valor candidato si lSomar falso.

Retorno

Número carácter rellenado a izquierda según campo.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed558()
    // Solo preparar; comprobar índice y campo en pruebas.
    Local bSiguiente := {|cAlias,nOrden,cCampo| NextNumero(cAlias,nOrden,cCampo,.T.)}
    ConOut(ValType(bSiguiente))
Return Nil
Resultado esperado

Imprime B. Bloque no evaluado no reserva número. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Definir reserva, confirmación, cancelación y concurrencia documentadas. Consulta de candidato no garantiza unicidad; conservar área y comprobar resultado.
  • 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. NextNumero. TDN; documentação histórica. Consulta el 2026-10-27.
  2. Atilio. Exemplo 367; commit 7d275a7. Consulta el 2026-10-27.
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