다음을 통해 공유


about_Foreach

간단한 설명

항목 컬렉션의 모든 항목을 트래버스하는 데 사용할 수 있는 언어 명령에 대해 설명합니다.

자세한 설명

foreach 문은 컬렉션의 값 집합을 반복하기 위한 언어 구문입니다.

트래버스할 가장 간단하고 일반적인 컬렉션 형식은 배열입니다. foreach 루프 내에서 배열의 각 항목에 대해 하나 이상의 명령을 실행하는 것이 일반적입니다.

구문

다음은 구문을 보여줍니다 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, cd.를 포함합니다. 문이 처음 foreach 실행되면 변수가 $letter (a)의 첫 번째 항목과 $letterArray 동일하게 설정됩니다. 그런 다음 값을 표시하는 데 사용합니다 Write-Host . 루프를 통해 다음에는 $letter .로 설정됩니다 b. 배열의 각 항목에 대해 패턴이 반복됩니다.

항목 컬렉션을 반환하는 cmdlet과 함께 문을 사용할 foreach 수도 있습니다. 다음 예제에서 문은 foreach cmdlet에서 반환된 Get-ChildItem 항목 목록을 단계별로 안내합니다.

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

문을 사용하여 예제를 if 구체화하여 반환되는 결과를 제한할 수 있습니다. 다음 예제 if 에서 이 문은 결과를 100KB(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 변수를 사용할 수도 있습니다. 다음 예제에서는 크기가 100KB를 초과하는 파일을 계산합니다.

$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 그런 다음 100KB보다 큰 각 파일에 대한 루프 내에서 증가합니다. 루프가 종료되면 문은 if 100KB를 넘는 파일 수를 표시하는 값을 $i 평가합니다.

이전 예제에서는 파일 길이 결과의 서식을 지정하는 방법도 보여 줍니다.

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

값은 바이트가 아닌 킬로바이트 단위로 결과를 표시하기 위해 1,024로 나뉘며 결과 값은 결과에서 소수점 값을 제거하기 위해 고정 소수점 형식 지정자를 사용하여 형식이 지정됩니다. 0 형식 지정자에 소수 자릿수가 표시되지 않습니다.

다음 함수는 PowerShell 스크립트 및 스크립트 모듈을 구문 분석하고 포함된 함수의 위치를 반환합니다. 이 예제에서는 스크립트 블록 내에서 foreach 변수의 $foreach 메서드 및 Current 속성을 사용하는 MoveNext 방법을 보여 줍니다.

자세한 내용은 열거자 사용을 참조 하세요.

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

참고 항목