Class TextFinder

TextFinder

Mencari atau mengganti teks dalam rentang, sheet, atau spreadsheet. Juga dapat menentukan opsi penelusuran.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
findAll()Range[]Menampilkan semua sel yang cocok dengan kriteria penelusuran.
findNext()RangeMenampilkan sel berikutnya yang cocok dengan kriteria penelusuran.
findPrevious()RangeMenampilkan sel sebelumnya yang cocok dengan kriteria penelusuran.
getCurrentMatch()RangeMenampilkan sel saat ini yang cocok dengan kriteria penelusuran.
ignoreDiacritics(ignoreDiacritics)TextFinderJika true, akan mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan cocok dengan diakritik.
matchCase(matchCase)TextFinderJika true, akan mengonfigurasi penelusuran agar sama persis dengan kapitalisasi teks penelusuran. Jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil.
matchEntireCell(matchEntireCell)TextFinderJika true, akan mengonfigurasi penelusuran agar cocok dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan sebagian.
matchFormulaText(matchFormulaText)TextFinderJika true, mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula; jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan.
replaceAllWith(replaceText)IntegerMengganti semua kecocokan dengan teks yang ditentukan.
replaceWith(replaceText)IntegerMengganti teks penelusuran dalam sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.
startFrom(startRange)TextFinderMengonfigurasi penelusuran untuk memulai penelusuran tepat setelah rentang sel yang ditentukan.
useRegularExpression(useRegEx)TextFinderJika true, akan mengonfigurasi penelusuran untuk menafsirkan string penelusuran sebagai ekspresi reguler; jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal.

Dokumentasi mendetail

findAll()

Menampilkan semua sel yang cocok dengan kriteria penelusuran.

Return

Range[] — Semua sel yang cocok.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

findNext()

Menampilkan sel berikutnya yang cocok dengan kriteria penelusuran.

Return

Range — Sel yang cocok berikutnya, atau null jika tidak ada kecocokan sebelumnya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

findPrevious()

Menampilkan sel sebelumnya yang cocok dengan kriteria penelusuran.

Return

Range — Sel yang cocok sebelumnya, atau null jika tidak ada kecocokan sebelumnya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentMatch()

Menampilkan sel saat ini yang cocok dengan kriteria penelusuran.

Return

Range — Sel yang cocok saat ini, atau null jika tidak ada kecocokan lebih lanjut.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

ignoreDiacritics(ignoreDiacritics)

Jika true, akan mengonfigurasi penelusuran untuk mengabaikan diakritik saat mencocokkan; jika tidak, penelusuran akan cocok dengan diakritik. Diakritik adalah tanda, seperti aksen atau cedilla, yang jika ditulis di atas atau di bawah huruf menunjukkan perbedaan pengucapan dari huruf yang sama jika tidak ditandai atau ditandai secara berbeda.

Parameter

NamaJenisDeskripsi
ignoreDiacriticsBooleanApakah penelusuran dianggap sebagai diakritik.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

matchCase(matchCase)

Jika true, akan mengonfigurasi penelusuran agar sama persis dengan kapitalisasi teks penelusuran. Jika tidak, penelusuran akan ditetapkan secara default ke pencocokan yang tidak peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
matchCaseBooleanApakah pencocokan peka huruf besar/kecil.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

matchEntireCell(matchEntireCell)

Jika true, akan mengonfigurasi penelusuran agar cocok dengan seluruh konten sel; jika tidak, penelusuran akan ditetapkan secara default ke pencocokan sebagian.

Parameter

NamaJenisDeskripsi
matchEntireCellBooleanApakah seluruh sel dicocokkan.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

matchFormulaText(matchFormulaText)

Jika true, mengonfigurasi penelusuran untuk menampilkan kecocokan yang muncul dalam teks formula; jika tidak, sel dengan formula akan dipertimbangkan berdasarkan nilai yang ditampilkan.

Parameter

NamaJenisDeskripsi
matchFormulaTextBooleanApakah penelusuran memeriksa teks formula.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

replaceAllWith(replaceText)

Mengganti semua kecocokan dengan teks yang ditentukan. Menampilkan jumlah kemunculan yang diganti, yang mungkin berbeda dari jumlah sel yang cocok.

Parameter

NamaJenisDeskripsi
replaceTextStringTeks yang menggantikan teks dalam sel yang cocok.

Return

Integer — Jumlah kemunculan yang diganti.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

replaceWith(replaceText)

Mengganti teks penelusuran dalam sel yang saat ini cocok dengan teks yang ditentukan dan menampilkan jumlah kemunculan yang diganti.

Parameter

NamaJenisDeskripsi
replaceTextStringTeks yang menggantikan konten dalam sel yang saat ini cocok.

Return

Integer — Jumlah kemunculan yang diganti.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

startFrom(startRange)

Mengonfigurasi penelusuran untuk memulai penelusuran tepat setelah rentang sel yang ditentukan.

Parameter

NamaJenisDeskripsi
startRangeRangeRentang sel yang digunakan setelah penelusuran akan dimulai.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

useRegularExpression(useRegEx)

Jika true, akan mengonfigurasi penelusuran untuk menafsirkan string penelusuran sebagai ekspresi reguler; jika tidak, penelusuran akan menafsirkan string penelusuran sebagai teks normal. Untuk detail selengkapnya tentang cara menggunakan ekspresi reguler, lihat Halaman dukungan cari dan ganti.

Parameter

NamaJenisDeskripsi
useRegExBooleanApakah akan menafsirkan string penelusuran sebagai ekspresi reguler.

Return

TextFinder — Pencari teks ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets