مетод JavaScript String split()

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

split() این روش رشته را به آرایه‌ای از زیررشته‌ها تقسیم می‌کند.

split() این روش آرایه‌ای جدید برمی‌گرداند و رشته اصلی را تغییر نمی‌دهد.

اگر (" ") به عنوان نشانه‌گذار استفاده شود، رشته در کلمات بین آن‌ها تقسیم می‌شود.

لطفاً ببینید:

مетод slice()

مетод substr()

مетод substring()

مثال

مثال 1

کلمات را تقسیم کنید:

let text = "How are you doing today?";
const myArray = text.split(" ");

آزمایش کنید

مثال 2

کلمات را تقسیم کرده و کلمه دوم را برمی‌گرداند:

let text = "How are you doing today?";
const myArray = text.split(" ");
let word = myArray[1];

آزمایش کنید

مثال 3

حروف را تقسیم کرده و شامل فضاهای خالی است:

const myArray = text.split(" ");

آزمایش کنید

مثال 4

از پارامتر limit استفاده کنید:

const myArray = text.split(" ", 3);

آزمایش کنید

مثال 5

رشته را به حروف تقسیم کرده و حرف دوم را برمی‌گرداند:

const myArray = text.split(" ");

آزمایش کنید

مثال 6

از حرف به عنوان نشانه‌گذار استفاده کنید:

const myArray = text.split("o");

آزمایش کنید

مثال 7

اگر پارامتر separator گم شود، آرایه‌ای شامل رشته اصلی را برمی‌گرداند:

const myArray = text.split();

آزمایش کنید

منطق

string.split(',separator, limit)

پارامتر

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

اختیاری. برای جداسازی رشته یا عبارت منظم استفاده می‌شود.

اگر گم شود، آرایه‌ای شامل رشته اصلی را برمی‌گرداند.
limit

اختیاری. عددی برای محدود کردن تعداد تقسیم‌بندی.

عناصر بیش از حد محدود خارج می‌شوند.

برگشت‌دهی

نوع توضیح
Array شامل آرایه‌ای که شامل مقادیر تقسیم شده است.

جزئیات فنی

پارامتر separator

این پارامتر یک رشته یا عبارت کاراکترهای منظم است و از اینجا تقسیم می‌شود string.

پارامتر limit

این عدد انتخابی تعیین می‌کند طول بیشترین آرایه بازگردانده شده. اگر این پارامتر تنظیم شده باشد، زیرگزارش‌های بازگردانده شده بیشتر از این عدد نمی‌شوند. اگر این پارامتر تنظیم نشده باشد، کل رشته بدون توجه به طول تقسیم می‌شود.

برگشت‌دهی

یک آرایه رشته‌ای بازمی‌گرداند. این آرایه از طریق تقسیم‌بندی در separator در مرزهای مشخص شده رشته را string توسط تقسیم‌بندی زیرگزارش‌ها ایجاد شده است. زیرگزارش‌هایی که در آرایه بازگردانده می‌شوند شامل separator خود

اما اگر separator اگر یک عبارت کاراکترهای منظم شامل زیرگزارش‌ها باشد، آرایه‌ای که بازمی‌گردانند شامل زیرگزارش‌های مطابقت‌یافته است (اما شامل متن تمامی عبارت کاراکترهای منظم نیست).

توضیح

split() این روش یک آرایه رشته‌ای ایجاد کرده و بازمی‌گرداند، که عناصر آن رشته‌های مشخص شده هستند string زیرگزارش، بیشترین تعداد limit عدد. این زیرگزارش‌ها از طریق جستجوی از ابتدا تا انتها در رشته با separator مطابقت دارند، در قسمت‌های قبل و بعد از متن مطابقت‌یافته تقسیم می‌شوند string دریافت می‌شوند. زیرگزارش‌هایی که بازگردانده می‌شوند شامل متن مرزهای تقسیم‌کننده نیستند (به استثنای مواردی که در انتهای این بخش ذکر شده است). اگر مرزهای تقسیم‌کننده از ابتدای رشته شروع به تطابق کنند، اولین عنصر آرایه خالی است، یعنی متن قبل از مرزهای تقسیم‌کننده. همچنین، اگر مرزهای تقسیم‌کننده با پایان رشته تطابق کنند، آخرین عنصر آرایه نیز خالی است (با فرض اینکه limit درگیری وجود ندارد).

تعیین نشده باشد separator، آنگاه اصلاً صحیح نیست string اجرای تقسیم‌بندی انجام می‌شود، آرایه بازگردانده شده فقط یک عنصر دارد و رشته تقسیم نمی‌شود. اگر separator خالی است یا با خالی مطابقت دارد)، آنگاه string بین هر کدام از کاراکترها تقسیم می‌شوند، طول آرایه بازگردانده شده با طول رشته برابر است (با فرض اینکه limit از این طول بیشتر نباشد) (توجه داشته باشید که این یک حالت خاص است، زیرا بین اولین کاراکتر و آخرین کاراکتر پس از عدم تطابق خالی وجود ندارد).

قبلاً ذکر شد که زیرگزارش‌هایی که آرایه‌ای که این روش بازمی‌گردانند شامل آن‌ها می‌شود، شامل متن مرزهای تقسیم‌کننده نیستند. اما اگر separator اگر یک عبارت کاراکترهای منظم شامل زیرگزارش‌ها باشد، آرایه‌ای که بازمی‌گردانند شامل زیرگزارش‌های مطابقت‌یافته است (اما شامل متن تمامی عبارت کاراکترهای منظم نیست).

توجه:string.split() عملی که با آن انجام می‌شود Array.join() عملی که برعکس آن انجام می‌شود.

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

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

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

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

صفحات مرتبط

رشته JavaScript

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

جستجوی رشته JavaScript