Class TextFinder

TextFinder

범위, 시트 또는 스프레드시트 내에서 텍스트를 찾거나 바꿉니다. 검색 옵션을 지정할 수도 있습니다.

방법

메서드반환 유형간략한 설명
findAll()Range[]검색 기준과 일치하는 모든 셀을 반환합니다.
findNext()Range검색 기준과 일치하는 다음 셀을 반환합니다.
findPrevious()Range검색 기준과 일치하는 이전 셀을 반환합니다.
getCurrentMatch()Range검색 기준과 일치하는 현재 셀을 반환합니다.
ignoreDiacritics(ignoreDiacritics)TextFindertrue인 경우 일치 시 발음 구별 부호를 무시하도록 검색을 구성합니다. 그렇지 않으면 검색이 발음 구별 부호와 일치합니다.
matchCase(matchCase)TextFindertrue인 경우 검색 텍스트의 대소문자와 정확하게 일치하도록 검색을 구성합니다. 그렇지 않으면 기본적으로 대소문자를 구분하지 않는 일치를 사용합니다.
matchEntireCell(matchEntireCell)TextFindertrue인 경우 셀의 전체 내용과 일치하도록 검색을 구성합니다. 그렇지 않으면 기본적으로 부분 일치가 수행됩니다.
matchFormulaText(matchFormulaText)TextFindertrue인 경우 수식 텍스트 내에 표시되는 일치 항목을 반환하도록 검색을 구성합니다. 그렇지 않으면 수식이 있는 셀은 표시된 값을 기준으로 고려됩니다.
replaceAllWith(replaceText)Integer모든 일치 항목을 지정된 텍스트로 바꿉니다.
replaceWith(replaceText)Integer현재 일치하는 셀의 검색 텍스트를 지정된 텍스트로 바꾸고 대체된 일치하는 항목 수를 반환합니다.
startFrom(startRange)TextFinder지정된 셀 범위 바로 뒤에 검색을 시작하도록 검색을 구성합니다.
useRegularExpression(useRegEx)TextFindertrue인 경우 검색 문자열을 정규 표현식으로 해석하도록 검색을 구성합니다. 그렇지 않으면 검색 문자열을 일반 텍스트로 해석합니다.

자세한 문서

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인 경우 일치 시 발음 구별 부호를 무시하도록 검색을 구성합니다. 그렇지 않으면 검색이 발음 구별 부호와 일치합니다. 발음 구별 부호는 악센트 또는 세딜라와 같은 기호로, 문자 위나 아래에 쓰일 때 표시가 없거나 다르게 표시된 경우 같은 문자와 발음이 다르다는 것을 나타냅니다.

매개변수

이름유형설명
ignoreDiacriticsBoolean검색에서 발음 구별 부호를 고려하는지 여부입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

matchCase(matchCase)

true인 경우 검색 텍스트의 대소문자와 정확하게 일치하도록 검색을 구성합니다. 그렇지 않으면 기본적으로 대소문자를 구분하지 않는 일치를 사용합니다.

매개변수

이름유형설명
matchCaseBoolean일치가 대소문자를 구분하는지 여부입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

matchEntireCell(matchEntireCell)

true인 경우 셀의 전체 내용과 일치하도록 검색을 구성합니다. 그렇지 않으면 기본적으로 부분 일치가 수행됩니다.

매개변수

이름유형설명
matchEntireCellBoolean전체 셀이 일치하는지 여부입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

matchFormulaText(matchFormulaText)

true인 경우 수식 텍스트 내에 표시되는 일치 항목을 반환하도록 검색을 구성합니다. 그렇지 않으면 수식이 있는 셀은 표시된 값을 기준으로 고려됩니다.

매개변수

이름유형설명
matchFormulaTextBoolean검색에서 수식 텍스트를 검사할지 여부입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

replaceAllWith(replaceText)

모든 일치 항목을 지정된 텍스트로 바꿉니다. 대체된 일치하는 셀의 수와 다를 수 있는 일치하는 항목 수를 반환합니다.

매개변수

이름유형설명
replaceTextString일치하는 셀의 텍스트를 대체하는 텍스트입니다.

리턴

Integer - 대체된 일치하는 항목의 수입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

replaceWith(replaceText)

현재 일치하는 셀의 검색 텍스트를 지정된 텍스트로 바꾸고 대체된 일치하는 항목 수를 반환합니다.

매개변수

이름유형설명
replaceTextString현재 일치하는 셀의 콘텐츠를 대체하는 텍스트입니다.

리턴

Integer - 대체된 일치하는 항목의 수입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

startFrom(startRange)

지정된 셀 범위 바로 뒤에 검색을 시작하도록 검색을 구성합니다.

매개변수

이름유형설명
startRangeRange검색을 시작할 셀 범위입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

useRegularExpression(useRegEx)

true인 경우 검색 문자열을 정규 표현식으로 해석하도록 검색을 구성합니다. 그렇지 않으면 검색 문자열을 일반 텍스트로 해석합니다. 정규 표현식 사용 방법에 대한 자세한 내용은 찾기 및 바꾸기 지원 페이지를 참조하세요.

매개변수

이름유형설명
useRegExBoolean검색 문자열을 정규 표현식으로 해석할지 여부입니다.

리턴

TextFinder - 체이닝용 텍스트 검색기입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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