Share via

about_Join

  • Artigo

Descrição breve

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

Descrição longa

O operador join concatena um conjunto de cadeias de caracteres em uma única cadeia de caracteres. As cadeias de caracteres são anexadas à 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 unidas.

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

Comentários

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

Para usar o operador de junção unária, 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 associaçã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 unir três cadeias de caracteres:

$a = "WIND", "S P", "ERSHELL"
$a -join "OW"
WINDOWS POWERSHELL

A instrução a seguir une as linhas em uma cadeia de caracteres aqui em uma única cadeia de caracteres. Como uma cadeia de caracteres aqui é uma cadeia de caracteres, as linhas na cadeia de caracteres aqui devem ser divididas antes de poderem ser 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 aqui:

$a = @'
a
b
c
'@

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

Confira também