Saltar para o conteúdo principal
Versão: 20 R7 BETA

Copy parameters

Copy parameters {( inicioDesde )} -> Resultado

ParâmetroTipoDescrição
inicioDesdeIntegerIndice inicio (incluido)
ResultadoCollectionNova coleção contendo parâmetros realmente passados

Descrição

O comando Copy parameters devolve uma nova coleção que contém todos os parâmetros realmente passados a um método ou uma função. Este comando é útil quando se necessita reenviar um número variado de parâmetros de um método ou função a outro método ou função.

No parâmetro opcional inicioDesde, pode passar o índice do parâmetro desde o qual vai começar a recolher os parâmetros a reenviar. O próprio parâmetro inicioDesde está incluido.

Quando chamar dentro de uma fórmula, Copy parameters devolve os parâmetros passados explícitamente utilizando apply() ou call() (e não os passados ao método pai ou função).

Copy parameters devolve uma coleção vazia se:

  • não chamar em um método ou função que tenha sido chamado por outro método ou função,
  • não for passado nenhum parâmetro ao método pai ou função.

Exemplo 1

Chamando a uma função diferente dependendo do primeiro parâmetro e passando outros parâmetros a esta função:

 Function selectTask($task Text)
 Case of
    :($task="Task1")
       This.task1(Copy parameters(2))
    :($task="Task2")
       This.task2(Copy parameters(2))
 End case

Ou, chamando a outra função em outro objeto com apply() e passar os parâmetros:

 Function doSomething($param Text;$extraParameters Variant)
 This.delegate.doSomething.apply(This.delegate;Copy parameters)

Exemplo 2

Como o comando devolve uma coleção, pode ser utilizada com .join() para criar, por exemplo, uma lista html:

  // Classe
 
 Function list($typeText)->Text
  //tipo de lista é "u" ou "o"
 var $value : Collection
 $value:=Copy parameters(2)
 $html:="<"+$type+"l>
* "
 $html+=$value.join("
* ")
 $html+="
"
 return$html
 
  // Método
 
 $htmlList:=$c.list("u";"Alpha";"Bravo";"Charlie")
  // $htmlList =
* Alpha
* Bravo
* Charlie

Ver também

Count parameters