Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
portuguese
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css

Pagetitle

...

DBStruct

...

...

...

DBStruct

Retorna

...

um

...

array

...

contendo

...

a

...

estrutura

...

da

...

tabela

...

aberta

...

sob

...

a

...

Alias

...

atual.

Sintaxe

Bloco de código
collapsefalse
DBStruct()
--> aStructure

Retorno

...

Nome

Tipo

Descrição

aRet

vetor

Retorna um array com a estrutura dos campos. Cada elemento é um subarray contendo nome, tipo, tamanho e decimais.

Observações

  • 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

...

  • 10

...

  • bytes

    Contém o nome do campo da tabela.

...

  • 2

...

...

  • C

...

  • 1

...

  • byte

    Contém o tipo do campo da tabela. Pode ser:

...

  • "C

...

  • " (Caractere),

...

  • "N

...

  • " (Numérico),

...

  • "L

...

[3] 

...

'N'  Numérico

  • " (Lógico), "D" (Data) ou "M" (Memo).

    3

    N

    -

...

  • Contém o tamanho do campo.

...

  • 4

...

...

  • N

...

  • -

...

  • Contém a quantidade de casas decimais que o campo pode armazenar, desde que o campo seja do tipo

...

  • "N

...

  • ". Para os demais tipos, esta informação retorna sempre com

...

  • 0

...

  • (zero).

...

 

...

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

...

  • Tipo

...

  • Descrição

...

  • C

...

  • O tamanho retornado corresponde ao

...

  • tamanho de string máxima que pode ser armazenado na coluna.

...

...

  • D

...

  • É retornado sempre 8 bytes.

...

...

  • L

...

  • É retornado sempre 1 byte.

...

...

  • M

...

  • É 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

...

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

...

Exemplos

//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
Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
user function test()
  Local nHandle := TCLink( "MSSQL/DSN1", "127.0.0.1", 7890 )
  Local cTable := "SA1990"
  Local cRDD := "TOPCONN"
  
  DBUseArea( .T., cRDD, cTable, (cTable), .F., .T. )
  
  // Exibe a estrutura da tabela apontada em cTable
  varinfo( "struct", DBStruct() )
  
  DBCloseArea()
  
  TCUnlink( nHandle )
return

Veja também