AFILL()
 Preenche um vetor com um valor especificado
------------------------------------------------------------------------------

 Sintaxe

     AFILL(<aDestino>, <ValorExp>,
        [<nInicio>], [<nCont>]) --> aDestino

 Argumentos

     <aDestino> é o vetor a ser preenchido.

     <ValorExp> é o valor a ser alocado em cada elemento de vetor.  Pode
     ser uma expressao de qualquer tipo de dados válido.

     <nInicio> é a posiçao do primeiro elemento a ser preenchido.  Caso
     este argumento seja omitido, o valor padrao é um.

     <nCont> é a quantidade de elementos a serem preenchidos iniciando
     com o elemento <nInicio>.  Se este argumento for omitido, os elementos
     sao preenchidos a partir da posiçao do elemento inicial até o final do
     vetor.

 Retorno

     AFILL() retorna uma referência ao <aDestino>.

 Descriçao

     AFILL() é uma funçao de vetor que preenche um vetor especificado com um
     único valor de qualquer tipo de dados (inclusive vetores, blocos de
     código ou NIL) atribuindo <ValorExp> a cada elemento de vetor na faixa
     especificada.

     -----------------------------------------------------------------------
     . Aviso

     AFILL() nao pode ser utilizado para preencher vetores
     multi-dimensionais.  Este tipo de vetores em Clipper sao implementados
     aninhando-se vetores dentro de outros vetores.  A utilizaçao de AFILL()
     com vetores multi-dimensionais sobre-escreverá vetores para as outras
     dimensoes do vetor.
     -----------------------------------------------------------------------

 Exemplos

     Neste exemplo, é criado um vetor com três elementos.  O vetor é depois
     preenchido com falso (.F.).  Ao final, aos elementos nas posiçoes dois
     e três é atribuido o novo valos de verdadeiro (.T.):

     LOCAL aLogic[3]                // Resulta: aLogic e { NIL, NIL, NIL }
     AFILL(aLogic, .F.)             // Resulta: aLogic e { .F., .F., .F. }
     AFILL(aLogic, .T., 2, 2)       // Resulta: aLogic e { .F., .T., .T. }

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

See Also: AADD() AEVAL() DBSTRUCT() DIRECTORY()