Histórico da Página

Funções

Image Modified

Funções são

...

sequências de instruções de programa de computador que executam um determinado procedimento.

Suas tarefas podem ser modificadas e adaptadas às necessidades através de um número de elementos denominados parâmetros.

Parâmetros de funções são informações que definem os limites ou ações de uma rotina.

Por meio da rotina Biblioteca de Funções é possível realizar a manutenção das funções que serão utilizadas no ambiente Gestão de Pessoal, juntamente com as funções disponíveis no ambiente Protheus. As funções previamente cadastradas facilitarão o processo de criação das fórmulas.

Para compor uma fórmula, a função é uma importante ferramenta de localização e cálculo de dados.

Exemplo 1:

A Função FPOSREG verifica e posiciona em um registro da tabela, a partir da chave indicada.

...

• Função: FPOSREG('SRB',1,SRA->RA_FILIAL+SRA->RA_MAT,.F.)

Onde:

...

• SRB  é a tabela a ser pesquisada

...

• 1

...

•   é a ordem de busca na tabela indicada

...

• SRA>RA_FILIAL+SRA>RA_MAT

...

•   é a chave de pesquisa na tabela indicada, que nesse caso, está pesquisando o funcionário pela filial (SRA->RA_FILIAL) e matrícula (SRA->RA_MAT), na tabela SRA (Cadastro de Funcionários).

...

• .F.

...

•   é o parâmetro que indica o tipo de pesquisa realizada, sendo:

...

• se .F. (false - falso) indica o primeiro registro de pesquisa na tabela

...

• se .T. (true - verdadeiro) indica a seleção do próximo registro com a mesma chave

Neste exemplo, a tabela de dependentes do funcionário que está sendo calculado é posicionada. Se houver dependentes deste funcionário, será retornado verdadeiro e manterá posicionado no registro. Caso contrário, retornará falso. Se desejar verificar a existência de outros registros com a mesma chave, deve-se chamar novamente a função indicando . T. no último parâmetro.

...

• Função: FPOSREG('SRB',1,SRA->RA_FILIAL+SRA->RA_MAT,.T.)

Exemplo 2:

Chamada de função:

...

Veja também

...

• Biblioteca de Funções