上司

最近ToDoリストがエラーを出して動かなくなるんだけど…

猫道

必要なファイル配置してますか？

上司

そんなこと言われても、エラーメッセージがよくわからないよ！

猫道

自分で読めよ…

PowerShellでのエラーハンドリングの基礎

PowerShellにおけるエラーハンドリングは、予期しないエラーや予測できるエラーを適切に取り扱うための重要な技術です。

基本的には、エラーが発生する可能性のあるコードブロックをTryブロックで囲み、エラーが発生した際の処理をCatchブロックで記述します。さらに、エラーの有無に関係なく最後に実行する処理はFinallyブロック内に記述します。また、予測できるエラーについては個別に取り扱います。

予測できるエラーの取り扱い

予測できるエラーは、特定の条件を満たさない場合にエラーとして扱うことができます。例として、ファイルが存在しない場合にエラーとする場合のコードを考えてみましょう。

if (-not (Test-Path "C:\path\to\file.txt")) {
    throw "ファイルが存在しません！"
}

このコードは、指定されたパスにファイルが存在しない場合、エラーメッセージをスローします。

Try、Catch、Finallyの使用

エラーの発生を想定するブロックをTry内に記述し、エラーが発生した場合の処理をCatch内で記述します。最後にFinallyブロックで、エラーの有無にかかわらず実行する処理を記述します。

Try {
    # エラーが発生する可能性のある処理
    $content = Get-Content "C:\path\to\file.txt"
}
Catch {
    # エラーが発生した際の処理
    Write-Host "エラーが発生しました: $($_.Exception.Message)"
}
Finally {
    # 最終的な処理
    Write-Host "処理が完了しました"
}

このコードでは、Get-Contentコマンドレットで指定されたパスのファイルを読み込む際にエラーが発生する可能性を考慮しています。エラーが発生した場合、Catchブロックでエラーメッセージを表示し、最後にFinallyブロックで”処理が完了しました”というメッセージを表示します。

Finallyは任意で、Try～Catch句でも使用できます。

ToDoリストにエラーハンドリングを導入するステップ

ToDoリストの管理には、エラーが発生する様々なシチュエーションが考えられます。それを適切に処理するための手順を以下に示します。

ステップ1: 入力値の検証

ユーザーからの入力値が予期しないものであることがエラーの大きな原因です。具体的には、以下のような場面でのエラーハンドリングが考えられます。

1. タスクの名前が空であるか、過度に長い場合
2. 削除するタスクの番号が範囲外である場合

例えば、AddTask関数でタスクの名前が空でないかを確認する処理を追加することができます。

function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    #タスク名が空、または、100文字以上
    if (-not $task or $task.Length -gt 100) {
        Write-Host "タスク名が不正です。タスク名を入力してください。"
        #処理を抜ける
        return
    }
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

猫道

2.については既に取り込んでいるよ。

ステップ2: ファイル操作時のエラー処理

ファイルの読み書きはエラーが発生しやすい操作の一つです。以下の点を注意してハンドリングします。

1. ファイルが存在しない場合
2. ファイルの読み書きに失敗した場合

上記1.を考慮し、ファイルを読み込む前にファイルの存在チェック処理を追加します。
処理を止めることも出来ますが、ここでは新規ファイルを作成し処理を続行する作りとします。
上記2.についてはステップ3でまとめて取り扱うことにします。

# ファイル存在チェック
if (-not (Test-Path $tasksFile)) {
    #新規ファイル作成
    #$nullについて 作成結果を画面に出力しないようにする
    New-Item $tasksFile -ErrorAction Stop >$null
}

ステップ3: その他の一般的なエラーの処理

一般的なエラーの処理として、未知のエラーや特定できないエラーが発生した場合のハンドリングが考えられます。これには、全体的なエラーハンドリングを実装する方法が考えられます。例として、メインのメニュー部分にTry-Catchを適用することで、どの操作を選択してもエラーが発生した場合の処理を一元的に行うことができます。

Try {
    #処理全般
} Catch {
    #エラーメッセージ出力
    Write-Host "予期せぬエラーが発生しました: $($_.Exception.Message)"
}

これにより、エラーが発生した場合には該当するエラーメッセージをユーザーに表示し、プログラムの安定性を向上させることができます。

ステップ4: その他の考慮

ログ出力の追加

開始/終了のメッセージやエラーメッセージをログ出力することで、ログを送付してもらうだけで処理がどこまで動いたか、どのようなエラーが出力されたか等、ある程度の判断が出来るようになります。
ここでは予期せぬエラーが発生した場合のログ出力処理を追加します。

ToDoList.ps1

#ログファイル設定追加
    # ログファイル設定
    $logFile = "$commonPath\log\log.txt"
    

#Catch処理にログ出力追加
} Catch {
    #エラーメッセージ出力
    Write-Host "予期せぬエラーが発生しました: $($_.Exception.Message)"
    
    #ログファイル出力(-Appendは追記モード。echoは表示コマンド)
    echo "予期せぬエラーが発生しました: $($_.Exception.Message)" | Out-File -Append $logFile
}

ログの出力先フォルダを追加します。

待機処理の追加

エラー発生時に画面が一瞬で閉じられてしまうため、batファイルに待機処理を追加します。

ToDoList.bat

@echo off
powershell.exe -ExecutionPolicy RemoteSigned "%~dp0bin\ToDoList.ps1"

pause

エラーハンドリング後のToDoリストの動作確認

エラーハンドリングを導入した後のToDoリストの動作を確認することで、ユーザーが遭遇する様々なエラーシチュエーションでのアプリケーションの挙動を把握することができます。

確認シナリオ1: タスク名の入力

操作: タスク追加を選択し、空のタスク名を入力

期待する動作: “タスク名が不正です。タスク名を入力してください。”というメッセージが表示され、タスクは追加されない。

確認シナリオ2: ファイルの存在チェック

操作: タスクの読み込みを選択する前に、タスクデータを保存しているファイルを削除

期待する動作: 新規のファイルが作成されて処理が続行される。

確認シナリオ3: 不明なエラー

操作: アプリケーション内で未予測のエラーを意図的に発生させる (例: 「data」フォルダのファイル名を変更する等)

期待する動作: “予期せぬエラーが発生しました: [エラーメッセージ]”というメッセージが表示される。

上司

これなら私にもなんとなく分かるよ。

猫道

よかったです！解決出来ない時はログファイルを送ってくださいね。

ソースコード（完成版）

完成したソースコードを記載します。

ToDoList.bat

@echo off
powershell.exe -ExecutionPolicy RemoteSigned "%~dp0bin\ToDoList.ps1"

pause

ToDoList.ps1

Try {
    
    # 共通のパスの設定
    $commonPath = "$PSScriptRoot\.."
    
    # tasksファイル設定
    $tasksFile = "$commonPath\data\tasks.txt"
    
    # ログファイル設定
    $logFile = "$commonPath\log\log.txt"
    
    # タスクの配列を宣言
    $tasks = @()
    
    # ファイル存在チェック
    if (-not (Test-Path $tasksFile)) {
        #新規ファイル作成
        New-Item $tasksFile -ErrorAction Stop >$null
    }
    
    # ファイル読み込み
    $tasks += Get-Content $tasksFile
    Write-Host "タスクがファイルから読み込まれました。"
    
    function AddTask {
        $task = Read-Host "追加したいタスクを入力してください"
        #タスク名が空、または、100文字以上
        if (-not $task -or $task.Length -gt 100) {
            Write-Host "タスク名が不正です。タスク名を入力してください。"
            #処理を抜ける
            return
        }
        $script:tasks += $task
        Write-Host "$task がToDoリストに追加されました。"
    }
    
    # タスクの表示機能
    function ShowTasks {
        Write-Host "現在のタスク一覧:"
        for ($i=0; $i -lt $script:tasks.Length; $i++) {
            Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
        }
    }
    
    # タスクの削除機能
    function RemoveTask {
        # 現在のタスク一覧を表示
        ShowTasks
    
        # ユーザーに削除したいタスクの番号を入力させる
        $index = Read-Host "削除したいタスクの番号を入力してください"
    
        # 入力された番号が有効な範囲内にあるかを確認
        if ($index -ge 1 -and $index -le $script:tasks.Length) {
            # 選択された番号のタスクを取得
            $removedTask = $script:tasks[$index-1]
    
            # タスクが1つだけの場合、タスクの配列を空にする
            if ($script:tasks.Length -eq 1) {
                $script:tasks = @()
            } 
            # 最初のタスクを削除する場合
            elseif ($index -eq 1) {
                $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
            } 
            # 最後のタスクを削除する場合
            elseif ($index -eq $script:tasks.Length) {
                $script:tasks = $script:tasks[0..($index-2)]
            } 
            # 最初や最後以外のタスクを削除する場合
            else {
                $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
            }
    
            # 削除されたタスクの情報を表示
            Write-Host "$removedTask がToDoリストから削除されました。"
        } else {
            # 無効な番号が入力された場合のメッセージを表示
            Write-Host "無効な番号です。再度選択してください。"
        }
    }
    
    # タスクの保存機能
    function SaveTasks {
        $script:tasks | Out-File $tasksFile
        Write-Host "タスクがファイルに保存されました。"
    }
    
    # メニュー表示
    do {
        $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: タスク保存, 5: 終了)"
        switch ($choice) {
            '1' { AddTask }
            '2' { ShowTasks }
            '3' { RemoveTask }
            '4' { SaveTasks }
            '5' { Write-Host "プログラムを終了します。"; break }
            default { Write-Host "無効な選択です。再度選択してください。" }
        }
    } while ($choice -ne '5')
}Catch{

    #エラーメッセージ出力
    Write-Host "予期せぬエラーが発生しました: $($_.Exception.Message)"
    
    #ログファイル出力
    echo "予期せぬエラーが発生しました: $($_.Exception.Message)" | Out-File -Append $logFile
}

まとめ

今回はToDoリストのアプリケーションにエラーハンドリングを導入するプロセスについて学びました。エラーハンドリングは、ユーザーがアプリケーションをスムーズに使用できるようにするための必須の要素です。ユーザーの入力や外部ファイルの取り扱いなど、エラーが発生しうる箇所に適切なエラーメッセージや処理を追加することで、アプリケーションの信頼性と使いやすさが大幅に向上します。

今回の要点を再確認しましょう：

1. ユーザー入力のエラーハンドリング: タスクの名前や期限などの入力項目を正しく検証。
2. ファイル操作時のエラー処理: ファイルの存在チェックや読み書きエラーのハンドリング。
3. 一般的なエラーの処理: 予期せぬエラーに対する全体的なエラーハンドリング。

お疲れ様でした。これにてToDoリストの完成を迎えることができました！
次のステップとして、今回得た知識を元にデータ管理ツールの作成手順を用意しています。次回も、新たな知識やスキルを一緒に学びながら、さらなる成長を目指しましょう！

多くのプログラムやスクリプトは特定の場所に依存せず、どこからでも動作するようにしたいものです。特にToDoリストのようなツールは、異なるPCや場所での利用を考慮すると、移植性が非常に重要です。この記事では、PowerShellを使用して、ToDoリストの移植性を向上させる方法について詳しく解説します。

相対パスの基本

上司

あのToDoリストのツール、自分のPCに移したけど動かないよ。

猫道

おかしいなあ…

これはよくあるトラブルのひとつです。特定の場所にしか存在しないファイルやディレクトリのパスを指定してしまっていると、他の場所やPCでの利用が難しくなってしまいます。ここで重要なのが「相対パス」という考え方です。

相対パスとは、現在のファイルやディレクトリからの位置関係で別のファイルやディレクトリの場所を示す方法のことを指します。例えば、同じディレクトリ内にあるファイルを指す際や、ひとつ上の階層にあるディレクトリを指す際などに使用します。

相対パスを利用する最大の利点は、ツールやプログラムの移植性が向上することです。具体的な場所に依存しないので、異なるPCやディレクトリでも問題なく動作する可能性が高まります。

さて、実際に相対パスの概念を用いて、ToDoリストのツールをどのように改善していくのか、次のセクションで詳しく見ていきましょう。

相対パスの利用方法

それでは、PowerShellでの相対パスの具体的な使い方を学びましょう。

現在のディレクトリの確認方法

ツールの実行方法により現在のディレクトリの位置が異なります。

PowerShellコンソールを起動する場合

コンソール上に現在のパスが表示されます。
以下の画像では、「C:\Users\Owner」が現在のディレクトリに当たります。

ツールを直接実行する場合

ツールの配置場所がカレントディレクトリになります。
以下の画像では、「C:\Users\Owner\Desktop\work\bin」がカレントディレクトリにあたります。

現在のディレクトリ内のファイルへのアクセス

以下のコードは、相対パスを使用してファイルを参照する基本的な例です。この方法を使用すると、異なる環境でも同じコードが正常に動作します。

現在のディレクトリ内に存在するファイルにアクセスする場合、ファイル名だけで指定することができます。

Get-Content .\myfile.txt

1階層上のディレクトリにアクセス

.. を使って1階層上のディレクトリにアクセスします。

Set-Location ..\parent_directory

子ディレクトリへのアクセス

子ディレクトリにアクセスする場合は、そのディレクトリ名を指定します。

Set-Location .\child_directory

複数階層のディレクトリを経由してのアクセス

\ を使ってディレクトリを連ねて指定します。

Get-Content .\directory1\directory2\targetfile.txt

このように相対パスを使用することで、さまざまな場所のファイルやディレクトリを柔軟に指定することができます。具体的なパスを指定する必要がなく、コードの移植性や保守性が向上します。

PowerShell、コマンドプロンプトでの相対パスの実装

ToDoList.ps1の相対パス変更

現在のスクリプトのディレクトリ取得方法

PowerShellには、現在実行中のスクリプトのディレクトリを取得するための変数、$PSScriptRootがあります。これを利用することで、相対パスを用いてスクリプトと同じディレクトリに存在するファイルへのアクセスや他のディレクトリへの移動が容易になります。

ToDoList.ps1への反映

次に、tasks.txtへの相対パスを指定する方法を考えます。

現在、スクリプト中では以下のように絶対パスでファイルを指定しています。

#ファイル読み込み
$tasks += Get-Content "C:\Users\Owner\Desktop\work\data\tasks.txt"

これを相対パスを用いた方法に変更すると以下のようになります。

#ファイル読み込み
$tasks += Get-Content "$PSScriptRoot\..\data\tasks.txt"

この変更により、スクリプトが配置されているディレクトリに関係なく、常にスクリプトの親ディレクトリのdataフォルダ内のtasks.txtを参照するようになります。

同様に、タスクの保存機能の部分も以下のように変更します。

#タスクの保存機能
function SaveTasks {
    $script:tasks | Out-File "$PSScriptRoot\..\data\tasks.txt"
    Write-Host "タスクがファイルに保存されました。"
}

これにより、スクリプトがどのフォルダに配置されているかに関わらず、常に正しい場所のtasks.txtを参照するようになり、フォルダ構造の変更や移動にも柔軟に対応できるようになります。

よりよい改善方法

プログラムやスクリプトを記述する際、特にファイル内で繰り返し使用する変数や定数（ここではパスやファイル名）は、コードの初めの部分で明示的に定義しておくのが一般的です。以下のメリットが挙げられます：

1. 可読性の向上: 変数名を適切に選ぶことで、コードの意図が明確に伝わりやすくなります。また、同じ値を繰り返し使用する場合、その変数の定義箇所を変更するだけで、全ての使用箇所の値も一括で変わるため、修正漏れが減少します。
2. 変更の容易性: 定義を一箇所で行っていれば、将来的に変更が生じた際も、その箇所だけの変更で済みます。これは保守性の面で大きな利点となります。

共通のパスやファイルを設定

スクリプトの初めの部分で、以下のような定義を行います。

# 共通のパスの設定
$commonPath = "$PSScriptRoot\.."

# tasksファイルへのパスの設定
$tasksFile = "$commonPath\data\tasks.txt"

この共通パスやファイルパスの変数を、ファイルの読み込みや保存などの処理で使用することで、冗長なコードの繰り返しを避け、スクリプト全体の可読性や保守性を向上させることができます。

ソースコードへの反映

例えば、タスクの読み込みの際の処理は、以下のように簡潔に書くことができます。

# ファイル読み込み
$tasks += Get-Content $tasksFile

同様に、タスクの保存機能も以下のように変更することで、コードがシンプルで理解しやすくなります。

# タスクの保存機能
function SaveTasks {
    $script:tasks | Out-File $tasksFile
    Write-Host "タスクがファイルに保存されました。"
}

このように、変数や定数を適切に設定することで、コードの品質や可読性、保守性を大きく向上させることができます。
以降の記事では「よりよい改善方法」のソースで進めます。

ToDoList.batの相対パス変更

現在のスクリプトのディレクトリ取得方法

バッチファイルにおいて、%~dp0 という変数を利用すると、実行中のバッチファイル自身のディレクトリへの絶対パスを取得することができます。この変数を利用して、絶対パスを指定する部分を相対パスに変更します。

猫道

$PSScriptRootはPowerShellのコマンドだから、
batファイルでは使えないよ。

ToDoList.batへの反映

現在、ToDoList.bat ファイルは ToDoList.ps1 の絶対パスを指定しています。この絶対パスを相対パスに変更することで、ファイルやフォルダの移動、あるいは異なる環境での実行でも、正しく動作するようにします。

rem 修正前
@echo off
powershell.exe -ExecutionPolicy RemoteSigned "C:\Users\Owner\Desktop\work\bin\ToDoList.ps1"

rem 修正後
@echo off
powershell.exe -ExecutionPolicy RemoteSigned "%~dp0bin\ToDoList.ps1"

上記の修正により、ToDoList.batからToDoList.ps1を正常に実行することができます。

猫道

これで動かしてみてください！

上司

おお、動いたよ。ありがとう。

ここまでのソースコード

参考として、ここまでのソースコードを記載します。

ToDoList.bat

@echo off
powershell.exe -ExecutionPolicy RemoteSigned "%~dp0bin\ToDoList.ps1"

ToDoList.ps1

# 共通のパスの設定
$commonPath = "$PSScriptRoot\.."

# tasksファイルへのパスの設定
$tasksFile = "$commonPath\data\tasks.txt"

# タスクの配列を宣言
$tasks = @()

# ファイル読み込み
$tasks += Get-Content $tasksFile
Write-Host "タスクがファイルから読み込まれました。"

# タスクの追加機能
function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    for ($i=0; $i -lt $script:tasks.Length; $i++) {
        Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
    }
}

# タスクの削除機能
function RemoveTask {
    # 現在のタスク一覧を表示
    ShowTasks

    # ユーザーに削除したいタスクの番号を入力させる
    $index = Read-Host "削除したいタスクの番号を入力してください"

    # 入力された番号が有効な範囲内にあるかを確認
    if ($index -ge 1 -and $index -le $script:tasks.Length) {
        # 選択された番号のタスクを取得
        $removedTask = $script:tasks[$index-1]

        # タスクが1つだけの場合、タスクの配列を空にする
        if ($script:tasks.Length -eq 1) {
            $script:tasks = @()
        } 
        # 最初のタスクを削除する場合
        elseif ($index -eq 1) {
            $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
        } 
        # 最後のタスクを削除する場合
        elseif ($index -eq $script:tasks.Length) {
            $script:tasks = $script:tasks[0..($index-2)]
        } 
        # 最初や最後以外のタスクを削除する場合
        else {
            $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
        }

        # 削除されたタスクの情報を表示
        Write-Host "$removedTask がToDoリストから削除されました。"
    } else {
        # 無効な番号が入力された場合のメッセージを表示
        Write-Host "無効な番号です。再度選択してください。"
    }
}

# タスクの保存機能
function SaveTasks {
    $script:tasks | Out-File $tasksFile
    Write-Host "タスクがファイルに保存されました。"
}

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: タスク保存, 5: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { RemoveTask }
        '4' { SaveTasks }
        '5' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '5')

まとめ

今回の記事では、スクリプトやプログラムでの相対パスの重要性とその実装方法に焦点を当てました。相対パスを使用することで、ツールやスクリプトの移動性や互換性が向上し、さまざまな環境で問題なく動作するようになります。具体的に、ToDoList.ps1 スクリプトの読み込み・保存パスを相対パスを使用して変更しました。また、バッチファイルにおける相対パスの指定方法も確認しました。

次回のテーマとしては、スクリプトのさらなる改善を目指し、「エラーハンドリング」について取り上げます。スクリプト実行中に予期せぬエラーが発生した場合、そのエラーを適切に捉えてユーザーに通知する方法や、エラー発生時の対処方法について学ぶことができます。

今回の記事を通じて、スクリプトやプログラムの柔軟性や使いやすさの向上の重要性を感じていただければ幸いです。次回も、PowerShellスクリプトをより堅牢に、そしてユーザーフレンドリーにする方法を一緒に学びましょう！

データ永続性とは

データ永続性とは、データを一時的なメモリ上ではなく、永続的に保存することを指します。例えば、アプリケーションやウェブサイトで入力した情報を、再起動やブラウザの再読み込み後も保持し続けることができるようにするための仕組みです。このデータ永続性は、ユーザーが安心してアプリケーションやサービスを利用するための基本的な要件となっています。

データの永続性がないと、ユーザーが入力した情報や設定が失われてしまい、その都度再入力が必要となります。これは非常に手間がかかり、ユーザーの利便性を損なう要因となります。特に、ToDoリストのような情報を頻繁に更新するアプリケーションでは、データの永続性は必須となります。

上司

コンソール閉じたらデータが全部消えてしまいそうだね。

データが保管されないのは困るな…。

猫道

保管したいなんて言ってなかったじゃないか

このような要望を受けて、データ永続性を持ったToDoリストの作成が求められています。次のセクションでは、PowerShellを使用して、このデータ永続性を実現する方法を詳しく解説していきます。

PowerShellでのファイル操作の基本

PowerShellは、Windowsの標準シェルとして提供されている強力なスクリプト言語です。そのため、ファイルの操作も非常に簡単に行うことができます。ここでは、ファイルの基本的な読み込みと書き込みの方法を紹介します。

ファイルの読み込み

PowerShellでファイルを読み込むには、Get-Content コマンドを使用します。

$content = Get-Content -Path "C:\path\to\your\file.txt"
Write-Output $content

上記のコードは、指定したパスのファイルの内容を読み込み、それを $content という変数に格納しています。その後、Write-Output コマンドで内容を表示しています。

ファイルの書き込み

ファイルへの書き込みは、Set-Content コマンドを使用します。

$text = "これはテストのテキストです。"
Set-Content -Path "C:\path\to\your\file.txt" -Value $text

このコードは、$text という変数に格納されたテキストを指定したパスのファイルに書き込んでいます。

猫道

これらのコマンドを覚えることで、色々なことができるようになります。

ToDoリストでファイルの保存/読み込みをする方法

これまでに作成したToDoリストのプログラムでは、タスクの追加、表示、削除の基本的な機能を実装してきました。しかし、プログラムを終了するとタスクのデータは失われてしまいます。このセクションでは、タスクのデータをファイルに保存し、再度プログラムを起動した際にそのデータを読み込む方法を学びます。

「work」フォルダ内に「data」フォルダを作成し、「tasks.txt」を配置することにします。

ファイルへの保存

以下の関数を追加して、タスクのデータをファイルに保存します。

# タスクの保存機能
function SaveTasks {
    $script:tasks | Out-File "C:\Users\Owner\Desktop\work\data\tasks.txt"
    Write-Host "タスクがファイルに保存されました。"
}

この関数は、$tasks 配列の内容を Out-File コマンドを使用してファイルに書き込んでいます。

「|」について

「|」はパイプと呼ばれる記号で、Unix系OSやPowerShellなどのシェル環境で使用されます。一つのコマンドの出力を、次のコマンドの入力として渡す役割を持ちます。これにより、複数のコマンドを連鎖的に実行することができます。「Shift」+「\」キーで入力できます。

ファイルからの読み込み

次に、プログラムの開始時にファイルからタスクのデータを読み込む機能を追加します。

# タスクの配列を宣言
$tasks = @()

# ファイル読み込み
$tasks += Get-Content "C:\Users\Owner\Desktop\work\data\tasks.txt"
Write-Host "タスクがファイルから読み込まれました。"

このコードは、指定したパスのファイルが存在する場合、そのファイルの内容を $tasks 配列に読み込んでいます。

猫道

ファイルパスは自分の配置した場所にしてね。

メニューに保存機能の呼び出しを追加

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: タスク保存, 5: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { RemoveTask }
        '4' { SaveTasks }
        '5' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '5')

上記の修正により、メニューから「4: タスク保存」という選択肢を選ぶことで、SaveTasks 関数が呼び出され、タスクのデータがファイルに保存されるようになります。

動作確認

ソースコード

以下が取込版のソースコードになります。

# タスクの配列を宣言
$tasks = @()

# ファイル読み込み
$tasks += Get-Content "C:\Users\Owner\Desktop\work\data\tasks.txt"
Write-Host "タスクがファイルから読み込まれました。"

# タスクの追加機能
function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    for ($i=0; $i -lt $script:tasks.Length; $i++) {
        Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
    }
}

# タスクの削除機能
function RemoveTask {
    # 現在のタスク一覧を表示
    ShowTasks

    # ユーザーに削除したいタスクの番号を入力させる
    $index = Read-Host "削除したいタスクの番号を入力してください"

    # 入力された番号が有効な範囲内にあるかを確認
    if ($index -ge 1 -and $index -le $script:tasks.Length) {
        # 選択された番号のタスクを取得
        $removedTask = $script:tasks[$index-1]

        # タスクが1つだけの場合、タスクの配列を空にする
        if ($script:tasks.Length -eq 1) {
            $script:tasks = @()
        } 
        # 最初のタスクを削除する場合
        elseif ($index -eq 1) {
            $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
        } 
        # 最後のタスクを削除する場合
        elseif ($index -eq $script:tasks.Length) {
            $script:tasks = $script:tasks[0..($index-2)]
        } 
        # 最初や最後以外のタスクを削除する場合
        else {
            $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
        }

        # 削除されたタスクの情報を表示
        Write-Host "$removedTask がToDoリストから削除されました。"
    } else {
        # 無効な番号が入力された場合のメッセージを表示
        Write-Host "無効な番号です。再度選択してください。"
    }
}

#タスクの保存機能
function SaveTasks {
    $script:tasks | Out-File "C:\Users\Owner\Desktop\work\data\tasks.txt"
    Write-Host "タスクがファイルに保存されました。"
}


# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: タスク保存, 5: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { RemoveTask }
        '4' { SaveTasks }
        '5' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '5')

実機の動作

１．朝ごはんタスクを追加、保存し、プログラムを終了します。

２．「tasks.txt」を開くと、タスクが保存されています。

３．再度プログラムを起動すると、保存したタスクが読み込まれました。

猫道

できたー

実行ポリシーの考慮

PowerShellのスクリプト（.ps1ファイル）を直接実行する場合、実行ポリシーの制限により、スクリプトが実行されないことがあります。特に、初めてPowerShellスクリプトを実行する場合や、セキュリティ設定が厳格な環境では、この問題に直面することが多いです。

猫道

上司のPC環境では動かないかもしれない…

この問題を回避するための一つの方法として、batファイルからPowerShellスクリプトを呼び出す方法があります。

batファイルについて

batファイルは、Windowsのコマンドプロンプトで実行される一連のコマンドを含むスクリプトファイルです。これにより、複数のコマンドを一度に自動的に実行することができます。拡張子は「.bat」または「.cmd」となります。

この記事では、.ps1ファイルを実行するために使用します。

batファイルからps1スクリプトを呼び出す

事前準備

テキストファイルを新規作成し、「ToDoList.bat」に名前を変更します。

「ToDoList.ps1」は触られたくないので、移動しましょう。
「bin」フォルダを作成し、移動しました。

バッチファイルの編集

以下は、batファイルを使用してPowerShellスクリプトを呼び出す例です。

@echo off
powershell.exe -ExecutionPolicy RemoteSigned "C:\Users\Owner\Desktop\work\bin\ToDoList.ps1"

このbatファイルを実行すると、指定したPowerShellスクリプト（この例ではToDoList.ps1）が実行されます。-ExecutionPolicy Bypass オプションにより、実行ポリシーの制限を回避してスクリプトを実行することができます。

この方法を使用することで、PowerShellの実行ポリシーによる制限を気にせずに、スクリプトを簡単に実行することができます。
また、スクリプトの実行方法が分からなくても、batファイルであればダブルクリックで簡単に実行できます。

猫道

出来ました！完璧です！

上司

ありがとう。早速使わせてもらうよ。

まとめと次のステップ

この記事では、PowerShellを用いてToDoリストのデータをファイルに保存する方法を学びました。具体的には、以下の内容を取り上げました。

• データ永続性の重要性とその実現方法
• PowerShellにおけるファイル操作の基本的な手法
• ToDoリストのデータをファイルに保存・読み込む実装方法
• 実行権限の制限を回避するためのbatファイルを用いた方法

これにより、プログラムを終了してもタスクのデータが失われることなく、次回も継続して使用することができるようになりました。

次回は、さらに実用的なToDoリストの作成に向けて、スクリプトの移植性を高めるためのテクニックを学びます。具体的には、「相対パスを利用した移植性の向上」に焦点を当て、どの環境でも同じように動作するスクリプトの作成方法を解説します。さらに実践的な知識を深めていきましょう。

今回の「Part 4」では、ToDoリストのさらなる使いやすさを追求するための「タスクの削除機能」の実装に挑戦します。タスクを追加するだけでなく、不要になったタスクを削除することで、リストを常に最新の状態に保ち、効率的なタスク管理を実現することができます。

それでは、一緒にタスクの削除機能の実装に取り組んでいきましょう。

前回までのソースコード

# タスクの配列を宣言
$tasks = @()

# タスクの追加機能
function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    foreach ($task in $script:tasks) {
        Write-Host ($task)
    }
}

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '3')

タスク削除機能の重要性

ToDoリストは、私たちの日常や業務におけるタスクを整理し、効率的に進めるためのツールとして非常に役立ちます。その中でも、タスクの削除機能はToDoリストの使いやすさを大きく左右する要素の一つです。

ToDoリストの使いやすさを高める要因

タスクの追加や表示だけでなく、タスクの削除がスムーズに行えることで、リストは常に最新の状態を保つことができます。過去の不要なタスクが残っていると、リストが乱雑になり、新しいタスクの確認や追加が難しくなります。削除機能を適切に利用することで、このような問題を回避し、リストの見通しを良くすることができます。

タスクの整理・管理の効率化

タスクの削除は、単にリストからのタスクの除去だけでなく、タスクの整理・管理の効率化にも寄与します。例えば、同じタスクを複数回追加してしまった場合や、間違って追加したタスクを修正する際に、削除機能があれば迅速に対応することができます。また、タスクの優先順位を変更する際にも、不要なタスクを削除することで、リストの整理が容易になります。

このように、タスクの削除機能はToDoリストの使いやすさや効率的なタスク管理のために欠かせない機能と言えるでしょう。

タスクの削除機能の実装

タスクの追加や表示と同様に、タスクの削除も非常に重要な機能です。以下の手順で、タスクの削除機能を実装していきましょう。

タスクの番号を表示

まず、タスクの表示機能にタスクの番号を追加します。
ここでは、タスクの番号（繰り返しの回数）を表示するために、foreach文からfor文へ変更します。

function ShowTasks {
    Write-Host "現在のタスク一覧:"
    for ($i=0; $i -lt $script:tasks.Length; $i++) {
        Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
    }
}

for文について

for文は、特定の条件が満たされている間、繰り返し処理を行うための制御構文です。foreach文とは異なり、for文は繰り返しの回数や条件を明示的に指定することができます。

基本的な構文

for (初期化式; 条件式; 更新式) {
    # 繰り返し実行する処理
}

• 初期化式: 繰り返し処理の開始前に一度だけ実行される式。通常、カウンタ変数の初期値を設定します。
• 条件式: この条件が真である限り、繰り返し処理が実行されます。
• 更新式: 各繰り返しの後に実行される式。通常、カウンタ変数の値を更新します。

例

for ($i = 0; $i -lt 5; $i++) {
    Write-Host $i
}

このコードは、0から4までの数字を順番に表示します。

for文の利点

• 繰り返しの回数や条件を明示的に指定できるため、柔軟な繰り返し処理が可能です。
• カウンタ変数を利用して、繰り返し処理の中での現在の繰り返し回数を知ることができます。

foreach文がコレクションの各要素に対して処理を行うのに適しているのに対し、for文は特定の条件や回数で繰り返し処理を行いたい場合に適しています。

削除したいタスクの選択

次に、ユーザーが削除したいタスクを選択できるようにします。

function RemoveTask {
    # 現在のタスク一覧を表示
    ShowTasks

    # ユーザーに削除したいタスクの番号を入力させる
    $index = Read-Host "削除したいタスクの番号を入力してください"

    # 入力された番号が有効な範囲内にあるかを確認
    if ($index -ge 1 -and $index -le $script:tasks.Length) {
        # 選択された番号のタスクを取得
        $removedTask = $script:tasks[$index-1]

        # タスクが1つだけの場合、タスクの配列を空にする
        if ($script:tasks.Length -eq 1) {
            $script:tasks = @()
        } 
        # 最初のタスクを削除する場合
        elseif ($index -eq 1) {
            $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
        } 
        # 最後のタスクを削除する場合
        elseif ($index -eq $script:tasks.Length) {
            $script:tasks = $script:tasks[0..($index-2)]
        } 
        # 最初や最後以外のタスクを削除する場合
        else {
            $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
        }

        # 削除されたタスクの情報を表示
        Write-Host "$removedTask がToDoリストから削除されました。"
    } else {
        # 無効な番号が入力された場合のメッセージを表示
        Write-Host "無効な番号です。再度選択してください。"
    }
}

コードの説明

• ShowTasks: 現在のタスク一覧を表示する関数を呼び出します。これにより、ユーザーはどのタスクを削除するかを選択できます。
• $index = Read-Host "削除したいタスクの番号を入力してください": ユーザーにタスクの番号を入力させ、その番号を$index変数に保存します。
• if ($index -ge 1 -and $index -le $script:tasks.Length): 入力された番号が有効な範囲内にあるかを確認する条件文です。
• $script:tasks = ...: 選択されたタスクを配列から削除する処理です。配列のスライスと結合を使用して、指定されたタスクを削除します。
• Write-Host "$removedTask がToDoリストから削除されました。": 削除されたタスクの情報を表示するコードです。

