Officeスクリプトのwhile文で繰り返し処理を習得！無限ループを防ぐポイントも解説

「Officeスクリプトで条件を満たすまでループするにはどうしたらいいの？」
そんなこと思ったことありませんか？

・繰り返し処理は、forEachやfor文以外にも方法があるの？

・条件を満たすまでループを続けたい場合にはどうすればいいの？

その場合は、Officeスクリプトの「while文」を
使用すると解決します！

この記事では、Officeスクリプトのwhile文を詳しく解説します。

Officeスクリプトのwhile文を使うと、特定の条件が満たされるまで繰り返し処理を行いながら動的にループを制御する方法と、無限ループを防ぐための適切な終了条件の設定について解説します。

この記事では、while文の基本的な使い方を解説し、実際にどのように利用するかを具体的な例を通じて学んでいきます。
繰り返し処理の考え方を深め、Excelスクリプトの自動化をさらに強化しましょう。

【　この記事の概要　】

この記事を読むと「できるようになる」こと

この記事を読むことで、次のことができるようになります。

Officeスクリプトの繰り返し処理「while文」とは？ | 他の繰り返し処理との違いと使い分け

Officeスクリプトでは、繰り返し処理を行うためのさまざまな方法が用意されています。

その中でも、「while文」は、特定の条件が満たされるまで繰り返し処理を行えるため、動的なループ制御が必要な場合に非常に便利です。
while文を活用することで、例えばセルの値が特定の数値に達するまで自動で処理を続けるといった操作が簡単に実現できます。

以下に、Officeスクリプトで使える繰り返し処理の種類と、その特徴をまとめました。
それぞれのループの特徴を知っておくと、シーンに合わせて最適なループを選べるようになります。

Officeスクリプトの繰り返し処理の種類

スクロールできます

繰り返し処理 の種類	特徴と使い方	主な用途
for文	事前に決めた回数だけ処理を繰り返す	固定回数の繰り返しが必要な時
forEach文	配列やリスト内の各要素に順番に処理を行う	配列やリスト全体に操作をしたい時
map	配列の各要素を変換し、新しい配列を作成	配列内のデータを変換したい時
filter	条件に合った配列の要素を抽出し、新しい配列を作成	条件に合う要素だけを抽出したい時
while文	特定の条件がtrueである間、処理を繰り返す	条件に基づく動的な繰り返しが必要な時
do…while文	少なくとも1回は処理を行い、条件に基づき繰り返す	条件次第で複数回処理する時

Officeスクリプトの「while文」の構成・使い方について

Officeスクリプトで「while文」を使うと、特定の条件が満たされるまで処理を繰り返し実行できます。

while文ではループの終了条件を自分で設定するため、動的にループの回数を管理したい場合に便利です。

以下で、「while文」の基本的な構成と押さえておくべきポイントを解説します。

while文の構成

例：while文の基本的な書き方

Officeスクリプトでwhile文を使う際の基本構成を以下に紹介します。

ここでは、カウンター変数を使って条件を設定し、ループの終了を適切に管理します。

function main(workbook: ExcelScript.Workbook) {
    let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
    let i: number = 0; // ループ用のカウンター変数をnumber型で初期化

    while (i <= 10) { // iが10以下である限りループが継続
        let cell: ExcelScript.Range = sheet.getRange(`A${i + 1}`);
        cell.setValue(i); // A列にカウンターの値を設定
        i++; // カウンターを1ずつ増やす
    }
}

実行結果

上記のコードでは、iが0から10になるまで、console.log(i)によってカウンターの値が出力されます。
ループが進行するたびにiが増加し、iが11になった時点でループが終了します。

このように、while文は動的な条件で繰り返し処理を行いたい場合に便利です。条件に応じて柔軟にループを管理できるので、Officeスクリプトでのデータ操作や自動化処理を効率化する強力な手段となります。

Officeスクリプトのwhile文でループを中断する方法：breakとcontinueの使い方

Officeスクリプトでwhile文を使うと、条件を満たすまで繰り返し処理を行うことができますが、ループ処理を途中で中断したい場合もあります。

