FACUM ()

• Propósito
• Sintaxe
• Argumentos
• Utilização

Propósito

Acumular somatório de itens numéricos.

Sintaxe

FACUM (<exp.C>, <vet.C>, <vet.N>)

Argumentos

<exp.C>	Representa o nome de um arquivo do banco de dados.
<vet.C>	Representa um vetor caractere com nome dos itens que serão acumulados.
<vet.N>	Representa um vetor numérico onde serão armazenados os resultados das totalizações.

Utilização

Esta função lê seqüencialmente o arquivo <exp.C> acumulando em <vet.N> os valores dos itens definidos em <vet.C>.

Os itens definidos em <vet.C> devem ser de tipo numérico (tipos N, P, S, C, B, I ou F).

Para cada elemento de do vetor <vet.C> corresponde um elemento do vetor <vet.N> com o resultado da acumulação do item correspondente.

Esta função quando bem sucedida retorna 0 (zero). Caso contrário retorna -1, neste caso verificar se algum dos itens passados em <vet.C> não numérico, a quantidade de elemento de <vet.N> corresponde a quantidade de elementos de <vet.C> ou se ocorreu erro durante o acesso ao banco de dados (ver se DBERR() # 0).