PowerShellのwhile文が動かない・止まらない原因を10例で確認

whileは条件を先に判定し、真なら本体で状態を更新して条件の再判定へ戻る。偽なら本体へ入らず終了する。

PowerShellのwhile文で何も表示されない、いつまでも止まらないときは、「開始時の値」「続ける条件」「値を変える行」の順に確認します。whileは繰り返す処理を動かす前に条件を調べるため、最初から条件を満たさなければ1回も動きません。

この記事では、画面表示と実行中だけ保持する小さなデータを使う10例で、判定から停止までを追います。Windows PowerShellを通常権限で開いて進められ、ファイルの準備やサービスの設定変更は不要です。

実行記録の環境はWindows PowerShell 5.1.26100.9818です。PowerShell 7.6についてはwhileの構文資料との照合にとどまり、7系での実行や速度比較は行っていません。

先に結論

  • whileは本体の前に条件を調べるため、0回で終わる場合があります。do-whileとdo-untilは、先に本体を1回動かします。
  • continueはその回の残りを省いて条件判定へ戻ります。値の更新まで飛ばすと、同じ条件を満たし続けて止まらなくなる場合があります。
  • 回数の上限と成功は別に判定し、行の読み取りでは空行と読み終わりを区別します。固定データの練習例を、外部サービスへの再送にそのまま転用しません。

通常権限のWindows PowerShellで準備する

練習用に新しいWindows PowerShellの画面を開いて進めます。管理者起動や実行ポリシーの変更は不要です。どのフォルダーからでも実行でき、掲載例はファイルの作成やサービスの変更を行いません。

$で始まる名前は値を入れる変数、=は右の値を左の変数へ入れる代入の記号です。文字の並びを文字列と呼び、引用符で囲んで表します。+は今回、文字列と値をつないで表示するために使います。

  1. スタートメニューで「Windows PowerShell」を検索し、通常権限で新しい画面を開きます。
  2. $PSVersionTable.PSVersionを入力し、表示された版を確認します。今回の実行環境は5.1.26100.9818です。
  3. 各コード欄の先頭から末尾までを、1つのまとまりとして貼り付けます。ループの後にある出力行も含めます。
  4. 末尾でEnterを押し、表示を実行結果の欄と比べます。実行結果の欄は入力しません。コード欄が複数ある節では、欄ごとに実行します。

入力待ちが続く場合は、括弧や引用符の閉じ忘れを確認します。Ctrl+Cで入力や実行を中断できますが、既に行った処理を元へ戻す操作ではありません。練習後に画面を閉じると、その画面で作った変数も残りません。

1から3を表示し、判定・本体・更新を追う

whileは先に条件を調べ、条件を満たす間だけ本体を繰り返します。

whileの丸括弧には続ける条件、波括弧には繰り返す処理を書きます。この処理を本体と呼びます。条件を満たすことが真、満たさないことが偽で、コード中の$trueは真、$falseは偽を表します。

この例では変数$stepを1から始め、-leで3以下かを調べます。本体では$stepの値を表示し、++で1増やします。値の更新は自動ではないため、条件を終わりへ進める行を本体に置いています。

条件判定時のstep 3以下か 本体の出力 更新後
1 真 1 2
2 真 2 3
3 真 3 4
4 偽 なし 更新しない

条件を先に調べ、1から3の後に4で止まる

$step = 1
while ($step -le 3) {
    $step
    $step++
}
'終了時: ' + $step

実行結果

1
2
3
終了時: 4

1、2、3に続いて「終了時: 4」が出れば想定どおりです。3を表示した後も1増やすため、次の判定は4で行います。4は条件を満たさず、本体には入らないので、ループ後の出力行でだけ表示されます。

表の左列は条件を調べる時点の値です。「本体の出力」「更新後」と分けて読むと、表示された3と、終了時に残る4の違いを追えます。条件が偽になった行では、本体の出力も更新もありません。

何も出ないときは、最初の条件を確かめる

whileは初回から条件が偽なら本体を動かしません。do-whileは先に1回動かします。

