TOTVSTEC

Árvore de páginas

Obtêm informações sobre a tabela corrente.

Sintaxe

DBInfo( < nInfo > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nInfo

numérico

Indica o tipo de informação que será verificada. Para mais informações, consulte a área Observações.

X

 

Retorno

Nome

Tipo

Descrição

xInfo

qualquer

Retorna a informação da tabela, ou seja, a informação requisitada pelo usuário (O tipo depende da informação requisitada). Caso não tenha tabela corrente, o retorno será nulo.

Observações

O tipo de informação, do parâmetro <nInfo>, é escolhido de acordo com as seguintes constantes:

Constante

Descrição

DBI_TableExt

Indica a extensão do arquivo da tabela corrente. Tipo: Caracter.

DBI_FullPath

Indica o nome da tabela corrente com o caminho completo. Tipo: Caracter.

DBI_Alias

Indica o nome do Alias da área de trabalho corrente. Similar a função Alias(). Tipo: Caracter.

DBI_FCount

Indica o número de campos na estrutura da tabela corrente. Similar a função FCount(). Tipo: Numérico.

DBI_GetRecSize

Indica o tamanho do registro em número de bytes. Similar a função RecSize(). Tipo: Númerico.

DBI_GetLockArray

Retorna um array de registros bloqueados, da mesma forma que a função DBRLockList().

DBI_DBFilter

Retorna uma string contendo a expressão de filtro em uso, da mesma forma que a função DBFilter(). Tipo: Caracter.

DBI_CANPUTREC

Retorna, falso (.F.), se a tabela for aberta com Read Only, ou seja, uma query (onde não é possível inserir registros); caso contrário, verdadeiro (.T.). Tipo: Lógico.

DBI_ISDBF

Retorna, falso (.F.), se o alias atual foi aberto a partir de uma query. Para as demais, retorna verdadeiro (.T.). Tipo: Lógico.

DBI_Shared

Retorna, verdadeiro (.T.), se a tabela atual está aberta em modo de compartilhado; caso contrário, falso (.F.). Tipo: Lógico.

DBI_ISFLock

Retorna, verdadeiro (.T.), se o arquivo atual está bloqueado para atualizações utilizando a função FLock(); caso contrário, falso (.F.). Tipo: Lógico.

DBI_LastUpdate

Verifica a data da última alteração. Similar a função LUpdate(). Tipo: Data.

DBI_Found

Verifica se a tabela está posicionada após uma pesquisa. Similar a função Found(). Tipo: Lógico.

DBI_EOF

Verifica se está posicionada no final da tabela. Similar a função EOF(). Tipo: Lógico.

DBI_BOF

Verifica se está posicionada no início da tabela. Similar a função BOF(). Tipo: Lógico.

Exemplos

USER FUNCTION TEST()
  TCLink()
  
  DBCreate("T1", {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE", "C", 10, 0}}, "TOPCONN")

  
  DBUseArea(.F., 'TOPCONN', cT1, (cT1), .F., .F.)

  conout(DBInfo(33 /*DBI_Alias*/))
  
  DBCloseArea()
  TCUnlink()
RETURN

Veja também

  • Sem rótulos