COPY STRUCTURE EXTENDED
 Copia as definiçoes de campo para um arquivo (.dbf)
------------------------------------------------------------------------------

 Sintaxe

     COPY STRUCTURE EXTENDED
        TO <xcArquivoEstrutura>

 Argumentos

     <xcArquivoEstrutura> é o nome do arquivo de estrutura.  Este
     argumento pode ser especificado literalmente ou como uma expressao
     caractere entre parênteses.

 Descriçao

     COPY STRUCTURE EXTENDED cria um arquivo cujo conteúdo é a estrutura do
     arquivo corrente com cada registro sendo a definiçao de cada campo.  O
     arquivo de estrutura consiste em:

     Tabela 4-5: Formato de um Arquivo de Estruturas
     ------------------------------------------------------------------------
     Campo    Nome           Tipo           Tamanho     Decimais
     ------------------------------------------------------------------------
     1        Field_name     Caractere      10
     2        Field_type     Caractere      1
     3        Field_len      Numérico       3           0
     4        Field_dec      Numérico       4           0
     ------------------------------------------------------------------------

     Usado em programas aplicativos, COPY STRUCTURE EXTENDED permite-lhe
     criar ou modificar a estrutura de um arquivo por meio de programaçao.
     Para criar um arquivo a partir do arquivo de estruturas use CREATE
     FROM.  Se você necessitar um arquivo de estruturas vazio, use CREATE.

 Notas

       Campos caractere com tamanhos maiores que 255: Em
        Clipper, o tamanho máximo para um campo caractere é 64K.  Por razoes
        de compatilidade, tamanhos de campo maiores que 255 sao
        representados como uma combinaçao do número de decimais e tamanho do
        campo.  Após um COPY STRUCTURE EXTENDED, você pode usar a fórmula
        abaixo para determinar o tamanho de um campo caractere:

        length = IF(Field_type = "C" .AND. Field_dec != 0,;
           (Field_dec * 256) + Field_len, Field_len)

 Exemplos

     Este exemplo cria Struc.dbf a partir de Sales.dbf como arquivo de
     estruturas e entao lista o conteúdo de Struc.dbf para ilustrar o layout
     típico das definiçoes de campo:

     USE Sales
     COPY STRUCTURE EXTENDED TO Struc
     USE Struc
     LIST Field_name, Field_type, Field_len, Field_dec

     Resulta:

     1   BRANCH    C     3      0
     2   SALESMAN  C     4      0
     3   CUSTOMER  C     4      0
     4   PRODUCT   C     25     0
     5   AMOUNT    N     8      2
     6   NOTAS     C     0      125  // Tamanho de campo de 32,000 caracteres

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: COPY STRUCTURE CREATE CREATE FROM FIELD() TYPE()