使用英语阅读

通过

about_Break

  • 项目

简短说明

描述 break 语句，该语句提供了退出当前控制块的方法。

长说明

break 语句提供了一种退出当前控制块的方法。 在控制块之后的下一个语句中继续执行。 该语句支持标签。 标签是你在脚本中分配给语句的名称。

在循环中使用 break

当 break 语句出现在循环中（例如 foreach、for、do或 while 循环）时，PowerShell 会立即退出循环。

break 语句可以包含允许退出嵌入循环的标签。 标签可以在脚本中指定任何循环关键字，例如 foreach、for或 while。

以下示例演示如何使用 break 语句退出 for 语句：

PowerShell 
for($i=1; $i -le 10; $i++) {
   Write-Host $i
   break
}

在此示例中，当 $i 变量等于 1 时，break 语句将退出 for 循环。 尽管 for 语句的计算结果为 True，直到 $i 大于 10，PowerShell 在首次运行 for 循环时到达断语句。

在必须满足内部条件的循环中使用 break 语句更为常见。 请考虑以下 foreach 语句示例：

PowerShell 
$i=0
$varB = 10,20,30,40
foreach ($val in $varB) {
  if ($val -eq 30) {
    break
  }
  $i++
}
Write-Host "30 was found in array index $i"

在此示例中，foreach 语句循环访问 $varB 数组。 if 语句的计算结果为 False，运行循环的前两次，变量 $i 递增 1。 第三次运行循环，$i 等于 2，$val 变量等于 30。 此时，break 语句将运行，foreach 循环将退出。

在循环中使用带标签的 break

break 语句可以包含标签。 如果将 break 关键字与标签一起使用，PowerShell 将退出标记循环，而不是退出当前循环。 标签是一个冒号，后跟你分配的名称。 标签必须是语句中的第一个标记，并且它必须后跟循环关键字，例如 while。

break 将执行移出标记的循环。 在嵌入式循环中，这与 break 关键字本身使用时的结果不同。 此示例具有具有 for 语句的 while 语句：

PowerShell 
:myLabel while (<condition 1>) {
  for ($item in $items) {
    if (<condition 2>) {
      break myLabel
    }
    $item = $x   # A statement inside the For-loop
  }
}
$a = $c  # A statement after the labeled While-loop

如果条件 2 的计算结果为 True，则脚本的执行将跳到标记循环后的语句。 在此示例中，执行再次以语句 $a = $c开头。

可以嵌套许多标记的循环，如以下示例所示。

PowerShell 
:red while (<condition1>) {
  :yellow while (<condition2>) {
    while (<condition3>) {
      if ($a) {break}
      if ($b) {break red}
      if ($c) {break yellow}
    }
    Write-Host "After innermost loop"
  }
  Write-Host "After yellow loop"
}
Write-Host "After red loop"

如果 $b 变量的计算结果为 True，则脚本的执行将在标记为“red”的循环之后恢复。 如果 $c 变量的计算结果为 True，则脚本控件的执行将在标记为“yellow”的循环后恢复。

如果 $a 变量的计算结果为 True，则执行将在最内部循环后恢复。 不需要标签。

PowerShell 不会限制标签可以恢复执行的频率。 标签甚至可以跨脚本和函数调用边界传递控件。

在 switch 语句中使用 break

在 switch构造中，break 会导致 PowerShell 退出 switch 代码块。

break 关键字用于保留 switch 构造。 例如，以下 switch 语句使用 break 语句来测试最具体的条件：

PowerShell 
$var = "word2"
switch -regex ($var) {
    "word2" {
      Write-Host "Exact" $_
      break
    }

    "word.*" {
      Write-Host "Match on the prefix" $_
      break
    }

    "w.*" {
      Write-Host "Match on at least the first letter" $_
      break
    }

    default {
      Write-Host "No match" $_
      break
    }
}

在此示例中，将创建 $var 变量并将其初始化为字符串值 word2。 switch 语句使用 Regex 类将变量值与术语 word2匹配。 由于变量值和 switch 语句中的第一个测试匹配，因此 switch 语句中的第一个代码块将运行。

当 PowerShell 到达第一个 break 语句时，switch 语句将退出。 如果从示例中删除了四个 break 语句，则满足所有四个条件。 此示例使用 break 语句在满足最具体的条件时显示结果。

在 trap 语句中使用 break

如果在 trap 语句正文中执行的最后一个语句 break，则会取消错误对象并重新引发异常。

以下示例创建使用 trap 语句捕获的 DivideByZeroException 异常。

PowerShell 
function test {
  trap [DivideByZeroException] {
    Write-Host 'divide by zero trapped'
    break
  }

  $i = 3
  'Before loop'
  while ($true) {
     "1 / $i = " + (1 / $i--)
  }
  'After loop'
}
test

请注意，执行在异常时停止。 从未达到 After loop。 执行 trap 后，将重新引发异常。

Output 
Before loop
1 / 3 = 0.333333333333333
1 / 2 = 0.5
1 / 1 = 1
divide by zero trapped
ParentContainsErrorRecordException:
Line |
  10 |       "1 / $i = " + (1 / $i--)
     |       ~~~~~~~~~~~~~~~~~~~~~~~~
     | Attempted to divide by zero.

请勿在循环、switch或 trap 外部使用 break

在直接支持它的构造外部使用 break 时（循环、switch、trap），PowerShell 看起来 调用堆栈 封闭构造。 如果找不到封闭构造，则当前运行空间将悄悄终止。

这意味着无意中使用封闭构造外部的 break 的函数和脚本可能会无意中终止其 调用方。

在管道中使用 breakbreak（例如 ForEach-Object 脚本块），不仅退出管道，还可能会终止整个运行空间。

另请参阅