if文について

if文は、特定の条件が真（true）である場合に、特定のコードブロックを実行するための制御構造です。この構造は、プログラムの流れを制御するための基本的なツールとして、多くのプログラミング言語で利用されています。

基本的な構文

if (条件) {
    # 条件が真の場合に実行されるコード
}

例

$number = 5
if ($number -gt 3) {
    Write-Host "数値は3より大きいです。"
}

この例では、$numberが3より大きい場合、”数値は3より大きいです。”というメッセージが表示されます。

if,elseif,else文について

また、elseifとelseを組み合わせることで、複数の条件を順番に評価し、最初に真となる条件に関連するコードブロックを実行することができます。

基本的な構文

if (条件1) {
    # 条件1が真の場合に実行されるコード
} elseif (条件2) {
    # 条件1が偽で、条件2が真の場合に実行されるコード
} else {
    # すべての条件が偽の場合に実行されるコード
}

例

$number = 5
if ($number -eq 3) {
    Write-Host "数値は3です。"
} elseif ($number -gt 3) {
    Write-Host "数値は3より大きいです。"
} else {
    Write-Host "数値は3より小さいです。"
}

この例では、$numberが3である場合、3より大きい場合、3より小さい場合の3つの異なる条件に基づいて、異なるメッセージが表示されます。

メニューに削除機能を追加

do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { RemoveTask }
        '4' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '4')

これで、タスクの削除機能が追加されました。実際にプログラムを実行して、タスクの追加、表示、削除が正しく動作するか確認してみましょう。

動作確認

実際に動かしてみます。

# タスクの配列を宣言
$tasks = @()

# タスクの追加機能
function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    for ($i=0; $i -lt $script:tasks.Length; $i++) {
        Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
    }
}

# タスクの削除機能
function RemoveTask {
    # 現在のタスク一覧を表示
    ShowTasks

    # ユーザーに削除したいタスクの番号を入力させる
    $index = Read-Host "削除したいタスクの番号を入力してください"

    # 入力された番号が有効な範囲内にあるかを確認
    if ($index -ge 1 -and $index -le $script:tasks.Length) {
        # 選択された番号のタスクを取得
        $removedTask = $script:tasks[$index-1]

        # タスクが1つだけの場合、タスクの配列を空にする
        if ($script:tasks.Length -eq 1) {
            $script:tasks = @()
        } 
        # 最初のタスクを削除する場合
        elseif ($index -eq 1) {
            $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
        } 
        # 最後のタスクを削除する場合
        elseif ($index -eq $script:tasks.Length) {
            $script:tasks = $script:tasks[0..($index-2)]
        } 
        # 最初や最後以外のタスクを削除する場合
        else {
            $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
        }

        # 削除されたタスクの情報を表示
        Write-Host "$removedTask がToDoリストから削除されました。"
    } else {
        # 無効な番号が入力された場合のメッセージを表示
        Write-Host "無効な番号です。再度選択してください。"
    }
}

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { RemoveTask }
        '4' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '4')

猫道

出来ましたよ！

上司

おお、早いね

まとめ

今回学んだ内容のまとめ

• ToDoリストの削除機能: タスクを効率的に管理するための重要な機能として、タスクの削除機能を実装しました。
• PowerShellの基本的な制御構造: if, elseif, および else を使用して条件に基づく処理の流れを制御する方法を学びました。
• 配列の操作: PowerShellでの配列のスライスと結合を利用して、特定のタスクを削除する方法を習得しました。

次回について

次回は、ToDoリストのデータを永続的に保存するための「データ永続性」と、ファイル操作に関する基本的な知識を学びます。これにより、プログラムを終了してもタスクのデータが失われないようにする方法や、外部のファイルとのデータのやり取りについて学ぶことができます。PowerShellでのプログラミングの幅がさらに広がる内容となっておりますので、お楽しみに！

これまでの学びを振り返ると、Part 1ではPowerShellの起動方法や最初のスクリプトの実行方法を学びました。続くPart 2では、タスクの追加機能を実装し、変数の使用方法を理解しました。これらの基本的な操作をマスターすることで、今回の内容に取り組む準備が整いました。

今回の記事を通じて、さらにPowerShellの魅力を深く理解し、プログラミングの楽しさを感じていただければ幸いです。

猫道

同じファイルを何度も更新するので、別のファイルとして保管しながら進めてね。

タスクの表示機能の実装

タスクの表示機能

ToDoリストにタスクを追加することができるようになったので、次にそのタスクを表示する機能を実装します。この機能を実装することで、現在のタスクの一覧を確認することができるようになります。

コード例:

# タスクの配列を宣言
$tasks = @("PowerShellの学習", "ブログ記事の執筆", "メールのチェック")

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    foreach ($task in $tasks) {
        Write-Host ($task)
    }
}

# タスクの表示
ShowTasks

コードの説明:

1. 最初に、サンプルとして3つのタスクを持った配列$tasksを宣言しています。
2. ShowTasksという関数を定義しています。この関数は、配列$tasksの中身を順番に表示する役割を持っています。
3. forループを使用して、配列の各要素を順番に取り出し、Write-Hostコマンドを使用してコンソールに表示しています。この際、タスクのインデックスも一緒に表示して、どのタスクがどのインデックスに対応しているかをわかりやすくしています。
4. 最後に、ShowTasks関数を呼び出して、タスクの一覧を表示しています。

このコードを実行すると、現在のタスク一覧がコンソールに表示されます。新たにタスクを追加したり、削除したりする機能を組み合わせることで、より実用的なToDoリストを作成することができます。

関数について

PowerShellでは、特定の処理をまとめて再利用可能な形にするために「関数」を使用します。関数は、一連のコマンドをグループ化して名前を付け、その名前を使って何度でもそのコマンド群を実行することができます。

関数の基本的な定義方法:

function 関数名 {
    # 処理内容
}

例:

function Greet {
    Write-Host "Hello, PowerShell!"
}

# 関数の呼び出し
Greet

上記の例では、Greetという名前の関数を定義しています。この関数は、”Hello, PowerShell!”というメッセージをコンソールに表示する役割を持っています。関数を定義した後、関数名を使ってその関数を呼び出すことができます。

関数は、コードの再利用性を高めるだけでなく、コードの構造を整理し、読みやすくするための重要なツールとなります。特に、同じ処理を複数の場所で使用する場合や、複雑な処理を分割して管理する場合には、関数の利用が非常に有効です。

メニュー表示機能の実装

メニュー表示機能

PowerShellを使用して、ユーザーに操作を選択させるメニューを表示する方法を紹介します。このメニュー表示機能は、ユーザーが複数の操作の中から選択を行い、その選択に応じて異なる処理を実行する際に非常に役立ちます。

以下のソースコード部分が、メニュー表示機能の実装部分です。

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: 終了)"
    switch ($choice) {
        '1' { Write-Host "タスクを追加します。" }
        '2' { Write-Host "タスクを表示します。" }
        '3' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
#3以外の場合
} while ($choice -ne '3')

メニュー表示機能の詳細:

1. 操作の選択: Read-Hostを使用して、ユーザーに操作を選択させます。選択された操作の番号が$choice変数に格納されます。
2. 選択に応じた処理の実行: switch文を使用して、$choice変数の値に応じて異なる処理を実行します。例えば、1が選択された場合はAddTask関数が呼び出され、タスクの追加処理が実行されます。
3. 繰り返し表示: do-whileループを使用して、ユーザーが「終了」を選択するまでメニューを繰り返し表示します。

このメニュー表示機能を使用することで、ユーザーに直感的な操作を提供し、複数の機能を持つアプリケーションの操作を簡単にすることができます。

do-whileループについて

foreachループは、配列やコレクションの各要素を順番に取り出して処理するための繰り返し構文であるのに対して、do-whileループは、特定の条件が満たされている間、繰り返し処理を行うための構文です。

基本的な構文:

do {
    # 繰り返し実行する処理
} while (条件)

このループは、まずdoブロック内の処理を実行し、その後whileの後に指定された条件を評価します。条件が$trueであれば、再びdoブロックの処理を実行します。この繰り返しは、条件が$falseになるまで続きます。

特徴:

• do-whileループは、条件が最初から$falseであっても、doブロックの処理は必ず1回は実行されます。
• 条件の評価は、doブロックの処理が完了した後に行われるため、ループの中で条件を変更することができます。

例:

$count = 0

do {
    Write-Host "繰り返し処理を実行中: $count 回目"
    $count++
} while ($count -lt 5)

このコードは、”繰り返し処理を実行中”というメッセージを5回表示します。$count変数の値が5未満である間、do-whileループは繰り返し実行されます。

switch文について

PowerShellにおけるswitch文は、一つの変数の値に応じて複数の処理を分岐させるための構文です。条件分岐の構文は他にif文を用いることが出来ますが、switch文は特に多くの条件を持つ場合に読みやすく、効率的にコードを書くことができます。

