Sdílet prostřednictvím

about_Foreach

  • Článek

Krátký popis

Popisuje příkaz jazyka, který můžete použít k procházení všech položek v kolekci položek.

Dlouhý popis

Příkaz foreach je jazykový konstruktor pro iteraci sady hodnot v kolekci.

Nejjednodušším a nejtypičtějším typem kolekce, která se má procházet, je pole. foreach Ve smyčce je běžné spouštět jeden nebo více příkazů pro každou položku v poli.

Syntaxe

Syntaxe je znázorněná takto foreach :

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

Část foreach příkazu uvnitř závorek představuje proměnnou a kolekci pro iteraci. PowerShell vytvoří proměnnou $<item> automaticky při spuštění smyčky foreach . Na začátku každé iterace foreach nastaví proměnnou položky na další hodnotu v kolekci. Blok {<statement list>} obsahuje příkazy, které se mají provést pro každou iteraci.

Příklady

Například smyčka foreach v následujícím příkladu $letterArray zobrazí hodnoty v poli.

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

V tomto příkladu $letterArray obsahuje řetězcové hodnoty a, b, ca d. Při prvním foreach spuštění příkazu nastaví $letter proměnnou, která se rovná první položce ($letterArraya). Pak se použije Write-Host k zobrazení hodnoty. Při dalším procházení smyčky $letter je nastavena na bhodnotu . Vzor se opakuje pro každou položku v poli.

Příkazy můžete použít foreach také s rutinami, které vracejí kolekci položek. V následujícím příkladu foreach příkaz prochází seznam položek vrácených rutinou Get-ChildItem .

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

Příklad můžete upřesnit pomocí if příkazu, abyste omezili vrácené výsledky. V následujícím příkladu if příkaz omezuje výsledky na soubory, které jsou větší než 100 kilobajtů (KB):

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

V tomto příkladu smyčka foreach používá vlastnost $file proměnné k provedení operace porovnání ($file.length -gt 100KB). Proměnná $file má všechny vlastnosti objektu vráceného objektem Get-ChildItem.

V dalším příkladu skript zobrazí délku a čas posledního přístupu v seznamu příkazů:

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

Můžete také použít proměnné z vnější foreach smyčky. Následující příklad počítá soubory o velikosti větší než 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.'
}

V předchozím příkladu $i začíná hodnotou 0 mimo smyčku. $i Potom se zvýší uvnitř smyčky pro každý soubor, který je větší než 100 kB. Když smyčka skončí, if příkaz vyhodnotí hodnotu $i zobrazení počtu souborů nad 100 kB.

Předchozí příklad také ukazuje, jak formátovat výsledky délky souboru:

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

Hodnota je vydělena hodnotou 1 024, aby se zobrazily výsledky v kilobajtech, nikoli bajtech, a výsledná hodnota se pak naformátuje pomocí specifikátoru formátu s pevným bodem, který z výsledku odebere všechny desetinné hodnoty. Specifikátor 0 formátu nezobrazuje žádná desetinná místa.

Následující funkce parsuje skripty PowerShellu a moduly skriptů a vrací umístění funkcí obsažených v této funkci. Příklad ukazuje, jak použít metodu MoveNext a Current vlastnost $foreach proměnné uvnitř foreach bloku skriptu.

Další informace naleznete v tématu Použití enumerátorů.

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

Viz také