about_Join

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0

TÓPICO

about_join

DESCRIÇÃO BREVE

Descreve como o operador de junção (-join) combina várias cadeias de caracteres em uma única cadeia de caracteres.

DESCRIÇÃO LONGA

O operador de junção concatena um conjunto de cadeias de caracteres em uma única cadeia de caracteres. As cadeias de caracteres são acrescentadas à cadeia de caracteres resultante na ordem em que aparecem no comando.

Sintaxe

O diagrama a seguir mostra a sintaxe do operador de junção.

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

Parâmetros

String[]

Especifica uma ou mais cadeias de caracteres a serem juntadas.

parâmetro

Especifica um ou mais caracteres colocados entre as cadeias de caracteres concatenadas.

O padrão não é nenhum delimitador ("").

Comentários

O operador unário de junção (-join <string[]>) tem precedência maior do que uma vírgula. Como resultado, se você enviar uma lista separada por vírgulas das cadeias de caracteres para o operador unário de junção, somente a primeira cadeia de caracteres (antes da primeira vírgula) será enviada para o operador de junção.

Para usar o operador unário de junção, coloque as cadeias de caracteres entre parênteses, ou armazene as cadeias de caracteres em uma variável e, em seguida, envie a variável para junçã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 três cadeias de caracteres delimitadas por um espaço:

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

As instruções a seguir usam um delimitador de vários caracteres para se juntar a três cadeias de caracteres:

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

A instrução a seguir une as linhas em uma here-string em uma única cadeia de caracteres. Como uma here-string é uma cadeia de caracteres, as linhas na here-string devem ser divididas antes de poderem ser juntadas. Você pode usar este método para juntar as cadeias de caracteres novamente em um arquivo XML que foi salvo em uma here-string:

          $a = @'
          a
          b
          c
          '@

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

CONSULTE TAMBÉM

about_Operators

about_Comparison_Operators

about_Split