Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 3 Atual »

Função: DBStruct

Retorna um array contendo a estrutura da tabela aberta sob a Alias atual.

DBStruct ( ) --> aStructure

    aStructure(vetor)
  • Retorna um array com a estrutura dos campos. Cada elemento é um subarray contendo nome, tipo, tamanho e decimais.
  • Essa função é utilizada para recuperar a estrutura da tabela corrente. Esse mesmo array, é usado para criar a tabela, por exemplo através da função DBCreate().
  • É retornado um array bidimensional onde cada linha corresponde a um campo da estrutura e cada coluna a seguinte informação:
     

Posição Tipo Tamanho Descrição

[1] 

'C'  Caractere

10 Bytes 

Contém o nome do campo da tabela.

[2] 

'C'  Caractere

1 Byte 

Contém o tipo do campo da tabela. Pode ser: [C] Caractere, [N] Numérico, [L] Lógico ou [M] Memo.

[3] 

'N'  Numérico

Contém o tamanho do campo.

[4] 

'N' Numérico

Contém a quantidade de casas decimais que o campo pode armazenar, desde que o campo seja do tipo 'N' Numérico. Para os demais tipos, esta informação retorna sempre com '0' zero.

 

Importante

A informação retornada na terceira coluna do array, correspondendo ao tamanho do campo, está condicionada ao tipo do campo.

coluna/tipo descrição

'C' Caractere 

O tamanho retornado corresponde ao tamanho de string máxima que pode ser armazenado na coluna. 

'D'      Data 

É retornado sempre 8 bytes

'L'    Lógica 

É retornado sempre 1 byte

 'M'    Memo

É retornado sempre 10 bytes. Observação: É importante lembrar que, este valor é retornado por compatibilidade e não corresponde a capacidade real de armazenamento da coluna. O tamanho máximo de armazenamento de uma coluna, do tipo 'M', está condicionada ao driver RDD utilizado. 

'N' Numérico 

Juntamente com o valor retornado na quarta posição, quantidade de decimais, informa a capacidade de armazenamento de valores numéricos no campo. 

//Este exemplo, apresenta como utilizar a função DBStruct para recuperar a estrutura da//tabela corrente.USE Cliente NEWDBStruct()//Retorna:{{Cod,N,3,0},{Nome,C,10,0},{Idade,N,3,0},{Nasc,D,8,0},{Pagto,N,7,2}}
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

  • Sem rótulos