about_Join

Krótki opis

Opisuje, w jaki sposób operator sprzężenia (-join) łączy wiele ciągów w jeden ciąg.

Długi opis

Operator sprzężenia łączy zestaw ciągów w jeden ciąg. Ciągi są dołączane do wynikowego ciągu w kolejności, w której są wyświetlane w poleceniu.

Składnia

Na poniższym diagramie przedstawiono składnię operatora sprzężenia.

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

Parametry

String[] — określa co najmniej jeden ciąg do sprzężenia.

Ogranicznik — określa jeden lub więcej znaków umieszczonych między połączonymi ciągami. Wartość domyślna to żaden ogranicznik ("").

Uwagi

Operator sprzężenia jednoargumentowego (-join <string[]>) ma wyższy priorytet niż przecinek. W związku z tym, jeśli prześlesz rozdzielaną przecinkami listę ciągów do operatora jednoargumentowego sprzężenia, tylko pierwszy ciąg (przed pierwszym przecinkiem) zostanie przesłany do operatora sprzężenia.

Aby użyć operatora jednoargumentowego sprzężenia, należy ująć ciągi w nawiasy lub zapisać ciągi w zmiennej, a następnie przesłać zmienną do sprzężenia.

Na przykład:

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

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

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

Przykłady

Następująca instrukcja łączy trzy ciągi:

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

Następująca instrukcja łączy trzy ciągi rozdzielone spacją:

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

Następujące instrukcje używają ogranicznika wieloznakowego do łączenia trzech ciągów:

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

Poniższa instrukcja łączy wiersze w poniższym ciągu w jeden ciąg. Ponieważ ciąg here-string jest jednym ciągiem, przed ich sprzężeniami wiersze w ciągu tutaj muszą zostać podzielone. Tej metody można użyć do ponownego dołączania ciągów w pliku XML, który został zapisany w następującym ciągu:

$a = @'
a
b
c
'@

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

Zobacz też