cAliasCharacterOptional
Table alias.
FUNCTIONUnder review
NextNumero
NextNumero([cAlias],[nOrdem],[cNomeCpo],[lSomar],[cVar]) -> cNumeroObtains a candidate next sequential number.
Overview
The historical P8.11/P10 reference describes alias, index order, field, lSomar and cVar. True lSomar returns the next number; false returns cVar if absent or calculates the next if already present. An empty table yields 1 padded to field width. This contract does not document atomic reservation across users. The community sample queries SC7; this adaptation prepares a block without reading tables or creating orders. (Sources: refs. 1–2.)
Syntax
NextNumero([cAlias],[nOrdem],[cNomeCpo],[lSomar],[cVar]) -> cNumeroParameters
nOrdemNumericOptional
Index order matching the key.
cNomeCpoCharacterOptional
Sequential field.
lSomarLogicalOptional
True calculates next; false checks cVar.
cVarCharacterOptional
Candidate value when lSomar is false.
Return value
Character number padded on the left according to the field.
Commented example
#Include "Protheus.ch"
User Function Ed558()
// Prepare only; verify index and field in staging.
Local bNext := {|cAlias,nOrder,cField| NextNumero(cAlias,nOrder,cField,.T.)}
ConOut(ValType(bNext))
Return NilExpected result
Prints B. The block is not evaluated and reserves no number. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
- Define a documented reservation, confirmation, cancellation and concurrency strategy for the actual routine. Candidate lookup is not a uniqueness guarantee; preserve work area and check results.
- Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
Comments
There are no approved comments yet.
Sign in with Google or Microsoft to comment.