범위, 시트 또는 스프레드시트 내에서 텍스트를 찾거나 바꿉니다. 검색 옵션을 지정할 수도 있습니다.
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
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()
findNext()
findPrevious()
getCurrentMatch()
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