以下のソースコード部分が、switch文の使用例です。

switch ($choice) {
    '1' { AddTask }
    '2' { ShowTasks }
    '3' { Write-Host "プログラムを終了します。"; break }
    default { Write-Host "無効な選択です。再度選択してください。" }
}

switch文の詳細:

1. 条件の指定: switch文の後に括弧()内に条件となる変数や値を指定します。この例では$choice変数の値を条件としています。
2. 各ケースの処理: 波括弧{}内に、それぞれのケースに対応する処理を記述します。この例では、$choiceの値が1の場合、AddTask関数が呼び出されます。
3. デフォルトの処理: defaultキーワードを使用して、上記のケースに該当しない場合の処理を記述します。この例では、無効な選択がされた場合にメッセージを表示しています。

switch文を使用することで、複数の条件分岐を明確に、そして簡潔に記述することができます。特に、多くの条件を持つ場合や、特定の値に応じて異なる処理を行いたい場合に非常に役立ちます。

追加機能、表示機能、メニュー表示機能の統合

ここまで学んできた内容を元に、追加と表示機能を持つToDoリストを作成してみましょう。
以下のソースコードを参考に、各機能の詳細について説明します。

# タスクの配列を宣言
$tasks = @()

# タスクの追加機能
function AddTask {
    $task = Read-Host "追加したいタスクを入力してください"
    $script:tasks += $task
    Write-Host "$task がToDoリストに追加されました。"
}

# タスクの表示機能
function ShowTasks {
    Write-Host "現在のタスク一覧:"
    foreach ($task in $script:tasks) {
        Write-Host ($task)
    }
}

# メニュー表示
do {
    $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: 終了)"
    switch ($choice) {
        '1' { AddTask }
        '2' { ShowTasks }
        '3' { Write-Host "プログラムを終了します。"; break }
        default { Write-Host "無効な選択です。再度選択してください。" }
    }
} while ($choice -ne '3')

ソースコードの説明:

1. タスクの配列の宣言: $tasksという変数に初期タスクの配列を代入しています。
   ※2.と3.では、この配列に対してデータを追加したり表示したりしています。
   関数内で$tasksとしても、関数の外側に変数がありせっかく宣言した配列を参照することができません。$script:tasksとし参照範囲を変えています。
2. タスクの追加機能: AddTask関数を定義しており、この関数を呼び出すとユーザーに新しいタスクの入力を求め、入力されたタスクを$tasks配列に追加します。
3. タスクの表示機能: ShowTasks関数を定義しており、この関数を呼び出すと$tasks配列の中身を一覧表示します。
4. メニュー表示: do-whileループを使用して、ユーザーに操作を選択させるメニューを表示しています。ユーザーが「終了」を選択するまで、このメニューは繰り返し表示されます。

このソースコードを使用することで、簡単にタスクの追加や表示ができるToDoリストをPowerShellで実装することができます。

猫道

このソースコードを次回以降も使っていくよ。

まとめ

今回は、ToDoリストのタスク表示機能、メニュー表示機能の実装と、その際に活用する配列の基本について学びました。これまでのPart 1とPart 2の内容を踏まえ、さらに実践的なスキルを身につけることができました。

次回の記事では、ToDoリストのさらなる機能拡張に挑戦します。タスクの削除機能について詳しく解説します。

「ToDoList.ps1」の作成方法

新しいスクリプトファイルの作成

前回はPowerShellのコンソール上でコードを実行していましたが、あらかじめファイルにコードを記述し実行することも出来ます。

１．作業用のフォルダ「work」を作成し、テキストファイルを新規作成します。

２．ファイル名を「ToDoList.ps1」に変更します。

拡張子「.ps1」はPowerShellスクリプトを示すもので、この拡張子を持つファイルはPowerShellで実行可能です。保存する際は、アクセスしやすい場所、例えばデスクトップや専用のフォルダに保存すると良いでしょう。

「.txt」が表示されていない場合：
[表示]タブー「ファイル名拡張子」にチェックをつけてください。

スクリプトの編集方法

メモ帳を使用

1. スタートメニューを開き、「メモ帳」と入力します。
2. 検索結果に表示された「メモ帳」をクリックします。
3. 「メモ帳」画面に「ToDoList.ps1」をドラッグアンドドロップします。

Windows PowerShell ISEを使用

1. スタートメニューを開き、「PowerShell」と入力します。
2. 検索結果に表示された「Windows PowerShell ISE」をクリックします。
3. 「Windows PowerShell ISE」画面に「ToDoList.ps1」をドラッグアンドドロップします。

動作確認の事前準備

本サイトではメモ帳を使用します。
実行の成否を確認するため、以下の記述をします。

#コンソール出力
Write-Host "これはテストです。"

#待機
pause

「ToDoList.ps1」の実行方法

PowerShellコンソール上で実行

コンソール上に「ToDoList.ps1」をドラッグアンドドロップして[Enter]キーを押下します。

「Windows PowerShell ISE」コンソール上で実行

画面上部の「スクリプトを実行」ボタンをクリックします。
ショートカット（「F5」キー）でも実行出来ます。

注意点

実行が無効になっている旨のエラー表示

スクリプトの実行が無効になっている旨のエラーが表示された場合、実行許可の権限を与える必要があります。

常に実行可能することも出来ますがセキュリティリスクが高まるため、ここでは一時的に実行権限を与える方法を紹介します。（画面を開きなおす度に、都度設定する必要があります。）

【参考】：
【Set-ExecutionPolicy】PowerShellで実行ポリシーを「一時的」に変更するテクニック

#今開いているPowerShellウィンドウに対して実行権限をRemoteSignedに変更
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
#「はい（y）」で応答

＜エラー例＞

文字化け表示

「ToDoList.ps1」の文字コードがUTF-8等になっていることが考えられます。
文字コードを変更してください。

メモ帳で当該ファイルを開き、名前をつけて保存から文字コードを「ANSI」に変更し「保存」ボタンをクリックしてください。

＜エラー例＞

ToDoリストにタスクを追加する機能の実装

タスクの入力を受け付ける変数の作成

まず、ユーザーからタスクの入力を受け付けるための変数を作成します。以下のコードを使用して、タスクの入力を$taskという変数に保存します。

$task = Read-Host "追加したいタスクを入力してください"

このコードを実行すると、ユーザーにタスクの入力を促すメッセージが表示され、入力された内容が$task変数に保存されます。

入力されたタスクを配列に保存

次に、入力されたタスクを配列に保存します。タスクを管理するための配列$tasksを事前に作成し、入力されたタスクをこの配列に追加します。

$tasks += $task

このコードにより、$tasks配列に新しいタスクが追加されます。

タスクの追加確認メッセージの表示

タスクが正しく追加されたことをユーザーに知らせるため、確認メッセージを表示します。

Write-Host "$task がToDoリストに追加されました。"

このコードを実行すると、例えば「買い物」というタスクを入力した場合、「買い物 がToDoリストに追加されました。」というメッセージが表示されます。

変数の活用とその重要性

このセクションでは、あらためて変数について説明します。

PowerShellにおける変数の役割

PowerShellにおける変数は、データを一時的に保存するための容器のようなものです。変数には数値、文字列、オブジェクトなど、さまざまなデータを格納することができます。変数を使用することで、スクリプト内でデータを繰り返し利用したり、データを加工・変換したりすることが容易になります。

タスク管理における変数の利点

タスク管理のスクリプトにおいて、変数は非常に重要な役割を果たします。例えば、ユーザーからの入力を変数に保存することで、その入力を後の処理で再利用することができます。また、タスクのリストを配列という形の変数に保存することで、タスクの追加や削除、表示などの操作を効率的に行うことができます。

変数を使ったデータの一時保存と取り出し

変数はデータの一時保存に非常に便利です。例えば、$taskという変数にユーザーの入力を保存し、後でその変数を利用してタスクを配列に追加することができます。また、配列に保存されたタスクを取り出す際も、変数を利用して特定のタスクを参照・操作することができます。変数を活用することで、データの取り扱いが非常に柔軟かつ効率的になります。

まとめと次回予告

今回の記事では、PowerShellを用いてToDoリストの基本的な作成方法を学びました。具体的には、「ToDoList.ps1」の作成方法、タスクの追加機能の実装、そして変数の活用とその重要性について詳しく解説しました。これらの知識を基に、実際に自分の手でプログラムを作成することで、プログラミングの基本をより深く理解することができるでしょう。

次回の記事では、ToDoリストのさらなる機能拡張に挑戦します。タスクの表示機能や、配列を活用したタスクの管理方法について詳しく解説します。

