범위, 시트 또는 스프레드시트 내에서 텍스트를 찾거나 바꿉니다. 검색 옵션을 지정할 수도 있습니다.
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
find | Range[] | 검색 기준과 일치하는 모든 셀을 반환합니다. |
find | Range | 검색 기준과 일치하는 다음 셀을 반환합니다. |
find | Range | 검색 기준과 일치하는 이전 셀을 반환합니다. |
get | Range | 검색 기준과 일치하는 현재 셀을 반환합니다. |
ignore | Text | true인 경우 일치하는 동안 검색에서 발음 구별 기호를 무시하도록 구성합니다. 그렇지 않으면 검색에서 발음 구별 기호를 일치시킵니다. |
match | Text | true는 검색 텍스트의 대소문자와 정확하게 일치하도록 검색을 구성합니다. 그렇지 않으면 검색은 기본적으로 대소문자를 구분하지 않는 일치로 설정됩니다. |
match | Text | true인 경우 셀의 전체 콘텐츠와 일치하도록 검색을 구성합니다. 그렇지 않으면 검색이 기본적으로 부분 일치로 설정됩니다. |
match | Text | true인 경우 수식 텍스트 내에 표시되는 일치 항목을 반환하도록 검색을 구성합니다. 그렇지 않으면 수식이 있는 셀이 표시된 값을 기반으로 간주됩니다. |
replace | Integer | 모든 일치 항목을 지정된 텍스트로 바꿉니다. |
replace | Integer | 현재 일치하는 셀의 검색 텍스트를 지정된 텍스트로 대체하고 대체된 항목 수를 반환합니다. |
start | Text | 지정된 셀 범위 바로 뒤에서 검색을 시작하도록 검색을 구성합니다. |
use | Text | true인 경우 검색 문자열을 정규 표현식으로 해석하도록 검색을 구성합니다. 그렇지 않으면 검색 문자열을 일반 텍스트로 해석합니다. |
자세한 문서
findAll()
findNext()
findPrevious()
getCurrentMatch()
ignoreDiacritics(ignoreDiacritics)
true인 경우 일치하는 동안 검색에서 발음 구별 기호를 무시하도록 구성합니다. 그렇지 않으면 검색에서 발음 구별 기호를 일치시킵니다. 발음 구별 기호는 악센트나 세딜라와 같은 기호로, 글자 위나 아래에 쓰여 표시가 없거나 다르게 표시된 동일한 글자와 발음이 다르다는 것을 나타냅니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
ignore | Boolean | 검색에서 발음 구별 기호를 고려하는지 여부입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchCase(matchCase)
true는 검색 텍스트의 대소문자와 정확하게 일치하도록 검색을 구성합니다. 그렇지 않으면 검색은 기본적으로 대소문자를 구분하지 않는 일치로 설정됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
match | Boolean | 일치 여부에서 대소문자를 구분하는지 여부입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchEntireCell(matchEntireCell)
true인 경우 셀의 전체 콘텐츠와 일치하도록 검색을 구성합니다. 그렇지 않으면 검색이 기본적으로 부분 일치로 설정됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
match | Boolean | 전체 셀이 일치하는지 여부입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
matchFormulaText(matchFormulaText)
true인 경우 수식 텍스트 내에 표시되는 일치 항목을 반환하도록 검색을 구성합니다. 그렇지 않으면 수식이 있는 셀이 표시된 값을 기반으로 간주됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
match | Boolean | 검색에서 수식 텍스트를 검사하는지 여부입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceAllWith(replaceText)
모든 일치 항목을 지정된 텍스트로 바꿉니다. 바뀐 항목의 수를 반환합니다. 이 수는 일치하는 셀의 수와 다를 수 있습니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
replace | String | 일치하는 셀의 텍스트를 대체하는 텍스트입니다. |
리턴
Integer - 대체된 항목 수입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
replaceWith(replaceText)
현재 일치하는 셀의 검색 텍스트를 지정된 텍스트로 대체하고 대체된 항목 수를 반환합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
replace | String | 현재 일치하는 셀의 콘텐츠를 대체하는 텍스트입니다. |
리턴
Integer - 대체된 항목 수입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
startFrom(startRange)
지정된 셀 범위 바로 뒤에서 검색을 시작하도록 검색을 구성합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
start | Range | 검색을 시작해야 하는 셀 범위입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
useRegularExpression(useRegEx)
true인 경우 검색 문자열을 정규 표현식으로 해석하도록 검색을 구성합니다. 그렇지 않으면 검색 문자열을 일반 텍스트로 해석합니다. 정규 표현식을 사용하는 방법에 관한 자세한 내용은
찾기 및 바꾸기 지원 페이지를 참고하세요.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
use | Boolean | 검색 문자열을 정규 표현식으로 해석할지 여부입니다. |
리턴
TextFinder - 연결을 위한 이 텍스트 파인더
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets