Class 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()

검색 기준과 일치하는 모든 셀을 반환합니다.

Return

Range[] — 일치하는 모든 셀입니다.

승인

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

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

findNext()

검색 기준과 일치하는 다음 셀을 반환합니다.

Return

Range - 일치하는 다음 셀 또는 이전 일치 항목이 없는 경우 null

승인

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

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

findPrevious()

검색 기준과 일치하는 이전 셀을 반환합니다.

Return

Range: 일치하는 이전 셀 또는 일치하는 이전 항목이 없는 경우 null

승인

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

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

getCurrentMatch()

검색 기준과 일치하는 현재 셀을 반환합니다.

Return

Range: 현재 일치하는 셀 또는 일치하는 추가 값이 없는 경우 null입니다.

승인

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

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

ignoreDiacritics(ignoreDiacritics)

true인 경우 일치하는 동안에 같은 발음 구별 부호를 무시하도록 검색을 구성합니다. 그렇지 않은 경우 같은 발음 구별 부호와 일치시킵니다. 발음 구별 부호는 악센트 또는 세디야와 같은 기호로, 문자의 위 또는 아래에 쓰면 같은 글자의 표기가 없거나 달리 표시되어 있을 때 같은 문자의 발음 차이가 있음을 나타냅니다.

매개변수

이름유형설명
ignoreDiacriticsBoolean검색어가 발음 구별 부호로 간주되는지 나타냅니다.

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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

matchCase(matchCase)

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

매개변수

이름유형설명
matchCaseBoolean일치 여부를 대소문자를 구분합니다.

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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

matchEntireCell(matchEntireCell)

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

매개변수

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

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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

matchFormulaText(matchFormulaText)

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

매개변수

이름유형설명
matchFormulaTextBoolean검색 시 수식 텍스트 검사 여부입니다.

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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

replaceAllWith(replaceText)

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

매개변수

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

Return

Integer: 교체된 횟수

승인

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

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

replaceWith(replaceText)

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

매개변수

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

Return

Integer: 교체된 횟수

승인

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

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

startFrom(startRange)

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

매개변수

이름유형설명
startRangeRange검색을 시작해야 하는 셀 범위입니다.

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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

useRegularExpression(useRegEx)

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

매개변수

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

Return

TextFinder: 체이닝을 위한 텍스트 파인더입니다.

승인

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

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