PCOUNT()
 Determina a posiçao do último parâmtero real passado
------------------------------------------------------------------------------

 Sintaxe

     PCOUNT() --> nPosUltArgumento

 Retorno

     PCOUNT() retorna a posiçao do último argumento passado na forma de um
     valor numérico inteiro.  Se nao foi passado nenhum argumento, PCOUNT()
     retorna zero.

 Descriçao

     PCOUNT() informa a posiçao do último argumento na lista dos que foram
     passados, quando foi invocada uma rotina ou uma funçao definida pelo
     usuário.  Esta informaçao é útil para se determinar se foram omitidos
     argumentos no fim desta lista.  Os argumentos saltados no meio da lista
     sao incluidos no valor retornado.

     Para determinar se um parâmetro nao recebeu um valor, verifique se ele
     é NIL.  Parâmetros saltados nao sao inicializados e, portanto, retornam
     NIL quando acessados.  Outro método é testar parâmetros com a funçao
     VALTYPE(), o que pode estabelecer se o argumento foi passado e, ao
     mesmo tempo, reforçar o tipo correto.  Caso um parâmetro nao tenha sido
     fornecido, pode ser atribuido um valor padrao.

     Para mais informaçoes sobre a passagem de parâmetros, consulte o
     capítulo Conceitos Básicos neste livro.

 Exemplos

     Este exemplo é uma funçao definida pelo usuário que abre um arquivo de
     banco de dados, e utiliza PCOUNT() para determinar se a rotina de
     chamada passou o nome do arquivo de banco de dados a ser aberto.  Se o
     nome nao foi passado, OpenFile() pede o nome:

     FUNCTION OpenFile( cFile )
        IF PCOUNT() == 0
           ACCEPT "Arquivo a ser usado: " TO cFile
        ENDIF
        USE (cFile)
        RETURN (!NETERR())

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

See Also: VALTYPE() DO* FUNCTION PARAMETERS PROCEDURE