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

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

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

매개변수

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

Return

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

승인

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

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

`matchCase(matchCase)`

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

매개변수

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

Return

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

승인

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

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

`matchEntireCell(matchEntireCell)`

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

매개변수

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

Return

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

승인

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

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

`matchFormulaText(matchFormulaText)`

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

매개변수

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

Return

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

승인

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

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

`replaceAllWith(replaceText)`

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

매개변수

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

Return

Integer: 교체된 횟수

승인

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

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

`replaceWith(replaceText)`

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

매개변수

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

Return

Integer: 교체된 횟수

승인

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

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

`startFrom(startRange)`

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

매개변수

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

Return

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

승인

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

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

`useRegularExpression(useRegEx)`

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

매개변수

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

Return

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

승인

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

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