about_Ref

TÓPICO
    about_Ref

DESCRIÇÃO RESUMIDA
    Descreve como criar e usar um tipo de variável de referência.

DESCRIÇÃO LONGA
    Você pode usar o tipo de variável de referência para permitir que 
    um método altere o valor de uma variável transmitido para ele. 

    Quando o tipo [ref] é associado a um objeto, ele retorna uma referência 
    a esse objeto. Se a referência for usada com um método, ele poderá 
    se referir ao objeto transmitido para ele. Se o objeto tiver sido 
    alterado dentro do método, a alteração aparecerá como uma alteração 
    no valor da variável quando o controle retornar ao método de chamada. 

    Para usar as referências, o parâmetro deve ser uma variável de 
    referência. Caso contrário, uma exceção InvalidArgument será lançada.

    Os parâmetros usados em chamadas de método devem ter o mesmo tipo 
    exigido pelos métodos. 

    Exemplos:
    
    PS> function swap([ref]$a,[ref]$b) 
    >> { 
    >>   $a.value,$b.value = $b.value,$a.value 
    >> }

    PS> $a = 1
    PS> $b = 10
    PS> $a,$b
    1
    10
    PS> swap ([ref]$a) ([ref]$b)
    PS> $a,$b
    10
    1

    PS C:\ps-test> function double
    >> {
    >>   param ([ref]$x) $x.value = $x.value * 2
    >> }

    PS C:> $number = 8
    PS C:> $number
    8
    PS C> double ([ref]$number)
    PS C> $number
    16
    
    A variável deve ser uma variável de referência.

    PS C:\ps-test> double $number
    double : Tipo de referência esperado em um argumento.
    At line:1 char:7
    + double <<<< $number
    
 
CONSULTE TAMBÉM
    about_Variables
    about_Environment_Variables
    about_Functions
    about_Script_Blocks