about_Foreach

Rövid leírás

Egy nyelvi parancsot ír le, a segítségével az elemek gyűjteményének összes elemét bejárásra használhatja.

Hosszú leírás

Az foreach utasítás egy olyan nyelvi szerkezet, amely egy gyűjtemény értékeinek egy halmazán keresztüli iterálást teszi szükségessé.

A legegyszerűbb és legjellemzőbb gyűjteménytípus egy tömb. foreach Egy cikluson belül gyakori, hogy egy tömb minden elemén futtat egy vagy több parancsot.

Syntax

Az alábbiakban a szintaxis látható foreach :

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

Az utasítás zárójelen foreach belüli része egy változót és egy iterátumot tartalmazó gyűjteményt jelöl. A PowerShell automatikusan létrehozza a változót $<item> a foreach ciklus futtatásakor. Az egyes iterációk foreach elején az elemváltozót a gyűjtemény következő értékére állítja. A {<statement list>} blokk tartalmazza az egyes iterációkhoz végrehajtandó parancsokat.

Példák

Az alábbi példában látható hurok például foreach a tömb értékeit $letterArray jeleníti meg.

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

Ebben a példában a $letterArray sztringértékek a, b, cés d. Az utasítás első futtatásakor foreach a változó értéke megegyezik a $letter ()a elem első elemével $letterArray . Ezután megjeleníti Write-Host az értéket. A következő alkalommal a cikluson $letter keresztül a következő értékre bvan állítva. A minta megismétli a tömb minden elemét.

Olyan parancsmagokkal rendelkező utasításokat is használhat foreach , amelyek egy elemgyűjteményt adnak vissza. Az alábbi példában az foreach utasítás végigvezeti a parancsmag által visszaadott elemek listáján Get-ChildItem .

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

A visszaküldött eredmények korlátozásához pontosíthatja a példát egy if utasítással. Az alábbi példában az if utasítás 100 kilobájtnál (KB) nagyobb fájlokra korlátozza az eredményeket:

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

Ebben a példában a hurok a foreach$file változó tulajdonságát használja egy összehasonlító művelet végrehajtásához ($file.length -gt 100KB). A $file változó az objektum minden tulajdonságával rendelkezik, amelyet a függvény visszaadott Get-ChildItem.

A következő példában a szkript megjeleníti a hosszt és az utolsó hozzáférési időt az utasításlistában:

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

A cikluson kívüli foreach változókat is használhatja. Az alábbi példa 100 KB-nál nagyobb méretű fájlokat számol:

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

Az előző példában $i a cikluson kívüli értékkel 0 kezdődik. $i Ezután a rendszer a cikluson belül növekszik minden 100 KB-nál nagyobb fájl esetében. Amikor a hurok kilép, egy if utasítás kiértékeli $i , hogy hány fájl jelenjen meg 100 KB-nál nagyobb számban.

Az előző példa azt is bemutatja, hogyan formázhatja a fájlhossz-eredményeket:

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

Az érték 1024-zel van osztva, hogy az eredményeket bájt helyett kilobájtban jelenítse meg, majd az eredményként kapott értéket a rögzítettpontos formátumkijelölővel formázza, hogy eltávolítsa az eredményből a decimális értékeket. A 0 formátumkijelölő nem jelenít meg tizedesjegyeket.

Az alábbi függvény elemzi a PowerShell-szkripteket és a szkriptmodulokat, és visszaadja a benne található függvények helyét. A példa bemutatja, hogyan használhatja a MoveNext metódust és a Current$foreach változó tulajdonságát egy foreach szkriptblokkon belül.

További információ: Enumerátorok használata.

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

Lásd még