Class TextFinder

TextFinder

किसी रेंज, शीट या स्प्रेडशीट में टेक्स्ट ढूंढें या बदलें. खोज के विकल्प भी तय किए जा सकते हैं.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
findAll()Range[]खोज की शर्तों से मेल खाने वाले सभी सेल दिखाता है.
findNext()Rangeखोज की शर्तों से मेल खाने वाली अगली सेल दिखाता है.
findPrevious()Rangeखोज की शर्तों से मेल खाने वाली पिछली सेल दिखाता है.
getCurrentMatch()Rangeखोज की शर्तों से मेल खाने वाली मौजूदा सेल दिखाता है.
ignoreDiacritics(ignoreDiacritics)TextFinderअगर true है, तो मैच करते समय विशेषकों को अनदेखा करने के लिए खोज को कॉन्फ़िगर करता है. ऐसा नहीं होने पर खोज, खास तरह के चिह्नों से मेल खाती है.
matchCase(matchCase)TextFindertrue होने पर, खोज को खोज के टेक्स्ट के केस से पूरी तरह मैच करने के लिए, खोज को कॉन्फ़िगर करता है. ऐसा न होने पर, खोज डिफ़ॉल्ट रूप से केस-इनसेंसिटिव मैचिंग होती है.
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 है, तो मैच करते समय विशेषकों को अनदेखा करने के लिए खोज को कॉन्फ़िगर करता है. ऐसा नहीं होने पर खोज, खास तरह के चिह्नों से मेल खाती है. डायाक्रिटिक एक संकेत होता है, जैसे कि एक एक्सेंट या सेडिला. इसे किसी अक्षर के ऊपर या नीचे लिखने पर, चिह्न हटाए जाने या अलग तरह से मार्क किए जाने पर, उसी अक्षर के उच्चारण में अंतर का पता चलता है.

पैरामीटर

नामTypeब्यौरा
ignoreDiacriticsBooleanक्या खोज विशेषकों पर विचार करती है.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

matchCase(matchCase)

true होने पर, खोज को खोज के टेक्स्ट के केस से पूरी तरह मैच करने के लिए, खोज को कॉन्फ़िगर करता है. ऐसा न होने पर, खोज डिफ़ॉल्ट रूप से केस-इनसेंसिटिव मैचिंग होती है.

पैरामीटर

नामTypeब्यौरा
matchCaseBooleanमैचिंग, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

matchEntireCell(matchEntireCell)

अगर true है, तो खोज को सेल के पूरे कॉन्टेंट से मैच कराने के लिए कॉन्फ़िगर करता है. ऐसा न होने पर, खोज डिफ़ॉल्ट रूप से कुछ हद तक मैच करने वाली वैल्यू पर सेट होती है.

पैरामीटर

नामTypeब्यौरा
matchEntireCellBooleanपूरी सेल मेल खाती है या नहीं.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

matchFormulaText(matchFormulaText)

अगर true, खोज को कॉन्फ़िगर करता है, तो फ़ॉर्मूला टेक्स्ट में दिखने वाले मिलते-जुलते नतीजे दिखाता है. ऐसा न करने पर, फ़ॉर्मूला वाली सेल को उनकी दिखाई गई वैल्यू के आधार पर गिना जाता है.

पैरामीटर

नामTypeब्यौरा
matchFormulaTextBooleanखोज के दौरान, फ़ॉर्मूला टेक्स्ट की जांच की जाती है या नहीं.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

replaceAllWith(replaceText)

सभी मैच को चुने गए टेक्स्ट से बदलता है. बदली गई घटनाओं की संख्या देता है जो मेल खाने वाले सेल की संख्या से अलग हो सकती है.

पैरामीटर

नामTypeब्यौरा
replaceTextStringमेल खाने वाली सेल में टेक्स्ट को बदलने वाला टेक्स्ट.

रिटर्न

Integer — बदली गई संख्या की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

replaceWith(replaceText)

यह फ़ंक्शन मौजूदा मेल खाने वाली सेल में, खोज टेक्स्ट को चुने गए टेक्स्ट से बदलता है और बदले गए टेक्स्ट की संख्या दिखाता है.

पैरामीटर

नामTypeब्यौरा
replaceTextStringवह टेक्स्ट जो हाल ही में मेल खाने वाली सेल में कॉन्टेंट को बदलता है.

रिटर्न

Integer — बदली गई संख्या की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

startFrom(startRange)

यह नीति, तय की गई सेल की रेंज के तुरंत बाद खोज शुरू करने के लिए, खोज को कॉन्फ़िगर करती है.

पैरामीटर

नामTypeब्यौरा
startRangeRangeसेल की वह रेंज जिसके बाद खोज शुरू होनी चाहिए.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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

useRegularExpression(useRegEx)

अगर true, खोज स्ट्रिंग को रेगुलर एक्सप्रेशन समझने के लिए खोज को कॉन्फ़िगर करता है, तो ऐसा न करने पर खोज, खोज स्ट्रिंग को सामान्य टेक्स्ट मानती है. रेगुलर एक्सप्रेशन को इस्तेमाल करने के तरीके की ज़्यादा जानकारी के लिए, सहायता पेज ढूंढें और बदलें देखें.

पैरामीटर

नामTypeब्यौरा
useRegExBooleanखोज स्ट्रिंग को रेगुलर एक्सप्रेशन के तौर पर समझें या नहीं.

रिटर्न

TextFinder — यह टेक्स्ट फ़ाइंडर, चेन करने के लिए है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:

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