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}}