while文の中でループを中断するためのbreakとcontinueの使い方について解説します。

これらを活用すると、Officeスクリプトでの自動化処理を効率よく進めることができます。

ループを強制終了する「break」

break文は、ループ処理の途中で指定の条件を満たした場合に、ループ全体を強制的に終了させるために使用します。

例えば、データが特定の値に達したら繰り返し処理をやめるといった用途に便利です。無駄な処理を省くことで、処理効率を上げることができます。

コード例: breakを使用したwhile文

以下の例では、変数iが5に達した時点で、break文が実行され、ループが終了します。

function main(workbook: ExcelScript.Workbook) { 
    let i: number = 0; 

    while (i < 10) { // iが10未満の間、ループを実行
        if (i === 5) {
            console.log(`iが${i}になったのでループを終了します`); 
            break; // iが5の時点でループを強制終了
        }
        i++;
    }
}

処理をスキップする「continue」

continue文は、現在のループ処理をスキップして次のループへ進みたい場合に使用します。

例えば、偶数のときは処理をスキップし、奇数のときだけ処理を行いたいケースに便利です。

コード例: continueを使用したwhile文

以下のコードでは、iが偶数の場合、continue文によって処理がスキップされ、奇数のときのみconsole.log(i)が実行されます。

function main(workbook: ExcelScript.Workbook) { 
    let i: number = 0; 

    while (i < 10) { // iが10未満の間、ループを実行
        i++; 

        if (i % 2 === 0) {
            continue; // iが偶数の時は処理をスキップして次の反復に進む
        }

        console.log(i); // 奇数の時のみiの値が出力される
    }
}

while文の中断方法まとめ

while文でbreakとcontinueの使い方を理解することで、ループ処理を柔軟に制御できるようになります。

これにより、Officeスクリプトでのデータ処理やExcel自動化がより効果的に行えるようになります。
必要に応じてこれらの制御文を使いこなし、効率的なスクリプトを作成しましょう。

Office ScriptによるExcel on the web開発入門

¥2,500 （2024/11/01 23:18時点 | Amazon調べ）

＼楽天ポイント4倍セール！／

楽天市場で探す

メルカリで探す

ポチップ

Officeスクリプト「while文」を使用時の注意ポイント

while文を使用する際は、以下のポイントに注意することで、予期しないエラーや無限ループの発生を防ぎ、スムーズに処理を進めることができます。

注意ポイント1 : 無限ループに注意

無限ループとは、終了条件が満たされずに繰り返し処理が終わらない状態のことです。

無限ループが発生すると、Excelの動作が停止したり、スクリプトが応答しなくなったりするため、while文を使う際には注意が必要です。

以下では、無限ループを防ぐための3つの対策を、具体的なコード例とともに解説します。

また、万が一無限ループが発生した際に強制的に停止する方法も紹介します。

終了条件を適切に設定する

ループが終わるための条件を明確に設定することが大切です。

カウンター変数iを使って終了条件を管理する場合、例えばi < 3という条件を設定し、処理が進むうちにiが条件を満たさなくなるようにしましょう。

function main(workbook: ExcelScript.Workbook) {
    let i: number = 0; 

    while (i < 3) { // iが3未満の間、ループを継続
        console.log(`現在のiの値: ${i}`); // iの現在値を出力
        i++; // カウンターを更新
    }
    console.log("ループが正常に終了しました");
}

上記のコードでは、i < 3という条件がfalseになった時点でループが終了します。

i++でカウンターが更新されるため、ループは3回で正常に終了します。

カウンター変数を確実に更新する

カウンター変数の更新を忘れると、ループの条件が変わらず、無限ループに陥ってしまうことがあります。

必ずi++やi += 1などでカウンターを更新し、終了条件に到達できるようにしましょう。

function main(workbook: ExcelScript.Workbook) { 
    let i: number = 0;

    while (i < 3) { // iが3未満の間、ループを継続
        console.log(`iの値: ${i}`); // iの現在値を出力
        i++; // カウンターを更新して無限ループを防ぐ
    }
}

上記の例ではi++がないため、iの値が変わらずにi < 3が永遠にtrueになり、無限ループが発生します。

ループ内でカウンターを確実に更新することで、このような事態を防ぐことができます。

break文で保険をかける

予期せぬ理由で終了条件がうまく機能せず、無限ループに陥る可能性がある場合は、break文を使って特定の条件でループを強制終了できるようにしておくと安心です。

例えば、カウンター変数が一定以上の値に達したら終了するように設定することができます。

function main(workbook: ExcelScript.Workbook) { 
    let i: number = 0;

    while (true) { // 本来の条件に関係なくループを実行
        console.log(`iの値: ${i}`);

        if (i >= 3) { // iが3以上ならループを強制終了
            console.log("breakでループを終了します");
            break; // ループを強制終了
        }
        i++; // カウンターを更新
    }
}

無限ループに入ってしまった場合の強制停止方法

万が一、無限ループに入ってスクリプトが停止しなくなった場合、Excel OnlineやOfficeスクリプトの実行を強制的に停止する必要があります。

以下は無限ループを強制停止する方法です。

注意ポイント2 : while文での処理順序に注意

while文は特定の条件がtrueである限り実行されるため、処理の順序が重要になります。

必要な操作が意図した順番で実行されていないと、次の処理が期待通りに進まなかったり、エラーが発生する可能性があります。

特に、順番がずれることで処理結果が変わる場合や、依存関係がある処理がうまく実行されない場合に注意が必要です。

コード例：while文での処理順序

以下の例では、「データ取得」→「条件の更新」→「次の処理」の順に整え、while文内での処理が意図した順序で進むようにしています。

function main(workbook: ExcelScript.Workbook) { 
    let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet(); 
    let i: number = 0;
    
    while (i < 3) { // iが3未満の間、ループを実行
        // データ取得を最初に実行
        let value: string | number | boolean = sheet.getRange(`A${i + 1}`).getValue();
        
        // 取得したデータに基づいて処理を行う
        if (value === "終了") { // "終了"という値が見つかった場合
            console.log("終了条件が見つかったため、ループを停止します");
            break; // 終了条件が満たされた場合にループを停止
        }

        // 次の処理のためにカウンターを更新
        i++;
    }
}

このコードでは、データの取得、条件の確認、次のループへの更新という順序で処理が進み、while文内の処理が意図通りの順序で実行されます。

Officeスクリプト「while文」の使用例をご紹介

それでは、OfficeスクリプトのFor分を使用した使用例を紹介します。

以下に紹介する使用例は、すべてコピペしてすぐに実行できるコードです。
気になる例は、ぜひご覧いただき、実際に実行してみてください。

Officeスクリプトの基礎から応用までを効率よくしっかり学習したい方には、UdemyのOfficeスクリプト講座もおすすめです。

特に自己学習で進める場合、ビデオや実践例があると理解が進みやすくなります。

【 Udemy 】Officeスクリプトのオススメ講座

使用例1: カウンター変数の条件が「false」になるまで繰り返す

この例では、Excelスクリプトのwhile文を使い、特定の条件が満たされるまでセルに値を順番に設定する方法を紹介します。

具体的には、カウンター変数iを用いて、Excelの「A1」から「A10」までのセルに0から9までの数値を順次入力します。

コード例 | while文による繰り返し処理

function main(workbook: ExcelScript.Workbook) { 
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // カウンター変数を初期化
  let i: number = 0;

  // カウンターが10未満である限り、ループを実行
  while (i < 10) {
    // セルにカウンターの値を設定
    sheet.getRange(`A${i + 1}`).setValue(i);
    // カウンターを更新
    i++;
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコード例では、while文を使用して特定の条件を満たすまで繰り返し処理を行い、Excelのセル範囲に値を入力しています。

while文によるループ処理は、動的な条件に基づく反復処理が必要な場面で特に有効です。

シンプルなカウンター変数「i」を用いることで、複雑な処理を行わずにExcelの自動化が可能になり、大量のデータ入力や指定範囲への操作を効率的に行うことができます。

使用例2: if文 (条件分岐) を組み合わせ繰り返し処理を行う

この例では、while文を使い、カウンター変数iに応じた条件分岐を行いながらExcelシートのセルに値を設定する方法を紹介します。

具体的には、カウンターiが偶数の場合のみセルに値を入力するような繰り返し処理を行います。

コード例 | while文による条件分岐付きの繰り返し処理

function main(workbook: ExcelScript.Workbook) { 
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // カウンター変数を初期化
  let i: number = 0;

  // カウンターが10未満である限り、ループを実行
  while (i < 10) {
    // iが偶数の場合のみ、セルに値を設定
    if (i % 2 === 0) {
      sheet.getRange(`A${i + 1}`).setValue(i);
    }
    // カウンターを更新
    i++;
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• if文 (条件分岐)
  • 特定の処理を実行するよう条件分岐を指定しています。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコード例では、while文の中で条件分岐を使用し、カウンター変数が偶数の場合のみセルに値を入力しています。

while文とif文を組み合わせることで、特定の条件に基づいたデータ入力が可能になり、Excelのセルに柔軟なデータ操作を行うことができます。

繰り返し処理を使って、特定のルールに沿ったデータ操作が自動化できるため、大量データの管理や入力を効率化する際に役立ちます。

使用例3: breakを使用してループを途中で終了する

この例では、while文の中でbreak文を使用し、カウンター変数iが特定の条件を満たしたときにループを強制終了する方法を紹介します。

具体的には、カウンターiが5に達した時点で、Excelシートのセル入力を中断します。

コード例 | break文によるループの途中終了

function main(workbook: ExcelScript.Workbook) { 
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // カウンター変数を初期化
  let i: number = 0;

  // カウンターが10未満である限り、ループを実行
  while (i < 10) {
    // セルにカウンターの値を設定
    sheet.getRange(`A${i + 1}`).setValue(i);
    
    // カウンターが5に達したらループを強制終了
    if (i === 5) {
      break;
    }
    
    // カウンターを更新
    i++;
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。
• break (ループの強制終了)
  • break文は、特定の条件を満たした際にループを中断するための命令です。

1行ずつコードを解説

総括・ポイント

このコードでは、while文の中でbreak文を使用し、カウンター変数が特定の条件を満たした際にループを強制終了しています。

特定の条件に基づいてループを途中で中断することで、柔軟な処理が可能となり、必要以上の処理を行わずに効率的な繰り返し処理が実現できます。

Excelでのデータ自動化やセル範囲の管理がスムーズに行えるようになります。

使用例4: continueを使用して特定の条件をスキップする

この例では、while文とcontinue文を使い、特定の条件に応じて処理をスキップする方法を紹介します。

具体的には、カウンター変数iが偶数の場合は処理をスキップし、奇数の値のみをExcelシート上のセルに入力します。

コード例 | continue文による特定条件のスキップ

function main(workbook: ExcelScript.Workbook) { 
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // カウンター変数を初期化
  let i: number = 0;

  // カウンターが10未満である限り、ループを実行
  while (i < 10) {
    i++; // カウンターを更新

    // iが偶数の場合はスキップ
    if (i % 2 === 0) {
      continue;
    }

    // 奇数のときのみセルに値を入力
    sheet.getRange(`A${i}`).setValue(i);
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• continue文 (特定条件でスキップ)
  • continue文は、現在のループの残りの処理をスキップし、次の反復に進む命令です。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコードでは、while文とcontinue文を組み合わせ、カウンター変数が偶数の場合には処理をスキップし、奇数の場合のみExcelのセルに値を入力しています。

continue文を使用することで、特定の条件に基づく処理のスキップが簡単に行え、Excelでのデータ入力やセル操作の柔軟性が向上します。

while文の反復処理とcontinue文による条件付きスキップにより、Excelのセル範囲に対する効率的なデータ操作が可能です。

使用例5: 配列の要素数だけ繰り返す

この例では、配列内の各要素をExcelシート上のセルに順番に入力します。

配列の長さ（要素数）に基づいてwhile文のループ回数を制御することで、柔軟にデータをシートへ書き込むことができます。

コード例 | 配列の要素数に基づいた繰り返し処理

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // 配列を定義（配列の型はnumber[]とする）
  let values: number[] = [10, 20, 30, 40, 50]; 

  // カウンター変数を初期化
  let i: number = 0;

  // 配列の長さだけループを実行
  while (i < values.length) {
    // 配列の要素を順にセルに設定
    sheet.getRange(`A${i + 1}`).setValue(values[i]);
    // カウンターを更新
    i++;
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• 配列.length (配列の長さ)
  • values.lengthで配列valuesの要素数を取得し、while文のループ回数を配列の長さに合わせています。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコード例では、while文を使って配列内の要素数に基づいて繰り返し処理を行い、Excelのセルに順次データを入力しています。

配列の要素数に応じた繰り返し処理は、データの自動入力や、柔軟なセル操作が求められる場合に役立ちます。

配列の要素数が変わってもコードの変更が不要で、柔軟性が高い実装となっています。

使用例6: オブジェクトのプロパティ数だけ繰り返す

この例では、オブジェクトの各プロパティをExcelシート上に入力する方法を紹介します。

オブジェクトのキーと値をそれぞれExcelのセルに分けて入力することで、オブジェクト内のデータを視覚化できます。

コード例 | オブジェクトのプロパティ数に基づいた繰り返し処理

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // オブジェクトを定義
  let data: { [key: string]: string | number } = {
    "Name": "Alice",
    "Age": 30,
    "City": "New York",
    "Occupation": "Engineer",
    "Experience": 5
  };

  // カウンター変数を初期化
  let i: number = 0;

  // オブジェクトのキーを配列に変換
  let keys: string[] = Object.keys(data);

  // オブジェクトのプロパティ数だけループを実行
  while (i < keys.length) {
    // 現在のキーを取得
    let key: string = keys[i];
    // 現在のキーに対応する値を取得
    let value: string | number = data[key];

    // キーをA列に、値をB列に設定
    sheet.getRange(`A${i + 1}`).setValue(key);
    sheet.getRange(`B${i + 1}`).setValue(value);

    // カウンターを更新
    i++;
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()は、Excelのアクティブなシートを取得するメソッドです。
• Object.keys() (オブジェクトのキー取得)
  • Object.keys(data)で、オブジェクトdataのすべてのキーを配列keysとして取得しています。
• getRange() (セル範囲の取得)
  • sheet.getRange(\A${i + 1}`)で、指定したセル範囲を取得します。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコード例では、オブジェクトのプロパティ数に基づいて繰り返し処理を行い、各プロパティのキーと値をExcelのセルに順次入力しています。

オブジェクトの各データをExcel上に整然と並べることで、データ管理や視覚化が容易になります。

Excelでの柔軟なデータ入力やオブジェクトデータの可視化に役立つ実装です。

この記事のまとめ

この記事では、Officeスクリプトの「while文」 を使った繰り返し処理について解説しました。

特定の条件が満たされるまで繰り返し処理を行う方法や、無限ループを防ぐポイント、効率的なループ制御の実現について学びました。

ポイントのおさらい

while文の基本を理解し、条件が満たされるまで繰り返し処理を行う方法を学びました。

さらに学ぶために

この記事で学んだwhile文をもとに、for文やforEach、mapなど他の繰り返し処理と組み合わせて、Excelでのデータ自動化や効率的な処理を追求してみましょう。

while文の動的な条件設定に加え、データの操作や条件分岐の方法を駆使することで、より柔軟な自動化スクリプトが実現できます。

あわせて読みたい

サイトマップ VBAOfficeスクリプトワークシート関数 VBA 基本設定 VBAとは？ VBAの始め方 VBAのおすすめ設定 セル操作 RangeとCells CurrentRegion Offset Resize 最終行・最終列の取...