【GAS】スプレッドシートで検索条件に一致する全てのセルを返す

GASでスプレッドシートで検索条件に一致する全てのセルを返すには「findAll()」を利用する。

findAll()
検索条件に一致する次のセルを返します。
https://developers.google.com/apps-script/reference/spreadsheet/text-finder#findall

スプレッドシートで検索条件に一致する全てのセルを返すGAS実行の様子

findAll()メソッドを利用して、スプレッドシートで検索条件に一致する全てのセルを返すGASを実行してみました。

findAll()で全ての検索セルを取得する場合、forなどで繰返し処理を行って取得する必要があります。

findNext()メソッドで検索条件に一致するセルを返す場合は、以下記事を御覧ください。

参照記事：【GAS】スプレッドシートで検索条件に一致するセルを返す

スプレッドシートで検索条件に一致する全てのセルを返すGAS

function sheetdelete(){
  //SpreadsheetAppを起動
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sht = ss.getSheets()[0];
  //見出し作成
  var text = [
    ["これは","文字を","検索する","テストです"]
  ];
  sht.getRange("A1:D1")
      .setValues(text)
      .setFontWeight("bold").setFontSize(16);
　//繰返しテキストを変数へ格納
  var array1,array2,array3
    array1 = "Spread";
    array2 = "Sheet";
    array3 = ".BLUE";
    array4 = "補足";
　//変数を繰り返しA~D列の101行目まで入力
  for(let i=2;i<=101;i++){
    sht.getRange(i,1).setValue(array1);//101行目までarray1をセット
    sht.getRange(i,2).setValue(array2);//101行目までarray2をセット
    sht.getRange(i,3).setValue(array3);//101行目までarray3をセット
    var array =　array1+array2+array3;  //配列テキストの合体！
    sht.getRange(i,4).setValue(array+(i-1));//101行目まで連番でセット
    sht.getRange(i,5).setValue(array4+(i-1));//101行目まで連番でセット
  }
　
　//変数txtへあいうえおを格納して適当な位置へ設置
　var txt = "検索文字";
    sht.getRange(4,3).setValue(txt);
    sht.getRange(10,3).setValue(txt);
    sht.getRange(30,2).setValue(txt);
　//YESNOでテキスト検索するか確認
　var yesno = Browser.msgBox("文字"+txt+"がどこにあるか検索しますか？",Browser.Buttons.YES_NO_CANCEL);
  if(yesno == "yes"){
    //createTextFinderで文字を検索
    var txtfind = ss.createTextFinder(txt);
    //■finAllですべての検索結果を取得する
    var rngs = txtfind.findAll();
    //全ての検索結果をA1形式で取得する
    for(let i in rngs){
      //actrngへA1形式で値を取得
      var actrng = rngs[i].getA1Notation();
    // メッセージでtxtの取得回数と取得位置を掲載
    Browser.msgBox(txt+"があるセルの"+(Number(i)+1)+"つ目は「"+actrng+"」です!");
    }
  } else {
    // キャンセルした旨を掲載
    Browser.msgBox("検索はキャンセルしました");
  }
}