بلوک عملکرد PREG_SPLIT
بلوک عملکرد PREG_SPLIT یک رشته را با استفاده از یک عبارت Regular Expression تقسیم می کند.
توجه: این تابع Binary-Safe است. این معنی دارد که کاراکترهای UTF8 نمی توانند مستقیم پردازش شوند.
توجه: این بلوک عملکرد میتواند بیش از چهار خروجی داشته باشد. شما میتوانید با کلیک راست روی بلوک عملکرد، یک خروجی دیگر اضافه کنید.
توجه: برای تقسیمات عادی، استفاده از بلوک عملکرد EXPLODE توصیه میشود.
ورودی PATTERN
عبارت Regular Expression که باید جستجو شود، به عنوان یک رشته.
ورودی SUBJECT
رشتهای که باید تقسیم شود.
ورودی LIMIT
اگر مشخص شده باشد، حداکثر LIMIT زیر رشتهها برگردانده میشوند، در حالی که بقیه رشته در آخرین زیر رشته ذخیره میشود. یک محدودیت با مقدار -1, 0 یا NULL به معنی "بدون محدودیت" است.
ورودی NO_EMPTY
اگر این ورودی درست باشد، فقط قسمتهایی که خالی نیستند توسط بلوک عملکرد برگردانده میشوند.
ورودی DELIM_CAPTURE
اگر این ورودی درست باشد، عبارات داخل پرانتزهای عبارت جستجو برای جداکننده نیز ثبت و برگردانده میشوند.
ورودی OFFSET_CAPTURE
اگر این ورودی درست باشد، با هر تطابقی که پیدا شود، افسکت مربوطه در رشته نیز برگردانده میشود. توجه کنید که این تغییرات خروجیها را تغییر میدهد.
خروجی ERR
در صورت خطا درست است.
خروجی COUNT
تعداد تقسیمات یا اندازه آرایه داخلی را برگردانده میکند.
خروجیهای P0..P#
میتوانید خروجیهای بیشتری اضافه کنید. در این صورت هر تقسیم به یک خروجی منتقل میشود. اگر آرایه داخلی کوچکتر از تعداد خروجیها باشد، نتیجه در خروجیهای بزرگتر NULL است.