範囲、シート、スプレッドシート内のテキストを検索または置換します。検索オプションを指定することもできます。
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
find | Range[] | 検索条件に一致するすべてのセルを返します。 |
find | Range | 検索条件に一致する次のセルを返します。 |
find | Range | 検索条件に一致する前のセルを返します。 |
get | Range | 検索条件に一致する現在のセルを返します。 |
ignore | Text | true の場合、照合中にアクセント記号を無視するように検索を構成します。それ以外の場合、検索はアクセント記号と一致します。 |
match | Text | true の場合、検索テキストの大文字と小文字を完全に一致させるように検索を構成します。それ以外の場合は、検索はデフォルトで大文字と小文字を区別しない照合になります。 |
match | Text | true の場合、セルの内容全体と一致するように検索を構成します。それ以外の場合は、検索はデフォルトで部分一致になります。 |
match | Text | true の場合、数式のテキスト内に表示される一致を返すように検索を構成します。それ以外の場合は、数式を含むセルは表示される値に基づいて考慮されます。 |
replace | Integer | 一致したすべてのテキストを指定されたテキストに置き換えます。 |
replace | Integer | 現在一致しているセル内の検索テキストを指定されたテキストに置き換え、置換された回数を返します。 |
start | Text | 指定したセル範囲の直後に検索を開始するように検索を構成します。 |
use | Text | true の場合、検索文字列を正規表現として解釈するように検索を構成します。それ以外の場合は、検索文字列を通常のテキストとして解釈します。 |
詳細なドキュメント
find
find
find
get
ignore
true の場合、照合中にアクセント記号を無視するように検索を構成します。それ以外の場合、検索はアクセント記号と一致します。アクセント記号は、アクセント記号やセディラなどの記号で、文字の上にまたは下に書かれると、同じ文字にアクセント記号が付いていないときや、別のアクセント記号が付いているときとは発音が異なることを示します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
ignore | Boolean | 検索でアクセント記号を考慮するかどうか。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
true の場合、検索テキストの大文字と小文字を完全に一致させるように検索を構成します。それ以外の場合は、検索はデフォルトで大文字と小文字を区別しない照合になります。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
match | Boolean | 大文字と小文字が区別されるかどうか。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
true の場合、セルの内容全体と一致するように検索を構成します。それ以外の場合は、検索はデフォルトで部分一致になります。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
match | Boolean | セル全体が一致するかどうか。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
match
true の場合、数式のテキスト内に表示される一致を返すように検索を構成します。それ以外の場合は、数式を含むセルは表示される値に基づいて考慮されます。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
match | Boolean | 検索で数式のテキストを調べるかどうか。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replace
一致したすべてのテキストを指定されたテキストに置き換えます。置換された回数を返します。一致したセルの数とは異なる場合があります。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
replace | String | 一致したセルのテキストに置き換えるテキスト。 |
戻る
Integer - 置換された回数。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replace
現在一致しているセル内の検索テキストを指定されたテキストに置き換え、置換された回数を返します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
replace | String | 現在一致しているセルのコンテンツに置き換えるテキスト。 |
戻る
Integer - 置換された回数。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
start
指定したセル範囲の直後に検索を開始するように検索を構成します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
start | Range | 検索を開始するセル範囲。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
use
true の場合、検索文字列を正規表現として解釈するように検索を構成します。それ以外の場合は、検索文字列を通常のテキストとして解釈します。正規表現の使用方法について詳しくは、
検索と置換のサポートページをご覧ください。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
use | Boolean | 検索文字列を正規表現として解釈するかどうか。 |
戻る
Text - チェーン用のテキスト検索ツール。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets