TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Adriana Panseri Santos

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Danilo Coimbra Sigolo

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Pagetitle
Eof
Eof

Informa se está no fim do Arquivo/Tabela.

Sintaxe

Bloco de código
collapsefalse
Eof()

Retorno

Nome

Tipo

Descrição

lRet

lógico

Retorna .T. (Verdadeiro) se estiver no fim do arquivo/tabela; Caso contrário, .F. (Falso)

Observações

  • O uso da DBGoBottom não ativa a flag de EOF. Para isto, após sua chamada, é necessário o uso da DBSkip.
  • Após abertura de uma tabela, caso nenhum registro tenha sido inserido, a flag de EOF sempre será True (.T.).

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
static function CreateTable()
  TCDelFile('T1')
  
  DBCreate('T1', {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE"   , "C", 10, 0}}, 'TOPCONN')
RETURN

user function test()
  Local cT1 := "T1"
  
  TCLink()
  
  CreateTable()

  DBUseArea(.F., 'TOPCONN', cT1, (cT1), .F., .F.)
  
  (cT1)->( DBAppend( .F. ) )
  (cT1)->FIELD_NAME := "name"
  (cT1)->FIELD_TYPE := "string"
  (cT1)->( DBCommit() )
  
  (cT1)->( DBAppend( .F. ) )
  (cT1)->FIELD_NAME := "name2"
  (cT1)->FIELD_TYPE := "string"
  (cT1)->( DBCommit() )
  
  (cT1)->( DBAppend( .F. ) )
  (cT1)->FIELD_NAME := "name3"
  (cT1)->FIELD_TYPE := "string"
  (cT1)->( DBCommit() )
  
  DBGoBottom()
  DBSkip()
  
  if Eof() == .T.
    conout("Fim da Tabela/Arquivo")
  endif
 
  DBCloseArea()
  
  TCUnlink()
return

Veja também

Composition Setup
import.css=/download/attachments/327912/newLayout.css

...

Função: BOF/EOF

Determina se o ponteiro de leitura do arquivo encontra-se no começo ou no final do mesmo.
BOF - Testa uma condição de limite inicial do arquivo quando o ponteiro de registros está se movendo para trás em um arquivo de banco de dados.
EOF - Testa uma condição de limite final de arquivo quando o ponteiro de registro está se movendo para frente em um arquivo de banco de dados.

Sintaxe

BOF/EOF ( ) --> lRet

Retorno
    lRet(logico)
  • Veja a descrição na área Observações.
Observações

Normalmente é utilizada a condição EOF() como parte do parâmetro <lCondicao> de uma construção Do While, que processa registros, sequencialmente, em um arquivo de banco de dados. Neste caso <lCondicao> incluiria um teste para .NOT. EOF(), forçando o laço Do While a terminar quando EOF() retornar verdadeiro (.T.).

Retornos

  • Retorna verdadeiro (.T.), se realizar a tentativa de mover o ponteiro de registros para além do último registro lógico em um arquivo de banco de dados; caso contrário, falso (.F.).
  • Caso não haja nenhum arquivo de banco de dados aberto na área de trabalho corrente, EOF() retorna falso (.F.). Se o arquivo de banco de dados corrente não possui registros, EOF() retorna verdadeiro (.T.).
Abrangência

...