Class TextFinder

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