PowerShellとは、Microsoftが開発したスクリプト言語で、Windowsの管理を自動化するための強力なツールです。しかし、その機能はそれだけにとどまらず、一般的なプログラミング言語としての機能も備えています。そのため、システム管理だけでなく、様々なタスクの自動化や独自のプログラムの作成にも利用できます。

初心者にとってPowerShellの魅力は、Windowsに標準でインストールされているため、すぐに始められる点です。また、シンプルながらも強力な機能を持つため、基本的なプログラミングの概念を学びながら、実際に役立つスクリプトを作成することができます。

このサイト「PowerShellで始める!プログラミング初心者のための実践ガイド」では、PowerShellを用いたミニマムなプログラム作成の経験を通じて、プログラミングの理解を深める方法を紹介します。具体的なコードを示しながら、プログラミングの基本概念をわかりやすく解説します。

今回の記事では、PowerShellとその開発環境について紹介し、基本的な概念と構文を説明します。そして、それらの知識を活かして、最初のプログラム、すなわちToDoリストを作成する基礎を学んでいきます。

プログラミングに興味がありながらも自分が向いているかどうか不安を感じ、足踏みしているあなたに、この記事が一歩を踏み出すきっかけになれば幸いです。

それでは、一緒にPowerShellの世界を探索していきましょう。

PowerShellの起動と最初のスクリプトの実行

PowerShellはWindowsに標準でインストールされているため、特別な設定は必要ありません。それでは、早速PowerShellを起動し、最初のスクリプトを書いてみましょう。

1. スタートメニューを開き、「PowerShell」と入力します。
2. 検索結果に表示された「Windows PowerShell」をクリックします。

これでPowerShellのコンソール画面が開きます。ここが私たちがコードを書き、実行する場所です。

それでは、最初のスクリプトを書いてみましょう。PowerShellでは、「Hello, World!」と表示するためには以下のように入力します。

猫道

先頭が「#」の行はコメント行だから、入力しなくても動作するよ。

うまく動かない時は記事のソースをコピーして見比べてみてね。

#コンソール出力
Write-Host "Hello, World!"

「Write-Host」はコンソールに出力するコマンド、「””」は出力する文字列です。
このコードをPowerShellのコンソールに入力し、エンターキーを押すと、「Hello, World!」と表示されます。

おめでとうございます！これであなたは、PowerShellで最初のスクリプトを書き、実行することができました。

PowerShellの基本概念と構文

それでは、PowerShellの基本的な概念と構文について学んでいきましょう。ここで学ぶ概念は、他のプログラミング言語でも共通して使われるものですので、しっかりと理解しておきましょう。

猫道

ここでは基本的な構文をみていくよ。

画面をきれいにしたい時は開きなおしてね。

変数

変数は、データを一時的に保存するための箱のようなものです。PowerShellでは、変数名の前に「$」記号をつけることで変数を定義します。「$」は「Shift」+「F4」キーで入力できます。以下に、変数を使ったコードの例を示します。

#変数 ← 値（文字列）
$name = "Takeshi"

#コンソール出力
Write-Host "Hello, $name!"

このコードでは、$nameという変数に"Takeshi"という文字列を代入し、それを表示しています。

配列

配列は、複数のデータを一つの変数で管理するための構造です。PowerShellでは、@()を使って配列を定義します。以下に、配列を使ったコードの例を示します。

#変数　←　値（配列）
$numbers = @(1, 2, 3, 4, 5)

#コンソール出力
Write-Host "配列の中身:"$numbers

配列では、保持した値を別々に扱うことが出来ます。配列の要素は0番目から始まります。

#コンソール出力
Write-Host "配列の1番目:" $numbers[0]
Write-Host "配列の2番目:" $numbers[1]
Write-Host "配列の3番目:" $numbers[2]
Write-Host "配列の4番目:" $numbers[3]
Write-Host "配列の5番目:" $numbers[4]

ループ

ループは、同じ処理を繰り返し行うための構造です。ここでは、「foreach」を使ってループを作成します。以下に、ループを使ったコードの例を示します。

#変数　←　値（配列）
$numbers = @(1, 2, 3, 4, 5)

#$numbersの要素を1つずつ$numberに代入する。{}内の処理を要素の数だけ繰り返す。
foreach ($number in $numbers) {
    #コンソール出力
    Write-Host $number
}

このコードでは、$numbersの各要素に対して、その数値を表示する処理を繰り返しています。

条件分岐

通常、処理は上から下へ、順番に処理されます。
条件分岐を使用することで、条件によって処理を分けることが出来ます。

ここでは、「if」を使って条件分岐を作成します。以下に、条件分岐を使ったコードの例を示します。

#変数　←　値（数値）
$number = 10

#$numberの値が5より大きい場合
if ($number -gt 5) {
    #コンソール出力
    Write-Host "値は5より大きいです。"
#上記の条件以外の場合
} else {
    #コンソール出力
    Write-Host "値は5以下です。"
}

このコードでは、$numberが5より大きい場合とそうでない場合で表示するメッセージを変えています。
例えば、$numberを3に書き換えると「値は5以下です。」とコンソールに出力されます。

以上が、PowerShellの基本的な概念と構文です。これらを理解し、使いこなせるようになると、より複雑なプログラムも書けるようになります。

ToDoリストの作成に向けて

それでは、具体的なプロジェクト、すなわちToDoリストの作成に向けて進んでいきましょう。
詳しくは次回以降のStepで解説します。

上司

ToDoリストを作ってくれないかな？

猫道

任せてください！簡単に作れますよ。

ToDoリストを作成するためには、最低限以下の2つの機能が必要です。

1. タスクの追加
2. タスクの一覧表示

それでは、これらの機能を実現するためのPowerShellの構文を見ていきましょう。
詳しくは次回以降扱うため、ここでは参考程度に留めてください。

タスクの追加

タスクの追加は、変数と配列を使って実現できます。以下に、タスクを追加するコードの例を示します。

「Read-Host」はユーザ入力を受け付けるコマンドです。「””」内には、入力を促すメッセージを設定します。

#変数　←値（配列）の初期化（値なし）
$tasks = @()

#入力された文字列を変数$taskに代入する
$task = Read-Host "タスクを入力してください。"

#$taskを$tasks配列に追加する
$tasks += $task

このコードでは、$tasksという配列に、ユーザーが入力したタスクを追加しています。

タスクの一覧表示

タスクの一覧表示は、ループを使って実現できます。以下に、タスクを一覧表示するコードの例を示します。

#$tasksの要素を1つずつ$iに代入して要素数分繰り返す
foreach ($i in $tasks) {
    #コンソール出力
    Write-Host $i
}

このコードでは、$tasksの各要素（タスク）を表示しています。

以上が、ToDoリスト作成に必要な基本的な機能と、それを実現するためのPowerShellの構文です。次回は、これらの機能を組み合わせて、実際のToDoリストを作成していきます。

まとめと次回予告

今回の記事では、PowerShellの基本的な概念と構文、そしてToDoリスト作成に向けた準備を学びました。PowerShellの起動方法から、変数、配列、ループ、条件分岐といった基本的な概念、そしてToDoリスト作成に必要な基本的な機能について学びました。

次回の記事では、これらの知識を活かして、実際にToDoリストを作成していきます。具体的には、タスクの追加機能と変数の使用について詳しく学んでいきます。PowerShellで自分だけのToDoリストを作成する経験は、プログラミングの理解を深め、自信をつける大きな一歩となるでしょう。

あなたも一緒に、PowerShellでプログラミングの世界を探索してみませんか？今回学んだことを復習しながら、次回の記事をお楽しみにしていてください。

はじめに: 本記事の目的と内容

PowerShellは、多くのWindowsユーザーがすでに手元に持っている強力なツールです。しかし、その真の力を知る人はまだ少ないかもしれません。この記事では、PowerShellを活用して、実際に役立つToDoリストを作成する手順を紹介します。

なぜToDoリストなのか?

日常のタスク管理は、プログラミングの学び初めにおいて、実用的でわかりやすい題材となります。PowerShellを用いてToDoリストを作成することで、プログラミングの基本的な概念を実際に手を動かしながら学ぶことができます。

この記事で得られるもの

1. PowerShellの基本的な操作とコマンドの紹介
2. 実際に動作するToDoリストの作成手順
3. プログラミングの楽しさと実用性の体験

PowerShellの基本から始め、ToDoリストの作成を通じて、プログラミングの魅力を感じていただければ幸いです。

ステップ1: 基本概念の紹介

PowerShellを活用するためには、まずその基本的なコマンドや概念を理解することが重要です。このセクションでは、PowerShellの基本的な操作方法と、主要なコマンドや概念について紹介します。

PowerShell画面の起動方法

Windowsのスタートメニューから「PowerShell」と入力し、表示される「Windows PowerShell」をクリックすることで、PowerShell画面を起動することができます。

基本的なコマンドと概念の紹介

