about_Foreach
簡単な説明
項目のコレクション内のすべての項目を走査するために使用できる言語コマンドについて説明します。
長い説明
foreach
ステートメント (ループとも呼ばれますforeach
) は、項目のコレクション内の一連の値をステップ実行 (反復処理) するための言語コンストラクトです。
走査するコレクションの最も単純で最も一般的な型は配列です。
foreach
ループ内では、配列内の各項目に対して 1 つ以上のコマンドを実行するのが一般的です。
構文
構文を次に foreach
示します。
foreach ($<item> in $<collection>){<statement list>}
かっこで囲まれたステートメントの foreach
部分は、反復処理する変数とコレクションを表します。 PowerShell は、ループの実行時に変数 $<item>
を自動的に foreach
作成します。 ループを繰り返すたびに、変数はコレクション内の値に設定されます。
ステートメント{<statement list>}
の後のforeach
ブロックには、コレクション内の各項目に対して実行する一連のコマンドが含まれています。
例
たとえば、次の foreach
例のループは、配列内の値を $letterArray
表示します。
$letterArray = "a","b","c","d"
foreach ($letter in $letterArray)
{
Write-Host $letter
}
この例では、配列が作成され、$letterArray
文字列値"a"
、"b"
、および "c"
"d"
. ステートメントをforeach
初めて実行するときに、("a"
) の最初の$letter
項目$letterArray
と同じ変数を設定します。 次に、コマンドレットを Write-Host
使用して文字 a を表示します。 次にループを通過するときに、 $letter
次に設定されます "b"
。 ループに foreach
文字 d が表示された後、PowerShell はループを終了します。
foreach
ステートメントは、項目のコレクションを返すコマンドレットと共に使用することもできます。 次の例では、Foreach ステートメントは、コマンドレットによって返される項目の一覧を Get-ChildItem
ステップ実行します。
foreach ($file in Get-ChildItem)
{
Write-Host $file
}
ステートメントを使用して、返される結果を if
制限することで、例を絞り込むことができます。 次の例では、 foreach
ステートメントは前の例と同じループ操作を実行しますが、結果を 100 KB (KB) より大きいファイルに制限するステートメントを追加 if
します。
foreach ($file in Get-ChildItem)
{
if ($file.length -gt 100KB)
{
Write-Host $file
}
}
この例では、ループは foreach
変数のプロパティを $file
使用して比較操作 ($file.length -gt 100KB
) を実行します。 この $file
変数には、コマンドレットによって返されるオブジェクト内のすべてのプロパティが Get-ChildItem
含まれます。 したがって、単なるファイル名以上のものを返すことができます。
次の例では、PowerShell はステートメント リスト内の長さと最後のアクセス時刻を返します。
foreach ($file in Get-ChildItem)
{
if ($file.length -gt 100KB)
{
Write-Host $file
Write-Host $file.length
Write-Host $file.lastaccesstime
}
}
この例では、ステートメント リストで 1 つのコマンドを実行する方法に限定されません。
また、ループの外側で変数を 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 100 KB in the current directory."
}
else {
Write-Host "No files greater than 100 KB in the current directory."
}
前の例では、 $i
変数はループの外側に 0
設定され、100 KB を超えるファイルが検出されるたびに、ループ内で変数がインクリメントされます。 ループが終了すると、 if
ステートメントは値 $i
を評価して、100 KB を超えるすべてのファイルの数を表示します。 または、100 KB を超えるファイルが見つからなかったことを示すメッセージが表示されます。
前の例では、ファイルの長さの結果を書式設定する方法も示しています。
($file.length / 1024).ToString("F0")
値を 1,024 で割って結果をバイトではなくキロバイト単位で表示し、結果の値は固定小数点書式指定子を使用して書式設定され、結果から 10 進値が削除されます。 0 を指定すると、書式指定子に小数点以下の桁数が表示されません。
次の例では、定義された関数は PowerShell スクリプトとスクリプト モジュールを解析し、その中に含まれる関数の場所を返します。 この例では、メソッド (ループでも同様にskip X
For
動作します) とCurrent
、foreach スクリプト ブロック内の変数の$foreach
プロパティを使用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
}
Add-Member -InputObject $functionPosition `
-TypeName FunctionPosition -PassThru
}
}
}
catch {
throw
}
}
}
こちらもご覧ください
PowerShell
A cross-platform task automation solution made up of a command-line shell and a scripting language.
フィードバック
フィードバックの送信と表示