이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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