Class TextFinder

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Поиск текста

Поиск или замена текста в пределах диапазона, листа или электронной таблицы. Можно также указать параметры поиска.

Методы

Метод Тип возврата Краткое описание
findAll() Range[] Возвращает все ячейки, соответствующие критериям поиска.
findNext() Range Возвращает следующую ячейку, соответствующую критериям поиска.
findPrevious() Range Возвращает предыдущую ячейку, соответствующую критериям поиска.
getCurrentMatch() Range Возвращает текущую ячейку, соответствующую критериям поиска.
ignoreDiacritics(ignoreDiacritics) TextFinder Если true , поиск игнорирует диакритические знаки при сопоставлении; в противном случае поиск соответствует диакритическим знакам.
matchCase(matchCase) TextFinder Если задано значение true , поиск точно соответствует регистру искомого текста, в противном случае поиск по умолчанию выполняется без учета регистра.
matchEntireCell(matchEntireCell) TextFinder Если true , поиск настраивается на соответствие всему содержимому ячейки; в противном случае по умолчанию используется частичное совпадение.
matchFormulaText(matchFormulaText) TextFinder Если задано значение true , поиск настраивается на возврат совпадений, которые появляются в тексте формулы; в противном случае ячейки с формулами рассматриваются на основе их отображаемого значения.
replaceAllWith(replaceText) Integer Заменяет все совпадения указанным текстом.
replaceWith(replaceText) Integer Заменяет текст поиска в текущей совпадающей ячейке указанным текстом и возвращает количество замененных вхождений.
startFrom(startRange) TextFinder Настраивает поиск, чтобы начать поиск сразу после указанного диапазона ячеек.
useRegularExpression(useRegEx) TextFinder Если задано значение true , поиск настраивается на интерпретацию строки поиска как регулярное выражение; в противном случае поиск интерпретирует строку поиска как обычный текст.

Подробная документация

findAll()

Возвращает все ячейки, соответствующие критериям поиска.

Возвращаться

Range[] — все совпадающие ячейки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

findNext()

Возвращает следующую ячейку, соответствующую критериям поиска.

Возвращаться

Range — следующая совпадающая ячейка или null , если предыдущих совпадений нет.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

findPrevious()

Возвращает предыдущую ячейку, соответствующую критериям поиска.

Возвращаться

Range — предыдущая совпадающая ячейка или null , если предыдущих совпадений нет.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

getCurrentMatch()

Возвращает текущую ячейку, соответствующую критериям поиска.

Возвращаться

Range — текущая совпадающая ячейка или null , если больше нет совпадений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

ignoreDiacritics(ignoreDiacritics)

Если true , поиск игнорирует диакритические знаки при сопоставлении; в противном случае поиск соответствует диакритическим знакам. Диакритический знак — это знак, такой как ударение или седиль, который, если он написан над или под буквой, указывает на разницу в произношении той же буквы, когда она не отмечена или отмечена по-другому.

Параметры

Имя Тип Описание
ignoreDiacritics Boolean Учитывает ли поиск диакритические знаки.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

matchCase(matchCase)

Если задано значение true , поиск точно соответствует регистру искомого текста, в противном случае поиск по умолчанию выполняется без учета регистра.

Параметры

Имя Тип Описание
matchCase Boolean Является ли сопоставление чувствительным к регистру.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

matchEntireCell(matchEntireCell)

Если true , поиск настраивается на соответствие всему содержимому ячейки; в противном случае по умолчанию используется частичное совпадение.

Параметры

Имя Тип Описание
matchEntireCell Boolean Сопоставлена ​​ли вся ячейка.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

matchFormulaText(matchFormulaText)

Если задано значение true , поиск настраивается на возврат совпадений, которые появляются в тексте формулы; в противном случае ячейки с формулами рассматриваются на основе их отображаемого значения.

Параметры

Имя Тип Описание
matchFormulaText Boolean Проверяет ли поиск текст формулы.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

replaceAllWith(replaceText)

Заменяет все совпадения указанным текстом. Возвращает количество замененных вхождений, которое может отличаться от количества совпадающих ячеек.

Параметры

Имя Тип Описание
replaceText String Текст, который заменяет текст в соответствующих ячейках.

Возвращаться

Integer — Количество замененных вхождений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

replaceWith(replaceText)

Заменяет текст поиска в текущей совпадающей ячейке указанным текстом и возвращает количество замененных вхождений.

Параметры

Имя Тип Описание
replaceText String Текст, который заменяет содержимое в текущей соответствующей ячейке.

Возвращаться

Integer — Количество замененных вхождений.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

startFrom(startRange)

Настраивает поиск, чтобы начать поиск сразу после указанного диапазона ячеек.

Параметры

Имя Тип Описание
startRange Range Диапазон ячеек, после которого должен начаться поиск.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

useRegularExpression(useRegEx)

Если задано значение true , поиск настраивается на интерпретацию строки поиска как регулярное выражение; в противном случае поиск интерпретирует строку поиска как обычный текст. Дополнительные сведения об использовании регулярных выражений см. на странице поддержки «Найти и заменить».

Параметры

Имя Тип Описание
useRegEx Boolean Следует ли интерпретировать строку поиска как регулярное выражение.

Возвращаться

TextFinder — это средство поиска текста для цепочки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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