【PowerShell】配列とハッシュテーブルの使い方｜宣言・追加・ループ・連想配列・並び替え

# カンマ区切りで作る
$fruits = "りんご", "みかん", "ぶどう"

# @() で囲む（意図が明確・要素1個や0個でも確実に配列になる）
$fruits = @("りんご", "みかん", "ぶどう")

# 空の配列
$empty = @()

# 連続した数値は範囲演算子で
$numbers = 1..5   # 1,2,3,4,5

# 型を固定した配列（数値以外を入れるとエラー）
[int[]]$ids = 1, 2, 3

$fruits = @("りんご", "みかん", "ぶどう")

$fruits[0]    # りんご（最初）
$fruits[-1]   # ぶどう（最後）
$fruits[0..1] # りんご, みかん（範囲で取得）

$fruits.Count  # 3（要素数）
$fruits.Length # 3（Count と同じ）

$list = @(1, 2, 3)
$list += 4   # 見た目は追加だが、内部では新しい配列を作っている
# $list は 1,2,3,4

# 数十件程度なら問題ないが、数万回のループでは極端に遅くなる

# 可変長リスト（追加が速い）
$list = [System.Collections.Generic.List[object]]::new()

$list.Add("a")
$list.Add("b")
$list.Add("c")

$list.Count        # 3
$list.Remove("b")  # 値を削除（True を返す）
$list[0]           # a（配列と同じようにアクセスできる）

$fruits = @("りんご", "みかん", "ぶどう")

# foreach 文（最も読みやすい）
foreach ($fruit in $fruits) {
    Write-Host $fruit
}

# ForEach-Object（パイプラインの中で使う。$_ が現在の要素）
$fruits | ForEach-Object { Write-Host $_ }

# for 文（インデックスが必要なとき）
for ($i = 0; $i -lt $fruits.Count; $i++) {
    Write-Host "$i : $($fruits[$i])"
}

$numbers = 1..10

# 含まれているかの判定
$numbers -contains 5   # True
5 -in $numbers         # True（-contains と向きが逆）

# 条件で絞り込む
$numbers | Where-Object { $_ -gt 7 }   # 8, 9, 10
$numbers.Where({ $_ % 2 -eq 0 })        # 2,4,6,8,10（メソッド構文）

# 並び替え・重複除去
3, 1, 2, 1 | Sort-Object            # 1,1,2,3
3, 1, 2, 1 | Sort-Object -Unique   # 1,2,3（重複を除く）
$numbers | Sort-Object -Descending # 降順

# 結果が1件だと配列ではなく単一の値（スカラー）になる
$one = (1..5 | Where-Object { $_ -eq 3 })
$one.GetType().Name   # Int32（配列ではない）

# 結果が0件だと $null になる
$none = (1..5 | Where-Object { $_ -gt 99 })
$null -eq $none       # True

# @() で囲めば、常に配列として扱える
@($one).GetType().Name  # Object[]
@($none).Count          # 0（null でも安全に数えられる）
@($one).Count           # 1

# キー = 値 のペアで作る（; で区切る）
$user = @{
    Name = "山田"
    Age  = 30
    City = "東京"
}

# 空のハッシュテーブル
$config = @{}

# 値の読み出し（2通り）
$user.Name      # 山田（ドット記法）
$user["Age"]    # 30（角かっこ記法）

$user.Count            # 3（ペアの数）
$user.ContainsKey("Name")  # True

$user = @{ Name = "山田"; Age = 30 }

# 追加も更新も [キー] = 値 でOK（安全）
$user["City"] = "東京"  # 新規追加
$user["Age"]  = 31      # 既存を更新

# 削除
$user.Remove("Name")

# .Add() は「新規追加専用」。既存キーに使うと例外になる
$user.Add("Country", "日本")  # OK（新規）
# $user.Add("Country", "米国")  # 既にあるキーなので例外

$user = @{ Name = "山田"; Age = 30; City = "東京" }

# キーを回して値を引く
foreach ($key in $user.Keys) {
    Write-Host "$key : $($user[$key])"
}

# GetEnumerator でキーと値を同時に取り出す
$user.GetEnumerator() | ForEach-Object {
    Write-Host "$($_.Key) = $($_.Value)"
}

$user.Keys    # キーの一覧
$user.Values  # 値の一覧

# 通常のハッシュテーブルは順序が不定
$normal = @{ z = 1; a = 2; m = 3 }

# [ordered] を付けると、書いた順（z, a, m）を保つ
$ordered = [ordered]@{
    z = 1
    a = 2
    m = 3
}

$ordered.Keys  # z, a, m の順で取り出せる

$words = "a", "b", "a", "c", "a", "b"
$counts = @{}

foreach ($w in $words) {
    if ($counts.ContainsKey($w)) {
        $counts[$w]++      # あれば1増やす
    } else {
        $counts[$w] = 1    # なければ初期化
    }
}

# 結果: a=3, b=2, c=1
$counts.GetEnumerator() | Sort-Object Value -Descending |
    ForEach-Object { "$($_.Key) : $($_.Value)" }

# パラメータをハッシュテーブルにまとめる
$params = @{
    Path        = "C:\work"
    Filter      = "*.txt"
    Recurse     = $true
    ErrorAction = "SilentlyContinue"
}

# @ を付けて渡す（$params ではなく @params）
Get-ChildItem @params

# 同じことを1行で書くと長くなる
# Get-ChildItem -Path "C:\work" -Filter "*.txt" -Recurse -ErrorAction SilentlyContinue