FGACUM ()

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

Propósito

Acumular somatório de itens numéricos de uma cadeia.

Sintaxe

FGACUM (<exp.C1>, <exp.C2>, <exp.C3>, <vet.C>, <vet.N>). 

Argumentos

<exp.C1>	Representa o nome de um arquivo do banco de dados.
<exp.C2>	Representa o nome de uma chave que determina a cadeia.
<exp.C3>	Representa o valor da cadeia.
<vet.C>	Representa um vetor cadeia com nome dos itens que serão acumulados.
<vet.N>	Representa um vetor numérico onde será armazenados os resultados das totalizações.

Utilização

Esta função lê os registros cujo valor da chave <exp.C2> for igual a expressão <exp.C2> 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).

Exemplo

database EXEMPLO 1 a 2

decl i[1]=space(20)

i[1]="IDADEF"

decl n[1]=0

r=FGACUM("FILHOS","NOMEP1","Jose",i,n)

? n[1] && soma das idades dos filhos de Jose