about_Join

TÓPICO
    about_join

DESCRIÇÃO RESUMIDA
    Descreve como o operador dinâmico (-join) combina várias cadeias 
    de caracteres em uma única cadeia.


DESCRIÇÃO LONGA
    O operador dinâmico concatena um conjunto de cadeias de 
    caracteres em uma única cadeia. As cadeias de caracteres são 
    anexadas à cadeia resultante na ordem em que aparecem no comando. 


  Sintaxe
      O diagrama a seguir mostra a sintaxe para o operador dinâmico.

    -Join <String[]>
    <String[]> -Join <Delimiter>


  Parâmetros
      String[]
          Especifica uma ou mais cadeias de caracteres a serem unidas.


      Delimitador
      Especifica um ou mais caracteres colocados entre as cadeias de 
      caracteres concatenadas.
          O padrão é nenhum delimitador ("").
    

  Comentários
      O operador dinâmico unário (-join <string[]>) tem maior 
      presença que uma
      vírgula. Consequentemente, se você enviar uma lista separada 
      por vírgulas de cadeias de caracteres para o operador dinâmico 
      unário, somente a primeira cadeia de caracteres (antes da 
      primeira vírgula) é enviado ao operador dinâmico.


      Para usar o operador dinâmico unário, coloque as cadeias de 
      caracteres entre parênteses ou armazene as cadeias em uma 
      variável e, em seguida, envie a variável para união.


      Por exemplo:

          -join "a", "b", "c"
          a
          b
          c

          -join ("a", "b", "c")
          abc


          $z = "a", "b", "c"
          -join $z
          abc


  Exemplos
      A instrução a seguir une três cadeias de caracteres:

    
          -join ("Windows", "PowerShell", "2.0") 
          WindowsPowerShell2.0

    
      A instrução a seguir une as três cadeias de caracteres 
      delimitadas por um espaço:

    
          "Windows", "PowerShell", "2.0" -join " " 
          Windows PowerShell 2.0


      A instrução a seguir usa um delimitador de vários caracteres 
      para unir três cadeias de caracteres:


          $a = "WIND", "SP", "ERSHELL" 
          $a -join "OW"
          WINDOWSPOWERSHELL


      A instrução a seguir une as linhas de uma cadeia de caracteres 
      here em uma única cadeia. Como a cadeia de caracteres here é 
      uma cadeia, as linhas nessa cadeia devem ser divididas antes de 
      serem unidas. Você pode usar esse método para unir novamente as 
      cadeias de caracteres em um arquivo XML que foi salvo em uma 
      cadeia de caracteres here:


          $a = @'
          a
          b
          c
          '@

          (-split $a) -join " "
          a b c
    

CONSULTE TAMBÉM
    about_Operators
    about_Comparison_Operators
    about_Split