about_Break

  • Cikk

Rövid leírás

Az utasítást break ismerteti, amely lehetővé teszi az aktuális vezérlőblokkból való kilépést.

Hosszú leírás

Az break utasítással kiléphet az aktuális vezérlőblokkból. A végrehajtás a következő utasításnál folytatódik a vezérlőblokk után. Az utasítás támogatja a címkéket. A címke egy szkriptben lévő utasításhoz hozzárendelt név.

Ciklusok használata break

Amikor egy break utasítás megjelenik egy hurokban, például egy foreach, for, dovagy while hurokban, a PowerShell azonnal kilép a ciklusból.

Az break utasítások tartalmazhatnak olyan címkét, amely lehetővé teszi a beágyazott hurkokból való kilépést. A címkék bármilyen ciklus kulcsszót megadhatnak, például foreachegy szkriptben, forvagy whileegy szkriptben.

Az alábbi példa bemutatja, hogyan lehet utasítással break kilépni egy utasításból for :

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

Ebben a példában az break utasítás kilép a for ciklusból, amikor a $i változó értéke 1. Annak ellenére, hogy az for utasítás értéke True (Igaz) lesz, amíg $i 10-nél nagyobb nem lesz, a PowerShell a ciklus első futtatásakor eléri a for törési utasítást.

Gyakrabban használják az break utasítást olyan hurokban, amelyben egy belső feltételnek teljesülnie kell. Vegyük példaként a következő foreach utasítást:

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

Ebben a példában az foreach utasítás iterálja a $varB tömböt. Az if utasítás a ciklus első két futtatásakor hamis értéket ad vissza, a változó $i pedig 1-zel növekszik. A ciklus harmadik futtatása $i 2, a $val változó pedig 30. Ezen a ponton az break utasítás fut, és a foreach hurok kilép.

Ciklusban címkézett break címke használata

Az break utasítások tartalmazhatnak címkét. Ha a break kulcsszót címkével használja, a PowerShell az aktuális ciklusból való kilépés helyett kilép a címkézett ciklusból. A címke egy kettőspont, amelyet egy hozzárendelt név követ. A címkének egy utasítás első tokenjének kell lennie, amelyet a ciklus kulcsszónak kell követnie, például while.

break áthelyezi a végrehajtást a címkézett hurokból. A beágyazott hurkokban ennek más az eredménye, mint a break kulcsszónak, amikor önmagában használja. Ez a példa egy while utasítással rendelkező utasítással for rendelkezik:

: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

Ha a 2 . feltétel értéke Igaz, a szkript végrehajtása a címkézett hurok után az utasításra ugrik. A példában a végrehajtás az utasítással $a = $ckezdődik újra.

A következő példában látható módon számos címkézett hurkot ágyazhat be.

: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"

Ha a $b változó értéke Igaz, a szkript végrehajtása a "piros" címkével ellátott ciklus után folytatódik. Ha a $c változó értéke Igaz, a szkriptvezérlő végrehajtása a "sárga" címkével ellátott ciklus után folytatódik.

Ha a $a változó értéke Igaz, a végrehajtás a legbelső hurok után folytatódik. Nincs szükség címkére.

A PowerShell nem korlátozza, hogy a címkék milyen mértékben folytathatják a végrehajtást. A címke még a szkriptek és függvényhívások határán is át tudja adni a vezérlést.

Használat break utasításban switch

switchEgy szerkezetben a break PowerShell kilép a switch kódblokkból.

A break kulcsszó a szerkezet elhagyására switch szolgál. A következő switch utasítás például utasítások használatával break teszteli a legspecifikusabb feltételt:

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

Ebben a példában a $var változó létrejön és inicializálódik egy sztringértékre word2. Az switch utasítás a Regex osztályt használja a változó értékének először a kifejezéssel word2való egyeztetéséhez. Mivel a változó értéke és az switch utasítás első tesztje egyezik, az utasítás első kódblokkja switch fut.

Amikor a PowerShell eléri az első break utasítást, az switch utasítás kilép. Ha a négy break utasítás el lesz távolítva a példából, mind a négy feltétel teljesül. Ez a példa az utasítást használja az break eredmények megjelenítésére, ha a legspecifikusabb feltétel teljesül.

Használat break utasításban trap

Ha az utasítás törzsében trap végrehajtott végső utasítás az break, a hibaobjektum el lesz tiltva, és a kivétel újra lesz vetve.

Az alábbi példa egy DivideByZeroException kivételt hoz létre, amely az trap utasítás használatával csapdába esik.

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

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

Figyelje meg, hogy a végrehajtás a kivételnél leáll. Soha After loop nem érik el. A kivétel újra lesz vetve a trap végrehajtás után.

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.

Ne használjon break hurkon kívül, switchvagy trap

Ha break olyan szerkezeten kívül használják, amely közvetlenül támogatja azt (hurkok, switch), trapa PowerShell megkeresi a hívásvermet egy belefoglaló szerkezethez. Ha nem talál belefoglaló szerkezetet, az aktuális futtatótér csendesen leáll.

Ez azt jelenti, hogy azok a függvények és szkriptek, amelyek véletlenül egy break külső szerkezetet használnak, amely támogatja azt, véletlenül leállíthatják a hívóikat.

Ha break egy folyamaton break( például egy ForEach-Object szkriptblokkon) belül használja, nem csak kilép a folyamatból, hanem a teljes futtatókörnyezetet is leállítja.

Lásd még