이 페이지는 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