Split 运算符将一个或多个字符串拆分为子字符串。 可以更改拆分操作的以下元素:

  • 分隔符。 默认值为空格,但可以指定指定分隔符的字符、字符串、模式或脚本块。 PowerShell 中的 Split 运算符在分隔符中使用正则表达式,而不是简单字符。
  • 最大子字符串数。 默认值为返回所有子字符串。 如果指定的数字小于子字符串的数目,则剩余的子字符串将串联在最后一个子字符串中。
  • 用于指定匹配分隔符的条件的选项,例如 SimpleMatch 和 Multiline。
  • 下图显示了 -split 运算符的语法。

    参数名称不会显示在 命令中。 仅包括参数值。 值必须按语法图中指定的顺序显示。

    -Split <String>
    -Split (<String[]>)
    <String> -Split <Delimiter>[,<Max-substrings>[,"<Options>"]]
    <String> -Split {<ScriptBlock>} [,<Max-substrings>]
    

    可以在包含分隔符或-split-cSplit脚本块) 的 Split 语句 (任何二进制 Split 语句中替换 -iSplit 或 。 -iSplit-split 运算符不区分大小写。 运算符 -cSplit 区分大小写,这意味着在应用分隔符规则时将考虑大小写。

    <String> 或 <String[]>

    指定要拆分的一个或多个字符串。 如果提交多个字符串,则使用相同的分隔符规则拆分所有字符串。

    -split "red yellow blue green"
    yellow
    green
    

    标识子字符串末尾的字符。 默认分隔符为空格,包括空格和不可打印字符,例如换行符 ('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>

    指定拆分操作返回的最大子字符串数。 默认值为由分隔符拆分的所有子字符串。 如果有更多的子字符串,则它们会连接到最终的子字符串。 如果子字符串较少,则返回所有子字符串。 值为 0 将返回所有子字符串。

    $c = "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune"
    $c -split ",", 5
    
    Mercury
    Venus
    Earth
    Jupiter,Saturn,Uranus,Neptune
    

    如果向 运算符提交多个字符串 () -split 字符串数组,则 Max-substrings 限制将分别应用于每个字符串。

    $c = 'a,b,c','1,2,3,4,5'
    $c -split ',', 3
    3,4,5
    

    <Max-substrings> 不指定返回的最大对象数。 在以下示例中, <Max-substrings> 设置为 3。 这会导致三个子字符串值,但在生成的输出中总共有五个字符串。 分隔符包含在拆分之后,直到达到三个子字符串的最大值。 最终子字符串中的其他分隔符将成为子字符串的一部分。

    'Chocolate-Vanilla-Strawberry-Blueberry' -split '(-)', 3
    
    Chocolate
    Vanilla
    Strawberry-Blueberry
    

    负值返回从输入字符串末尾开始请求的子字符串量。

    PowerShell 7 中添加了对负值的支持。

    $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"}
    rcury,V
    arth,Mars,Ju
    r,Saturn,Uranus,N
    

    将选项名称括在引号中。 仅当在 语句中使用 Max-substrings> 参数时<,选项才有效。

    Options 参数的语法为:

    "SimpleMatch [,IgnoreCase]"
    "[RegexMatch] [,IgnoreCase] [,CultureInvariant]
    [,IgnorePatternWhitespace] [,ExplicitCapture]
    [,Singleline | ,Multiline]"
    

    SimpleMatch 选项包括:

  • SimpleMatch:在计算分隔符时使用简单字符串比较。 不能与 RegexMatch 一起使用。
  • IgnoreCase:强制匹配不区分大小写,即使指定了 -cSplit 运算符也是如此。
  • RegexMatch 选项包括:

  • RegexMatch:使用正则表达式匹配来计算分隔符。 此选项为默认行为。 不能与 SimpleMatch 一起使用。
  • IgnoreCase:强制匹配不区分大小写,即使指定了 -cSplit 运算符也是如此。
  • CultureInvariant:在评估分隔符时忽略语言中的文化差异。 仅对 RegexMatch 有效。
  • IgnorePatternWhitespace:忽略未转义的空格和用数字符号 (#) 标记的注释。 仅对 RegexMatch 有效。
  • 多行:多行模式强制 ^$ 以匹配每一行的开头,而不是输入字符串的开头和结尾。
  • 单行:单行模式将输入字符串视为 单行。 它强制 . 字符匹配每个字符 (包括换行符) ,而不是匹配除换行符 \n以外的每个字符。
  • ExplicitCapture:忽略非命名的匹配组,以便结果列表中仅返回显式捕获组。 仅对 RegexMatch 有效。
  • 一元和二元拆分运算符

    一元拆分运算符 (-split <string>) 的优先级高于逗号。 因此,如果将逗号分隔的字符串列表提交到一元拆分运算符,则仅拆分第一个逗号) 之前的第一个字符串 (。

    使用以下模式之一拆分多个字符串:

  • 使用二进制拆分运算符 (<string[]> -split <分隔符>)
  • 将所有字符串括在括号中
  • 将字符串存储在变量中,然后将变量提交到 split 运算符
  • 请考虑以下示例:

    PS> -split "1 2", "a b"
    
    PS> "1 2", "a b" -split " "
    
    PS> -split ("1 2", "a b")
    
    PS> $a = "1 2", "a b"
    PS> -split $a
    

    以下语句在空格处拆分字符串。

    -split "Windows PowerShell 2.0`nWindows PowerShell with remoting"
    Windows
    PowerShell
    Windows
    PowerShell
    remoting
    

    以下语句以任何逗号拆分字符串。

    "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split ','
    
    Mercury
    Venus
    Earth
    Jupiter
    Saturn
    Uranus
    Neptune
    

    以下语句在模式“er”处拆分字符串。

    "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split 'er'
    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]'
    rcury,V
    h,Mars,Jupi
    urn,Uranus,N
    

    以下语句将字符串拆分为“e”和“r”,但将生成的子字符串限制为六个子字符串。

    "Mercury,Venus,Earth,Mars,Jupiter,Saturn,Uranus,Neptune" -split '[er]', 6
    arth,Mars,Jupiter,Saturn,Uranus,Neptune
    

    以下语句将字符串拆分为三个子字符串。

    "a,b,c,d,e,f,g,h" -split ",", 3
    c,d,e,f,g,h
    

    以下语句将字符串拆分为从字符串末尾开始的三个子字符串。

    "a,b,c,d,e,f,g,h" -split ",", -3
    
    a,b,c,d,e,f
    

    以下语句将两个字符串拆分为三个子字符串。 (限制单独应用于每个字符串。)

    "a,b,c,d", "e,f,g,h" -split ",", 3
    

    以下语句将 here-string 中的每一行拆分为第一个数字。 它使用多行选项来识别每行和字符串的开头。

    0 表示 Max-substrings 参数的“返回所有”值。 仅当指定 Max-substrings 值时,才能使用多行等选项。

    $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.
    

    以下语句使用反斜杠字符对点 (.) 分隔符进行转义。

    使用默认值 RegexMatch 时,用引号括起来的点 (“。”) 解释为匹配除换行符以外的任何字符。 因此,Split 语句将返回除换行符以外的每个字符的空白行。

    "This.is.a.test" -split "\."
    

    以下语句使用 SimpleMatch 选项指示 -split 运算符按字面解释点 (.) 分隔符。

    0 表示 Max-substrings 参数的“返回所有”值。 仅当指定 Max-substrings 值时,才能使用 SimpleMatch 等选项。

    "This.is.a.test" -split ".", 0, "simplematch"
    

    以下语句将字符串拆分为两个分隔符之一,具体取决于变量的值。

    $i = 1
    $c = "LastName, FirstName; Address, City, State, Zip"
    $c -split $(if ($i -lt 1) {","} else {";"})
    
    LastName, FirstName
     Address, City, State, Zip
    
  • Split-Path
  • about_Operators
  • about_Comparison_Operators
  • about_Join
  •