الدالة SEARCH

ينطبق على
SharePoint Server 2019 SharePoint Server 2016 SharePoint Server 2013 SharePoint Server 2013 Enterprise SharePoint Foundation 2010 SharePoint Server 2010 Windows SharePoint Services 3.0

ترجع الدالة SEARCH عدد الحرف الذي تم العثور فيه على حرف أو سلسلة نصية معينة لأول مرة، بدءا من start_num. استخدم SEARCH لتحديد موقع حرف أو سلسلة نصية داخل سلسلة نصية أخرى بحيث يمكنك استخدام الدالتين MID أو REPLACE لتغيير النص.

بناء الجملة

SEARCH(find_text,within_text,start_num)

Find_text هو النص الذي تريد العثور عليه. يمكنك استخدام أحرف البدل — علامة الاستفهام (?) والعلامة النجمية (*) في find_text. تطابق علامة الاستفهام أي حرف مفرد؛ بينما تطابق العلامة النجمية أي تسلسل أحرف. إذا أردت البحث عن علامة استفهام أو علامة نجمية فعلية، فاكتب حرف التلدة (~) قبل الحرف.

Within_text هو النص الذي تريد البحث فيه عن find_text.

Start_num هو رقم الحرف في within_text الذي تريد بدء البحث فيه. استخدم start_num لتخطي عدد معين من الأحرف. على سبيل المثال، افترض أنك تعمل مع السلسلة النصية "AYF0093. YoungMensApparel". للعثور على رقم أول "Y" في الجزء الوصفي للسلسلة النصية، قم بتعيين start_num بحيث يساوي 8 لكي لا يتم البحث في جزء serial-number للنص. تبدأ الدالة SEARCH بالحرف 8، وتعثر على find_text في الحرف التالي، وترجع الرقم 9. ترجع الدالة SEARCH دائما عدد الأحرف من بداية within_text، مع حساب الأحرف التي تتخطىها إذا كانت start_num أكبر من 1.

ملاحظات

  • لا يميز SEARCH بين الأحرف الكبيرة والصغيرة عند البحث في النص.
  • SEARCH مشابه ل FIND باستثناء أن FIND حساس لحالة الأحرف.
  • إذا لم يتم العثور على find_text، #VALUE! يتم إرجاع قيمة الخطأ.
  • إذا تم حذف start_num، فمن المفترض أن تكون 1.
  • إذا لم يكن start_num أكبر من 0 (صفر) أو أكبر من طول within_text، #VALUE! يتم إرجاع قيمة الخطأ.

أمثلة

Col1 Col2 Col3 الصيغة الوصف (النتيجة)
الكشوف هامش الربح هامش =SEARCH("e",[Col1],6) موضع أول "e" في السلسلة، بدءا من الموضع السادس (7)
الكشوف هامش الربح هامش =SEARCH([Col3],[Col2]) موضع "الهامش" في "هامش الربح" (8)
الكشوف هامش الربح هامش =REPLACE([Col2],SEARCH([Col3],[Col2]),6,"Amount") استبدال "الهامش" ب "المبلغ" (مبلغ الربح)