文字列の検索

ここではオフィススクリプトを使って、文字列に特定の文字が含まれているかを調べる方法と、見つかった位置を使って区切り文字の前後を切り出す方法を、サンプルコードと併せて解説します。

VBA との違い: 位置は 0 から始まり、見つからない場合は -1

VBA のInStr関数は、見つかった位置を 1 から始まる番号で返し、見つからない場合は0を返していました。

Office スクリプトのindexOfメソッドは、見つかった位置を 0 から始まる番号で返し、見つからない場合は -1 を返します。0は「先頭で見つかった」という意味になるため、VBA と同じ感覚で0と比較すると誤った判定になります。

含まれているかどうかを調べる

利用するメソッド

位置は不要で、含まれているかどうかだけを知りたい場合は、Stringオブジェクトに含まれているincludesメソッドを使用します。

/**
 * @param searchString 検索する文字列
 * @param position 検索を始める位置(省略時は 0)
 * @return 含まれている場合は true
 */
includes(searchString: string, position?: number): boolean;

サンプルコード

文字列が含まれているか調べるサンプル

function main(workbook: ExcelScript.Workbook) {
  /** 対象文字列 */
  const mail = 'sato@example.jp';

  if (mail.includes('@')) {
    console.log('@が含まれています');
  }
}

見つかった位置を調べる

利用するメソッド

見つかった位置を知りたい場合は、Stringオブジェクトに含まれているindexOfメソッドを使用します。

/**
 * @param searchString 検索する文字列
 * @param position 検索を始める位置(省略時は 0)
 * @return 最初に見つかった位置(0 から始まる)。見つからない場合は -1
 */
indexOf(searchString: string, position?: number): number;

複数の箇所で見つかる場合は、最初に見つかった位置が返されます。最後に見つかった位置を調べる場合は、lastIndexOfメソッドを使用します。

console.log('リンゴミカンバナナ'.indexOf('ミカン')); // 3
console.log('リンゴミカンリンゴ'.indexOf('リンゴ', 1)); // 6(インデックス 1 = 2 文字目以降で検索)
console.log('リンゴミカンバナナ'.indexOf('ブドウ')); // -1

区切り文字の前後を切り出す

indexOfで調べた位置をsliceメソッドに渡すと、区切り文字の前後を切り出せます。

例えばsato@example.jpの@は先頭から 5 文字目(インデックスは 4)にあるため、indexOf('@')は4を返します。

• @より前: slice(0, 4)(終了位置の文字は含まれないため、@の手前までになる)
• @より後: slice(5)(@の位置に 1 を足した位置から最後まで)

開始位置・終了位置を変えて、切り出される範囲を確かめてみましょう。

StartEndOmit end

Index	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14
Character	s	a	t	o	@	e	x	a	m	p	l	e	.	j	p
From end	-15	-14	-13	-12	-11	-10	-9	-8	-7	-6	-5	-4	-3	-2	-1

Resultmail.slice(0, 4)→'sato'

Change the values to see which characters are extracted.

サンプルコード

メールアドレスを@の前後で、ユーザー名とドメインに分けるサンプルコードです。

区切り文字の前後を切り出すサンプル

function main(workbook: ExcelScript.Workbook) {
  /** 対象文字列 */
  const mail = 'sato@example.jp';

  /** @ の位置 */
  const atIndex = mail.indexOf('@');

  if (atIndex === -1) {
    throw `${mail}に@が含まれていません`;
  }

  /** ユーザー名(@ より前) */
  const user = mail.slice(0, atIndex);
  /** ドメイン(@ より後) */
  const domain = mail.slice(atIndex + 1);

  console.log(user); // sato
  console.log(domain); // example.jp
}

見つからなかった場合の確認を忘れない

サンプルコードでは、@が見つからなかった場合にエラーをスローしています。

この確認を省略すると、indexOfが返した-1がそのままsliceに渡されます。sliceは負数を「後ろから数えた位置」として扱うため、エラーにならずに最後の 1 文字だけが欠けた文字列が返されてしまいます。

以下は@を含まないsato.example.jpに対してslice(0, -1)を実行した場合の結果です。

StartEndOmit end

Index	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14
Character	s	a	t	o	.	e	x	a	m	p	l	e	.	j	p
From end	-15	-14	-13	-12	-11	-10	-9	-8	-7	-6	-5	-4	-3	-2	-1

Resultmail.slice(0, -1)→'sato.example.j'

• The End -1 counts back from the end and is treated as 14.

Change the values to see which characters are extracted.

エラーにならないため、気付かないまま誤ったデータを書き込んでしまう恐れがあります。indexOfの結果を使う前には、必ず-1でないことを確認しましょう。

最後の区切り文字で分ける

ファイル名から拡張子を取り出す場合など、区切り文字が複数含まれていて最後の 1 つで分けたい場合は、lastIndexOfメソッドを使用します。

data.2026.xlsxに対してindexOf('.')を使うと最初の.の位置である4が返されますが、lastIndexOf('.')を使うと最後の.の位置である9が返されます。

拡張子は.の次の文字から始まるため、切り出しの開始位置は9 + 1で10になります。

StartEndOmit end

Index	0	1	2	3	4	5	6	7	8	9	10	11	12	13
Character	d	a	t	a	.	2	0	2	6	.	x	l	s	x
From end	-14	-13	-12	-11	-10	-9	-8	-7	-6	-5	-4	-3	-2	-1

Resultfilename.slice(10)→'xlsx'

Change the values to see which characters are extracted.

拡張子を取り出すサンプル

function main(workbook: ExcelScript.Workbook) {
  /** 対象のファイル名 */
  const filename = 'data.2026.xlsx';

  /** 最後の . の位置 */
  const dotIndex = filename.lastIndexOf('.');

  if (dotIndex === -1) {
    throw `${filename}には拡張子がありません`;
  }

  console.log(filename.slice(0, dotIndex)); // data.2026
  console.log(filename.slice(dotIndex + 1)); // xlsx
}

文字列の切り出しオフィススクリプトを使って、VBA における Left, Mid, Right に相当する、文字列を切り出す方法をサンプルコードと併せて解説します。

正規表現正規表現を使った文字列の一致チェックや、文字列の置換・分割など、Officeスクリプトにおける正規表現の体系的な使用方法について解説します。