Record number

Record number {( tabela )} : Integer

Parâmetro	Tipo		Descrição
tabela	Table	→	Tabela para qual devolver o número do registro atual, ou tabela padrão, se omitido
Resultado de função	Integer	←	Nº de registro atual

Descrição

Record number devolve o número do registro atual de tabela. Se não há registro atual, como quando o ponteiro do registro está antes ou depois da seleção atual, Record number devolve –1. Se o registro é um novo registro que não foi guardado, Record number devolve –3.

Os números de registro podem variar. Os números de registros apagados são reutilizados.

4D Server: este comando devolve um resultado diferente no contexto do evento de formulário On Validate dependendo se for executado em 4D em modo local ou 4D em modo remoto. Em versão monoposto, o comando devolve um número de registro (o registro é considerado como tendo sido criado). Em versão cliente/servidor, o comando devolve -3 porque nesse caso, o registro já foi criado no servidor mas a informação não foi enviada ao cliente.

Nota: É recomendado utilizar o comando Is new record para verificar se o registro está em processo de criação.

Exemplo

O exemplo a seguir salva o número do registro atual e depois procura na tabela se outro registro tiver o mesmo valor:

 $NumReg:=Record number([Pessoas]) // Obter o número do registro
 QUERY([Pessoas];[Pessoas]Sobrenome=[Pessoas]Sobrenome) // Alguém mais com o mesmo sobrenome?
  // Mostrar um alerta com o nome das pessoas que tenham o mesmo sobrenome
 ALERT("Há "+String(Records in selection([Pessoas])+" com esse sobrenome.")
 GOTO RECORD([Pessoas];$NumReg) // Regressar ao registro original

Ver também

GOTO RECORD
Is new record
Selected record number
Sequence number
Sobre Números de Registros

Propriedades

Número do comando	243
Thread-seguro	✓