Acumular somatório de itens numéricos de uma cadeia de prefixo.
FGPACUM (<exp.C1>, <exp.C2>, <exp.C3>, <vet.C>, <vet.N>)
|
<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 para pesquisa de <exp.C2>. |
|
<vet.C> |
Representa um vetor cadeia com nome dos itens que serão acumulados. |
|
<vet.N> |
Representa um vetor numérico onde serão armazenados os resultados das totalizações. |
Esta função lê os registros cujo valor do prefixo da chave <exp.C2> forem iguais 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).
database EXEMPLO 1 a 2
decl i[1]=space(20)
i[1]="IDADEF"
decl n[1]=0
r=FGACUM("FILHOS","NOMEP1","Jo",i,n)
? n[1] && soma das idades dos filhos de pais com nomes iniciados com Jo