• Cmdlet: PowerShellの基本的なコマンドはCmdletと呼ばれ、Verb-Nounの形式で記述されます。例えば、Write-Hostなどがあります。
• 変数: $記号を使用して変数を宣言・使用することができます。例: $myVariable = "Hello, PowerShell!"

詳細なガイド

さらに詳しい情報や具体的な手順については、以下の記事をご参照ください。

• PowerShellでToDoリストを作る – Part 1: PowerShellの起動と最初のスクリプトの実行

ステップ2: ToDoリストの基本機能の実装

ToDoリストの基本的な機能として、タスクの追加、表示、削除が考えられます。このセクションでは、これらの基本機能の実装方法と、それを実現するためのPowerShellの基本的な概念について解説します。

タスクの追加、表示、削除機能の作成

• タスクの追加: $tasks = @()という配列を作成し、$tasks += "新しいタスク"のようにしてタスクを追加します。
• タスクの表示: foreach ($task in $tasks) { Write-Output $task }のようにして、配列内のすべてのタスクを表示します。
• タスクの削除: $tasks = $tasks -ne "削除するタスク"のようにして、特定のタスクを配列から削除します。

変数、配列、条件文の活用方法

• 変数: $記号を使用して変数を宣言・使用します。例: $taskName = "新しいタスク"。
• 配列: 複数のデータをまとめて管理するためのデータ構造。例: $tasks = @("タスク1", "タスク2")。
• 条件文: if, else, elseifを使用して、特定の条件下での処理を制御します。例: if ($task -eq "特定のタスク") { Write-Output "タスクが見つかりました" }。

詳細なガイド

基本機能の実装に関する詳しい手順やコード例については、PowerShellでToDoリストを作る – Part 2〜4をご参照ください。

• PowerShellでToDoリストを作る – Part 2: タスクの追加機能と変数の使用
• PowerShellでToDoリストを作る – Part 3: タスクの表示機能とメニュー表示機能の実装
• PowerShellでToDoリストを作る – Part 4: タスクの削除機能の追加

ステップ3: ToDoリストの改善

基本的なToDoリストの機能を実装した後、さらに実用的で使いやすいツールにするための改善と拡張が考えられます。このセクションでは、ToDoリストの改善のための方法と、それを実現するためのPowerShellの応用的な概念について解説します。

データの永続性、移植性、エラーハンドリングの導入

• データの永続性: Export-CsvやImport-Csvコマンドを使用して、タスクのデータをCSVファイルとして保存・読み込む方法を紹介します。
• 移植性: 相対パスを使用して、ToDoリストのデータや設定を他の環境でも利用できるようにします。
• エラーハンドリング: try-catch構文を使用して、エラーが発生した際の処理を制御し、ユーザーに適切なメッセージを表示します。

詳細なガイド

ToDoリストの改善と拡張に関する詳しい手順やコード例については、PowerShellでToDoリストを改善する – シリーズをご参照ください。

• PowerShellでToDoリストを改善する – Part 1: データ永続性とファイル操作
• PowerShellでToDoリストを改善する – Part 2: 相対パスを利用した移植性の向上
• PowerShellでToDoリストを改善する – Part 3: エラーハンドリングの導入

最終的なToDoリスト

これらの学習を通して、以下のプログラムを作成できるようになります。

実際の動作

最終的なToDoリストの動作イメージを以下に示します。

ソースコード

以下に、完成版のToDoリストのソースコードを示します。各部分の説明も併せて記載しています。

ToDoList.bat

このバッチファイルは、PowerShellスクリプトを実行するためのものです。

@echo off
powershell.exe -ExecutionPolicy RemoteSigned "%~dp0bin\ToDoList.ps1"

pause

ToDoList.ps1

このPowerShellスクリプトは、ToDoリストの主要な機能を実装しています。

Try {
    
    # 共通のパスの設定
    $commonPath = "$PSScriptRoot\.."
    
    # tasksファイル設定
    $tasksFile = "$commonPath\data\tasks.txt"
    
    # ログファイル設定
    $logFile = "$commonPath\log\log.txt"
    
    # タスクの配列を宣言
    $tasks = @()
    
    # ファイル存在チェック
    if (-not (Test-Path $tasksFile)) {
        #新規ファイル作成
        New-Item $tasksFile -ErrorAction Stop >$null
    }
    
    # ファイル読み込み
    $tasks += Get-Content $tasksFile
    Write-Host "タスクがファイルから読み込まれました。"
    
    function AddTask {
        $task = Read-Host "追加したいタスクを入力してください"
        #タスク名が空、または、100文字以上
        if (-not $task -or $task.Length -gt 100) {
            Write-Host "タスク名が不正です。タスク名を入力してください。"
            #処理を抜ける
            return
        }
        $script:tasks += $task
        Write-Host "$task がToDoリストに追加されました。"
    }
    
    # タスクの表示機能
    function ShowTasks {
        Write-Host "現在のタスク一覧:"
        for ($i=0; $i -lt $script:tasks.Length; $i++) {
            Write-Host ("[" + ($i + 1) + "] " + $script:tasks[$i])
        }
    }
    
    # タスクの削除機能
    function RemoveTask {
        # 現在のタスク一覧を表示
        ShowTasks
    
        # ユーザーに削除したいタスクの番号を入力させる
        $index = Read-Host "削除したいタスクの番号を入力してください"
    
        # 入力された番号が有効な範囲内にあるかを確認
        if ($index -ge 1 -and $index -le $script:tasks.Length) {
            # 選択された番号のタスクを取得
            $removedTask = $script:tasks[$index-1]
    
            # タスクが1つだけの場合、タスクの配列を空にする
            if ($script:tasks.Length -eq 1) {
                $script:tasks = @()
            } 
            # 最初のタスクを削除する場合
            elseif ($index -eq 1) {
                $script:tasks = $script:tasks[1..($script:tasks.Length-1)]
            } 
            # 最後のタスクを削除する場合
            elseif ($index -eq $script:tasks.Length) {
                $script:tasks = $script:tasks[0..($index-2)]
            } 
            # 最初や最後以外のタスクを削除する場合
            else {
                $script:tasks = $script:tasks[0..($index-2)] + $script:tasks[$index..($script:tasks.Length-1)]
            }
    
            # 削除されたタスクの情報を表示
            Write-Host "$removedTask がToDoリストから削除されました。"
        } else {
            # 無効な番号が入力された場合のメッセージを表示
            Write-Host "無効な番号です。再度選択してください。"
        }
    }
    
    # タスクの保存機能
    function SaveTasks {
        $script:tasks | Out-File $tasksFile
        Write-Host "タスクがファイルに保存されました。"
    }
    
    # メニュー表示
    do {
        $choice = Read-Host "操作を選択してください (1: タスク追加, 2: タスク表示, 3: タスク削除, 4: タスク保存, 5: 終了)"
        switch ($choice) {
            '1' { AddTask }
            '2' { ShowTasks }
            '3' { RemoveTask }
            '4' { SaveTasks }
            '5' { Write-Host "プログラムを終了します。"; break }
            default { Write-Host "無効な選択です。再度選択してください。" }
        }
    } while ($choice -ne '5')
}Catch{

    #エラーメッセージ出力
    Write-Host "予期せぬエラーが発生しました: $($_.Exception.Message)"
    
    #ログファイル出力
    echo "予期せぬエラーが発生しました: $($_.Exception.Message)" | Out-File -Append $logFile
}

まとめ

PowerShellを用いてToDoリストを作成することで、プログラミングの基本的な概念や技術を実際に手を動かしながら学んでいきましょう。この経験は、プログラミングの学びの初歩として非常に価値があります。

PowerShellを用いたToDoリスト作成の重要性とその効果

• 実践的な学び: 実際の問題を解決することで、理論だけでなく実践的なスキルを身につけることができます。
• 自信の向上: 自分でプログラムを作成し、動作を確認することで、プログラミングに対する自信がつきます。
• 基本の理解: ToDoリストの作成を通じて、プログラミングの基本的な概念や技術を深く理解することができます。

今後の学びの方向性

• 深化の方向: 既に学んだ内容をさらに深め、より高度なプログラムを作成する方向で学びを進めることができます。
• 新しいテーマの学び: PowerShell以外のプログラミング言語や技術を学ぶことで、幅広い知識とスキルを身につけることができます。
• 実践的なプロジェクト: 実際の業務や日常生活で役立つプログラムを作成することで、学びの成果を実感することができます。

次のステップへ

次のステップとして、「PowerShellでのデータ管理ツールの設計と実装の全手順」を推奨します。この記事では、PowerShellを用いてデータの管理や操作を行うツールの設計と実装方法を学ぶことができます。ToDoリストの作成を通じて得た知識を活かし、さらに高度なプログラムの作成に挑戦してみましょう。