Class TextFinder

텍스트Finder

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

메서드

메서드반환 유형간략한 설명
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