about_Foreach

  • [アーティクル]

簡単な説明

項目のコレクション内のすべての項目を走査するために使用できる言語コマンドについて説明します。

詳細な説明

ステートメントは foreach 、コレクション内の一連の値を反復処理するための言語コンストラクトです。

走査するコレクションの最も単純で最も一般的な型は配列です。 foreachループ内では、配列内の各項目に対して 1 つ以上のコマンドを実行するのが一般的です。

構文

構文を次に foreach 示します。

foreach ($<item> in $<collection>){<statement list>}

かっこ内のステートメントの foreach 部分は、反復処理する変数とコレクションを表します。 PowerShell は、ループの実行時に変数 $<item> を自動的に foreach 作成します。 各イテレーションの開始時に、 foreach 項目変数をコレクション内の次の値に設定します。 この {<statement list>} ブロックには、イテレーションごとに実行するコマンドが含まれています。

例

たとえば、次の foreach 例のループは配列内の値を $letterArray 表示します。

$letterArray = 'a','b','c','d'
foreach ($letter in $letterArray)
{
  Write-Host $letter
}

この例では、 $letterArray 文字列値 a、 b、、 cおよび d. ステートメントをforeach初めて実行する場合、変数は (a) 内の最初の項目と同じ値に$letterArray設定$letterされます。 次に、値を表示するために使用 Write-Host します。 次にループを通過する場合は、 $letter 次に b. パターンは、配列内の各項目に対して繰り返されます。

項目のコレクションを返すコマンドレットでステートメントを使用 foreach することもできます。 次の例では、ステートメントは foreach コマンドレットによって返される項目の一覧をステップ実行 Get-ChildItem します。

foreach ($file in Get-ChildItem)
{
  Write-Host $file
}

ステートメントを使用して例を if 絞り込んで、返される結果を制限できます。 次の例では、ステートメントによってif結果が 100 KB (KB (キロバイト)) を超えるファイルに制限されています。

foreach ($file in Get-ChildItem)
{
  if ($file.Length -gt 100KB)
  {
    Write-Host $file
  }
}

この例では、ループは foreach 変数のプロパティを $file 使用して比較操作 ($file.length -gt 100KB) を実行します。 変数 $file には、 Get-ChildItem.

次の例では、ステートメント リスト内の長さと最後のアクセス時刻がスクリプトに表示されます。

foreach ($file in Get-ChildItem)
{
  if ($file.Length -gt 100KB)
  {
    Write-Host $file
    Write-Host $file.Length
    Write-Host $file.LastAccessTime
  }
}

ループの外部から変数を foreach 使用することもできます。 次の例では、サイズが 100 KB (キロバイト)を超えるファイルをカウントします。

$i = 0
foreach ($file in Get-ChildItem) {
  if ($file.length -gt 100KB) {
    Write-Host $file 'file size:' ($file.length / 1024).ToString('F0') KB
    $i = $i + 1
  }
}

if ($i -ne 0) {
  Write-Host
  Write-Host $i ' file(s) over 100KB in the current directory.'
}
else {
  Write-Host 'No files greater than 100KB in the current directory.'
}

前の例では、 $i ループの外側の 0 値で始まります。 次に、 $i 100 を超えるファイルごとにループ内でインクリメントKB (キロバイト)。 ループが終了すると、ステートメントによってif値$iが評価され、100 を超えるファイル数が表示KB (キロバイト)。

前の例では、ファイルの長さの結果を書式設定する方法も示しています。

($file.length / 1024).ToString('F0')

値は 1,024 で除算され、結果はバイトではなくキロバイト単位で表示され、結果の値は固定小数点書式指定子を使用して書式設定され、結果から 10 進値が削除されます。 書式 0 指定子に小数点以下の桁数が表示されません。

次の関数は、PowerShell スクリプトとスクリプト モジュールを解析し、その中に含まれる関数の場所を返します。 この例では、スクリプト ブロック内で MoveNext 変数のメソッドと Current プロパティを使用する $foreach 方法を foreach 示します。

詳細については、「列挙子の使用」を参照してください。

function Get-FunctionPosition {
  [CmdletBinding()]
  [OutputType('FunctionPosition')]
  param(
    [Parameter(Position = 0, Mandatory,
      ValueFromPipeline, ValueFromPipelineByPropertyName)]
    [ValidateNotNullOrEmpty()]
    [Alias('PSPath')]
    [System.String[]]
    $Path
  )

  process {
    try {
      $filesToProcess = if ($_ -is [System.IO.FileSystemInfo]) {
        $_
      } else {
        Get-Item -Path $Path
      }
      $parser = [System.Management.Automation.Language.Parser]
      foreach ($item in $filesToProcess) {
        if ($item.PSIsContainer -or
            $item.Extension -notin @('.ps1', '.psm1')) {
          continue
        }
        $tokens = $errors = $null
        $ast = $parser::ParseFile($item.FullName, ([ref]$tokens),
          ([ref]$errors))
        if ($errors) {
          $msg = "File '{0}' has {1} parser errors." -f $item.FullName,
            $errors.Count
          Write-Warning $msg
        }
        :tokenLoop foreach ($token in $tokens) {
          if ($token.Kind -ne 'Function') {
            continue
          }
          $position = $token.Extent.StartLineNumber
          do {
            if (-not $foreach.MoveNext()) {
              break tokenLoop
            }
            $token = $foreach.Current
          } until ($token.Kind -in @('Generic', 'Identifier'))
          $functionPosition = [pscustomobject]@{
            Name       = $token.Text
            LineNumber = $position
            Path       = $item.FullName
          }
          $addMemberSplat = @{
              InputObject = $functionPosition
              TypeName = 'FunctionPosition'
              PassThru = $true
          }
          Add-Member @addMemberSplat
        }
      }
    }
    catch {
      throw
    }
  }
}

関連項目