開始値が4で、続ける条件が3以下なら、whileの本体には入りません。本体を最低1回動かしてから判断したい場合はdo-whileがあります。doの後の本体を動かし、その後ろのwhileで続けるかを決めます。

次のコード欄では、whileとdo-whileを続けて実行します。それぞれの開始前に値を4へ戻しているため、直前の練習で残った値には左右されません。閉じる波括弧の後のwhileと条件も含め、欄全体を入力します。

構文 条件を調べる時点 繰り返す条件 最初の本体
while 本体の前 真の間 0回の場合あり
do-while 本体の後 真の間 1回は実行
do-until 本体の後 偽の間 1回は実行

開始時に条件が偽の場合をwhileとdo-whileで比べる

'while'
$step = 4
while ($step -le 3) {
    $step
    $step++
}
'do-while'
$step = 4
do {
    $step
    $step++
} while ($step -le 3)
'終了時: ' + $step

実行結果

while
do-while
4
終了時: 5

「while」の直後には数が出ず、「do-while」の後には4が出ます。do-whileでは4を表示して5へ増やした後に条件を調べるため、最後は「終了時: 5」です。表示の有無と終了時の値を分けて確認してください。

比較表では、条件を調べる時点と、繰り返す条件を並べています。do-whileとdo-untilは、どちらも先に1回動かしますが、条件の読み方が異なります。do-untilの動きは次の例で確認します。

do-untilは、終了条件が真になったら止まる

untilの条件は「続ける条件」ではなく、「終わる条件」として読みます。

do-untilも最初に本体を1回動かします。その後で条件を調べ、偽なら続け、真なら終わります。whileと同じ継続条件として読むと、繰り返す範囲や止まる位置を取り違えます。

次の例の-geは、左の値が右の値以上かを調べる記号です。1を表示して2へ増やした時点では3以上ではないので続けます。2を表示して3へ増やすと、終了条件を満たして止まります。

do-untilは終了条件が真になったら止まる

$step = 1
do {
    $step
    $step++
} until ($step -ge 3)
'終了時: ' + $step

実行結果

1
2
終了時: 3

出る数は1と2で、最後は「終了時: 3」です。3は終了条件の判定に使われた値で、本体では表示していません。先に1回動かしてよいかに加え、条件が継続と終了のどちらを表すかを確認します。

continueは残りを省き、breakはループを終える

continueで飛ばす範囲に、終了へ進むための更新が入っていないか確認します。

次の2例では、-ltで4未満か、-eqで2と等しいかを調べます。ifは条件が真のときだけ処理する分岐です。値を入れる代入の=と、等しいかを調べる-eqは、役割が異なります。

1つ目のcontinueは、その回の残りを省いてwhileの条件判定へ戻ります。2つ目のbreakは、ループを終了して後の処理へ進みます。どちらも2になった時点で分岐しますが、その後の動きが違います。

値の更新をcontinueの後に置くと、その更新まで飛ばします。同じ値で条件を満たし続ければ止まらなくなるため、掲載例は先に++で値を増やしています。止まらない例を実行する必要はありません。

stepが2のとき 残りの本体 次の移動先 終了時のstep
continue 省く whileの条件判定 4
break 省く ループの後 2

continueより前で更新し、2の表示だけを省く

$step = 0
while ($step -lt 4) {
    $step++
    if ($step -eq 2) { continue }
    $step
}
'終了時: ' + $step

実行結果

1
3
4
終了時: 4

breakでループを終了し、後の処理へ進む

$step = 0
while ($step -lt 4) {
    $step++
    if ($step -eq 2) { break }
    $step
}
'終了時: ' + $step

実行結果

1
終了時: 2

1つ目は2の表示だけを省き、1、3、4に続いて「終了時: 4」が出ます。continueの後も反復が続くので、終了時の値は2ではありません。コード欄の末尾にある出力行まで含めて実行します。

2つ目は2に達した時点でループを終えるため、1に続いて「終了時: 2」が出ます。表の「終了時のstep」は、分岐した瞬間ではなく、それぞれのコード欄全体が終わった時点の値です。

2つの条件を組み合わせたら、変わる値を探す

-andで結ぶ条件は、片方が偽になれば全体も偽になります。

-andは、両方の条件が真のときだけ真になる記号です。次の例では、回数が5未満であることと、変数$keepGoingが真であることを組み合わせます。このような状態を表す目印をフラグと呼びます。

$keepGoingは最初に真にして、2を表示した回で偽へ変えます。次の判定では回数が5未満でも、フラグが偽なので終了します。条件ごとの丸括弧は、どこまでをひとまとまりとして読むかを示しています。

2つの継続条件のうち片方が偽になれば止まる

$step = 0
$keepGoing = $true
while (($step -lt 5) -and $keepGoing) {
    $step++
    $step
    if ($step -eq 2) { $keepGoing = $false }
}
'終了時: ' + $step

実行結果

1
2
終了時: 2

1と2に続いて「終了時: 2」が出れば想定どおりです。今回は回数の上限ではなく、フラグの変化が終了の理由です。フラグは名前を付けただけでは変わらないため、最初に値を入れる行と、途中で変える行の両方を確認します。

上限付きの確認は、成功と上限到達を分ける

ループが終わった理由を、成功した場合と回数の上限に達した場合に分けて表示します。

次の2例は、状態を順に確認する流れを固定した文字列で再現します。配列は、複数の値を順序付きでまとめたものです。コードでは@と丸括弧を組み合わせ、値をカンマで区切って並べています。

$attemptは確認済み回数、$maxAttemptsは最大回数、$successは成功したかを表すフラグです。-notは真偽を反転する記号で、今回は3回未満かつ未成功の間だけ本体へ進みます。

配列の後の角括弧には、取り出す位置を指定します。先頭の番号は0です。確認済み回数が0なら先頭を読み、読み取った後に回数を1増やします。今回の配列は、どちらも上限と同じ3要素です。

読み取った状態が「準備完了」なら、成功のフラグを真にします。ループ後のifで成功かを判断し、偽ならelse側の上限到達を表示します。各コード欄は、末尾のelse側の表示まで含めて実行します。

固定データで成功した時点と試行回数を確かめる

$states = @('待機', '準備完了', '準備完了')
$attempt = 0
$maxAttempts = 3
$success = $false
while (($attempt -lt $maxAttempts) -and (-not $success)) {
    $state = $states[$attempt]
    $attempt++
    '確認' + $attempt + ': ' + $state
    $success = ($state -eq '準備完了')
}
if ($success) { '成功: ' + $attempt + '回' }
else { '上限到達: ' + $attempt + '回' }

実行結果

確認1: 待機
確認2: 準備完了
成功: 2回

全て待機の固定データなら3回で上限に達する

$states = @('待機', '待機', '待機')
$attempt = 0
$maxAttempts = 3
$success = $false
while (($attempt -lt $maxAttempts) -and (-not $success)) {
    $state = $states[$attempt]
    $attempt++
    '確認' + $attempt + ': ' + $state
    $success = ($state -eq '準備完了')
}
if ($success) { '成功: ' + $attempt + '回' }
else { '上限到達: ' + $attempt + '回' }

実行結果

確認1: 待機
確認2: 待機
確認3: 待機
上限到達: 3回

1つ目は「確認1: 待機」「確認2: 準備完了」に続いて、「成功: 2回」が出ます。成功のフラグが真になったため、3つ目の要素は読みません。上限の3回まで続くわけではありません。

2つ目は全て待機なので、確認が3回続き、最後は「上限到達: 3回」です。処理が終了したことだけで成功とは判断せず、最後の表示で終了理由を確かめます。

これは実在サービスへの監視や再試行の実行記録ではありません。回数の上限は、1回の処理にかかる時間を制限しません。外部処理では待機間隔・期限・失敗理由も別に検討し、書込みの成否が不明なまま再送しないでください。

空行を残すには、空文字と読み取りの終端を分ける

空行は読み終わりではありません。終端を表す$nullと比較して判定します。

