مетод match() رشته JavaScript

تعریف و استفاده

match() این روش زبان را با عبارت جستجوگر تطبیق می‌دهد.

توضیح:اگر مقدار جستجو یک زبان باشد، آن را به عبارت جستجوگر تبدیل می‌کند.

match() این روش آرایه‌ای از تطابق‌ها را برمی‌گرداند.

اگر هیچ تطابق یافت نشد، match() این روش null.

لطفاً به: مراجعه کنید

آموزش عبارت جستجوگر

دستورالعمل‌های عبارت جستجوگر

تفاوت بین String match() و String search()

match() این روش آرایه‌ای از تطابق‌ها را برمی‌گرداند.

search() این روش اولین موقعیت تطابق را برمی‌گرداند.

مثال

مثال 1

جستجو با استفاده از زبان "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

تست کنید

مثال 2

جستجو با استفاده از عبارت جستجوگر "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

تست کنید

مثال 3

جستجو جهانی برای "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

تست کنید

مثال 4

جستجو جهانی، بدون توجه به حروف بزرگ و کوچک:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

تست کنید

رابط‌نویسی

string.match(regexp)

پارامتر

پارامتر توضیحات
regexp

ضروری. مقدار جستجو.

عبارت جستجوگر (یا زبانی که به عبارت جستجوگر تبدیل خواهد شد).

مقدار بازگشتی

نوع توضیحات
آرایه یا null

آرایه‌ای که شامل تطابق‌ها است.

اگر هیچ تطابق یافت نشد، null.

جزئیات فنی

پارامتر regexp

این پارامتر باید یک شیRegExp باشد. اگر این پارامتر یک شیRegExp نباشد، ابتدا آن را به تابعRegExp() ارسال می‌کند و آن را به شیRegExp تبدیل می‌کند.

مقدار بازگشتی

آدرس آرایه‌ای که نتایج هماهنگی‌ها را در خود جای می‌دهد. محتوای این آرایه بستگی به regexp دارای نشانه جهانی یا خیر g. در اینجا توضیحی دقیق‌تر از این بازگشت آورده شده است.

توضیحات

match() را جستجو می‌کند stringروش regexp متن تطابق‌یاب regexp دارای نشانه g.

اگر regexp بدون نشانه g، match() اگر string اگر هیچ تطابق متن پیدا نشد،match() باز خواهد گشت nullاگر string موقعیت string نقش

اگر regexp دارای نشانه gاگر match() روش جستجوی جهانی را اجرا می‌کند، string تمام تطابق‌های زیرگروه‌های آن. اگر هیچ تطابق زیرگروهی پیدا نشد، null. اگر یک یا چند تطابق زیرگروه پیدا شد، یک آرایه بازمی‌گردد. اما محتوای آرایه‌ای که توسط تطابق جهانی بازمی‌گردد با前者 بسیار متفاوت است، و عناصر آرایه‌ای آن شامل string تمام تطابق‌های زیرگروه‌ها را شامل می‌شود و نیز دارای属性 index یا input نیستند.

توجه:در حالت جستجوی جهانی،match() که اطلاعات متن با تطابق زیرگروه‌ها را ارائه نمی‌دهد و نیز موقعیت هر تطابق زیرگروه را اعلام نمی‌کند. اگر شما به این اطلاعات جستجوی جهانی نیاز دارید، می‌توانید از RegExp.exec().

روش‌های جستجوی فرموله‌های عادی

در JavaScript، جستجوی متن فرموله‌های عادی می‌تواند با روش‌های مختلف انجام شود.

این روش‌ها که با استفاده از مدل به عنوان فرموله‌های عادی استفاده می‌شوند، بیشترین استفاده را دارند:

مثال توضیحات
text.match(pattern) روش match() رشته
text.search(pattern) روش search() رشته
pattern.exec(text) روش exec() فرموله‌های عادی
pattern.test(text) روش test() فرموله‌های عادی

پشتیبانی مرورگر

match() این ویژگی‌ها از ECMAScript1 (ES1) هستند.

همه مرورگرها به طور کامل از ES1 (JavaScript 1997) پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

رشته JavaScript

روش‌های رشته JavaScript

جستجوی رشته JavaScript