Сведения о разбиении
КРАТКОЕ ОПИСАНИЕ
Объясняет, как использовать оператор Split для разделения одной или нескольких строк на подстроки.
ПОДРОБНОЕ ОПИСАНИЕ
Оператор Split разделяет одну или несколько строк на подстроки. Вы можете изменить следующие элементы операции разбиения:
- Разделитель. По умолчанию используется пробел, но можно указать символы, строки, шаблоны или блоки скриптов, указывающие разделитель. Оператор Split в Windows PowerShell использует регулярное выражение в разделителе, а не простой символ.
- Максимальное число подстрок. По умолчанию возвращаются все подстроки. Если указать число, меньшее числа подстрок, оставшиеся подстроки объединяются в последнюю подстроку.
- Параметры, определяющие условия, при которых будет сопоставляться разделитель, например SimpleMatch и Multiline.
SYNTAX
На следующей схеме показан синтаксис оператора-split.
Имена параметров не отображаются в команде. Включайте только значения параметров. Значения должны присутствовать в порядке, указанном в схеме синтаксиса.
-Split <String>
-Split (<String[]>)
<String> -Split <Delimiter>[,<Max-substrings>[,"<Options>"]]
<String> -Split {<ScriptBlock>} [,<Max-substrings>]
Можно заменить -iSplit или -cSplit для -split в любой инструкции двоичного разделения (оператор разбиения, включающий разделитель или блок сценария). В -iSplit -split операторах и регистр не учитывается. В -cSplit операторе учитывается регистр, что означает, что при применении правил разделителей учитывается регистр.
PARAMETERS
<String> или <String[]>
Указывает одну или несколько строк для разбиения. При отправке нескольких строк все строки разбиваются с помощью одних и тех же правил разделителей.
Пример.
-split "red yellow blue green"
red
yellow
blue
green
<Delimiter>
Символы, которые обозначают конец подстроки. По умолчанию разделителем являются пробелы, включая пробелы и непечатаемые символы, например символ новой строки ( ` n) и знак табуляции ( ` t). При разбиении строк разделитель опускается из всех подстрок. Пример.
"Lastname:FirstName:Address" -split ":"
Lastname
FirstName
Address
По умолчанию разделитель в результатах опускается. Чтобы сохранить все или часть разделителя, заключите в круглые скобки часть, которую необходимо сохранить. Если <Max-substrings> параметр добавлен, это имеет приоритет, если команда разделяет коллекцию. Если включить разделитель как часть выходных данных, команда возвращает разделитель в составе выходных данных. Однако разделение строки для возврата разделителя в качестве части выходных данных не учитывается в качестве разбиения.
Примеры
"Lastname:FirstName:Address" -split "(:)"
Lastname
:
FirstName
:
Address
"Lastname/:/FirstName/:/Address" -split "/(:)/"
Lastname
:
FirstName
:
Address
В следующем примере <Max-substrings> значение равно 3. Это приводит к трем разбиениям строковых значений, но всего за пять строк в результирующем выводе; разделитель включается после разбиения до тех пор, пока не будет достигнуто максимально допустимое число из трех подстрок. Дополнительные разделители в конечной подстроке становятся частью подстроки.
'Chocolate-Vanilla-Strawberry-Blueberry' -split '(-)', 3
Chocolate
-
Vanilla
-
Strawberry-Blueberry
<Max-substrings>
Указывает максимальное число разбиений строки. По умолчанию используются все подстроки, разделенные разделителем. Если подстроки больше, они объединяются с конечной подстрокой. Если число подстрок меньше, возвращаются все подстроки. Значение 0 и отрицательные значения возвращают все подстроки.
Параметр max-substring не задает максимальное число возвращаемых объектов. его значение равно максимальному количеству разделений строки. При отправке в оператор Split более одной строки (массива строк) ограничение Max-substring применяется к каждой строке отдельно.
Пример.
$c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
$c -split ",", 5
Mercury
Venus
Earth
Mars
Jupiter,Saturn,Uranus,Neptune
<ScriptBlock>
Выражение, задающее правила для применения разделителя. Выражение должно иметь значение $true или $false. Заключите блок скрипта в фигурные скобки.
Пример.
$c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
$c -split {$_ -eq "e" -or $_ -eq "p"}
M
rcury,V
nus,
arth,Mars,Ju
it
r,Saturn,Uranus,N
tun
<Options>
Заключите имя параметра в кавычки. Параметры допустимы только в том случае, если <Max-substrings> параметр используется в инструкции.
Для параметра options используется следующий синтаксис:
"SimpleMatch [,IgnoreCase]"
"[RegexMatch] [,IgnoreCase] [,CultureInvariant]
[,IgnorePatternWhitespace] [,ExplicitCapture]
[,Singleline | ,Multiline]"
Параметры SimpleMatch:
- SimpleMatch: Используйте простое сравнение строк при вычислении разделителя. Не может использоваться с Режексматч.
- IgnoreCase: принудительное сопоставление без учета регистра, даже если указан оператор-ксплит.
Параметры Режексматч:
- Режексматч: используйте сопоставление регулярных выражений для вычисления разделителя. Это поведение установлено по умолчанию. Не может использоваться с SimpleMatch.
- IgnoreCase: принудительное сопоставление без учета регистра, даже если указан оператор-ксплит.
- CultureInvariant: игнорирует культурные различия в языке, если оценка разделитель. Допустимо только с Режексматч.
- IgnorePatternWhitespace: игнорирует неэкранированные пробелы и комментарии, помеченные знаком решетки (#). Допустимо только с Режексматч.
- Многострочный: многострочный режим заставляет
^и$сопоставлять начальную конец каждой строки, а не начало и конец входной строки. - SingleLine: режим SingleLine обрабатывает входную строку как SingleLine.
Он заставляет
.символ соответствовать каждому символу (включая символы новой строки) вместо того, чтобы сопоставлять каждый символ, кроме символа новой строки\n. - ExplicitCapture: игнорирует неименованные группы соответствия, чтобы в списке результатов возвращались только явные группы записи. Допустимо только с Режексматч.
Примечание
SingleLine является поведением по умолчанию. Singleline и Multiline не могут использоваться вместе с параметром Options. Это было решено в PowerShell 6,0. Обходной обходной проблемы является использование модификаторов режима в регулярном выражении. Дополнительные сведения об модификаторах режима см. в статье Параметры регулярных выражений .
ОПЕРАТОРЫ УНАРного и БИНАРного разделения
Оператор унарного разбиения ( -split <string> ) имеет более высокий приоритет, чем запятая. В результате, если отправить разделенный запятыми список строк в оператор унарного разбиения, то разбиение выполняется только на первую строку (перед первой запятой).
Чтобы разделить более одной строки, используйте один из следующих шаблонов:
- Использование оператора двоичного разделения ( <string[]> -Split <delimiter> )
- Заключите все строки в круглые скобки
- Сохранить строки в переменной, а затем отправить переменную оператору Split
Рассмотрим следующий пример.
PS> -split "1 2", "a b"
1
2
a b
PS> "1 2", "a b" -split " "
1
2
a
b
PS> -split ("1 2", "a b")
1
2
a
b
PS> $a = "1 2", "a b"
PS> -split $a
1
2
a
b
Примеры
Следующая инструкция разделяет строку на пробел.
-split "Windows PowerShell 2.0`nWindows PowerShell with remoting"
Windows
PowerShell
2.0
Windows
PowerShell
with
remoting
Следующая инструкция разделяет строку на любую запятую.
"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split ','
Mercury
Venus
Earth
Mars
Jupiter
Saturn
Uranus
Neptune
Следующая инструкция разделяет строку на шаблоне "ER".
"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split 'er'
M
cury,Venus,Earth,Mars,Jupit
,Saturn,Uranus,Neptune
Следующая инструкция выполняет разбиение с учетом регистра по букве "N".
"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -cSplit 'N'
Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,
eptune
Следующая инструкция разделяет строку на "e" и "t".
"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[et]'
M
rcury,V
nus,
ar
h,Mars,Jupi
r,Sa
urn,Uranus,N
p
un
Следующая инструкция разделяет строку на "e" и "r", но ограничивает результирующие подстроки до шести подстрок.
"Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[er]', 6
M
cu
y,V
nus,
arth,Mars,Jupiter,Saturn,Uranus,Neptune
Следующая инструкция разделяет строку на три подстроки.
"a,b,c,d,e,f,g,h" -split ",", 3
a
b
c,d,e,f,g,h
Следующая инструкция разделяет две строки на три подстроки. (Ограничение применяется к каждой строке независимо друг от друга.)
"a,b,c,d", "e,f,g,h" -split ",", 3
a
b
c,d
e
f
g,h
Следующая инструкция разделяет каждую строку в строке Here в первой цифре. Он использует многострочный параметр для распознавания начала каждой строки и строки.
0 представляет значение "вернуть все" для параметра max-substring. Параметры, например Multiline, можно использовать, только если указано значение Max-substring.
$a = @'
1The first line.
2The second line.
3The third of three lines.
'@
$a -split "^\d", 0, "multiline"
The first line.
The second line.
The third of three lines.
Следующая инструкция использует символ обратной косой черты для экранирования разделителя с точкой (.).
При использовании значения по умолчанию Режексматч точка, заключенная в кавычки ("."), интерпретируется так, чтобы соответствовать любому символу, кроме символа новой строки. В результате инструкция Split возвращает пустую строку для каждого символа, кроме новой строки.
"This.is.a.test" -split "\."
This
is
a
test
В следующей инструкции используется параметр SimpleMatch для направления оператора-split на интерпретацию разделителя с точкой (.) буквально.
0 представляет значение "вернуть все" для параметра max-substring. Параметры, такие как SimpleMatch, можно использовать, только если указано значение Max-substring.
"This.is.a.test" -split ".", 0, "simplematch"
This
is
a
test
Следующая инструкция разделяет строку на один из двух разделителей в зависимости от значения переменной.
$i = 1
$c = "LastName, FirstName; Address, City, State, Zip"
$c -split $(if ($i -lt 1) {","} else {";"})
LastName, FirstName
Address, City, State, Zip