行ごとの読み取りでは、文字が0個の空文字と、値がないことを表す$nullを区別します。読み取った文字列だけを継続条件にすると、空文字が偽として扱われ、途中の空行で止まってしまいます。

ここでは、Windows PowerShellの基盤である.NETのStringReaderを使います。実行中のデータを置く領域をメモリと呼び、この例はメモリ上の文章を読み取るため、実ファイルの準備は不要です。

コード先頭の型名は読み取り器の種類を示し、::newはそれを作る指定です。二重引用符内のバッククォートとnの組合せが改行を表し、開始と完了の間に空行を1つ入れています。

tryには読み取り処理を、finallyには片付けを置いています。最後のDispose()は、使い終えた読み取り器の利用を終了する処理です。finallyの閉じる波括弧まで含め、コード欄全体を実行します。

空行と読み取りの終端を区別する

$reader = [System.IO.StringReader]::new("開始`n`n完了")
try {
    while ($null -ne ($line = $reader.ReadLine())) {
        '[' + $line + ']'
    }
} finally {
    $reader.Dispose()
}

実行結果

[開始]
[]
[完了]

ReadLine()は次の行を返し、終端では$nullを返します。条件の内側の丸括弧で結果を変数$lineへ入れ、-neで$nullと異なるかを調べています。空文字は$nullと異なるため、本体へ進みます。

結果は「[開始]」「[]」「[完了]」の3行です。中央の「[]」が空行を保持した印で、角括弧は出力を見やすくするために付けた文字です。実ファイルの権限・文字コード・大容量時の動作は、この例の確認範囲に含みません。

入れ子のbreakは、最も内側のwhileを止める

ラベルのないbreakで内側を止めても、外側のループは続きます。

入れ子とは、ループの中に別のループを置くことです。次の例では$outerが外側、$innerが内側の回数を表します。外側は1と2の2回動き、そのたびに内側の回数を0へ戻します。

内側では1を表示した後、2に達したところでbreakへ進みます。停止先に付ける名前をラベルと呼びますが、この例では指定していません。そのため最も内側だけが終了し、外側の更新と次の反復は続きます。

ラベルのないbreakは内側のwhileだけを終了する

$outer = 1
while ($outer -le 2) {
    $inner = 0
    while ($inner -lt 3) {
        $inner++
        if ($inner -eq 2) { break }
        '外' + $outer + ' 内' + $inner
    }
    $outer++
}

実行結果

外1 内1
外2 内1

「外1 内1」「外2 内1」の2行が出れば想定どおりです。内側の2は表示されず、外側の2回目は表示されることから、止まった範囲を確認できます。ラベル付きbreakやループ外でのbreakは、今回の例では扱いません。

症状に合わせて、開始値・更新・終了理由を確認する

表示された値と、条件を調べた時点の値は一致するとは限りません。まず開始値から最初の判定を追い、本体で何が変わるか、continueやbreakでどの行を飛ばすかを順に確認します。

途中の表示だけで判断せず、コード欄末尾の出力まで比べます。基本例では3を表示した後に4へ更新して終わり、上限付きの例では成功と上限到達で表示が変わります。終了した理由まで説明できるかが確認の目安です。

  • 何も出ない場合:開始値と比較記号を確認し、最初から条件が偽になっていないかを調べます。
  • 止まらない場合:Ctrl+Cで中断し、更新漏れ、増減する方向、continueが飛ばす行を確認します。
  • 成功表示が出ない場合:成功条件と回数上限を別々に確認し、上限内に成功の状態へ到達できるかを調べます。
  • 空行で読み取りが終わる場合:空文字を終端として扱っていないか、$nullとの比較を確認します。
  • 入れ子全体が止まらない場合:breakの対象が最も内側のループであることを踏まえ、内側と外側の出力を分けて確認します。

判断に迷う場合は、1から3を表示する基本例と比較表へ戻り、判定・本体・更新の順を追ってください。この10例が示すのは固定した小さなデータの動作であり、本番サービスの監視設計や構文ごとの速度の優劣ではありません。