preg_match_all() پی ایچ پی میں ایک بلٹ ان فنکشن ہے جو سٹرنگ میں مخصوص پیٹرن سے ملنے کے لیے استعمال ہوتا ہے۔ آپ اس فنکشن کو ریگولر ایکسپریشن میچز کرنے اور تاروں سے ڈیٹا نکالنے کے لیے استعمال کر سکتے ہیں۔ یہ ایسے معاملات میں وقت اور محنت کی بچت کر سکتا ہے جہاں آپ کو ایک پیٹرن کے متعدد واقعات کو تلاش کرنے کی ضرورت ہوتی ہے اور پی ایچ پی کی ٹیکسٹ پارسنگ اور ڈیٹا نکالنے کی ایپلی کیشنز میں بڑے پیمانے پر استعمال ہوتا ہے۔
نحو
استعمال کرنے کے لیے نحو درج ذیل ہے۔ preg_match_all پی ایچ پی میں:
preg_match_all ( پیٹرن ، ان پٹ ، میچز ، جھنڈے ، آفسیٹ )
دی preg_match_all مندرجہ ذیل پیرامیٹرز کو قبول کرتا ہے، تین لازمی پیرامیٹرز ہیں اور دو اختیاری ہیں:
- پیٹرن : یہ لازمی پیرامیٹر ہے؛ یہ باقاعدہ اظہار پر مشتمل ہے جسے تلاش کرنے کی ضرورت ہے۔
- ان پٹ : دوسرا ایک لازمی پیرامیٹر بھی ہے، کیونکہ یہ وہ تار ہے جس میں تلاش کی جاتی ہے۔
- میچز : یہ تمام میچوں پر مشتمل صف میں آؤٹ پٹ کو اسٹور کرتا ہے۔
- جھنڈے : یہ بتاتا ہے کہ تلاش یا مماثلت کی صف کی ساخت کیسے بنتی ہے۔ یہ فنکشن کی تلاش کے رویے کو تبدیل کرتا ہے۔ درج ذیل جھنڈے استعمال کیے جا سکتے ہیں۔
- آفسیٹ : یہ اختیاری پیرامیٹر ہے جو تلاش کی شروعاتی پوزیشن کا تعین کرتا ہے۔
| جھنڈا۔ | تفصیل |
|---|---|
| PREG_PATTERN_ORDER | نتیجہ خیز صف میں ریگولر ایکسپریشن کے ہر عنصر کے لیے ایک صف کے تمام میچ ہوتے ہیں۔ |
| PREG_SET_ORDER | مماثل صفوں کے عناصر میں سے ہر ایک میں سٹرنگ کے پائے گئے میچوں میں سے ایک کے لیے ہر گروپ سے میچ ہوتے ہیں۔ |
| PREG_OFFSET_CAPTURE | یہ سبجیکٹ سٹرنگ میں ان کے متعلقہ بائٹ آفسیٹ پوزیشنز کے ساتھ میچز کو لوٹاتا ہے۔ |
| PREG_UNMATCHED_AS_NULL | بے مثال پیٹرن NULL کے بطور رپورٹ کریں گے۔ |
مثال 1
استعمال کرنے کی مندرجہ ذیل مثال پر غور کریں۔ preg_match_all() پی ایچ پی میں فنکشن۔ اس کوڈ میں، ہم لفظ تلاش کر رہے ہیں۔ لینکس تار میں یہ فنکشن لفظ کے خلاف پائے جانے والے میچوں کی تعداد کو ظاہر کرتا ہے۔ لینکس :
<؟php
$string = 'ہیلو لینکس کے شائقین، LinuxHint میں خوش آمدید!' ;
پیٹرن = '/Linux/' ;
$ میچز = صف ( ) ;
preg_match_all ( پیٹرن ، $string ، $ میچز ) ;
پرنٹ_ر ( $ میچز [ 0 ] ) ;
؟>
مثال 2
اس مثال کے کوڈ میں، ہم سٹرنگ میں لفظ E تلاش کر رہے ہیں۔ چھوٹے i کا استعمال سرچ کیس کو غیر حساس بنانے کے لیے کیا جاتا ہے۔ یہ لفظ E یا e کے تمام سٹرنگ واقعات کو واپس کر دے گا:
<؟php$string = 'امریکہ میں خوش آمدید۔' ;
$patternRex = '/E/i' ;
$matchFound = preg_match_all ( $patternRex ، $string ، $ میچز ) ;
اگر ( $matchFound ) {
بازگشت '
';
پرنٹ_ر ( $ میچز ) ;
}
؟>
مثال 3
اگر آپ جس پیٹرن کی تلاش کر رہے ہیں وہ سٹرنگ میں موجود نہیں ہے، تو فنکشن غلط ہو جائے گا، جو ایک غلطی کی نشاندہی کرتا ہے۔ اس کو سنبھالنے کے لیے، آپ if-else بیانات استعمال کر سکتے ہیں۔ اگر پیٹرن نہیں ملا ہے، تو آپ else اسٹیٹمنٹ کا استعمال کرتے ہوئے ایک پیغام پرنٹ کرسکتے ہیں تاکہ صارف کو مطلع کیا جاسکے کہ پیٹرن نہیں ملا۔
<؟php$string = 'پی ایچ پی ایک مقبول اسکرپٹنگ زبان ہے' ;
$patternRex = '/پیشاب/' ;
$matchFound = preg_match_all ( $patternRex ، $string ، $ میچز ) ;
اگر ( $matchFound ) {
بازگشت '
';
بازگشت 'مماثل ملا۔' ;
پرنٹ_ر ( $ میچز ) ;
} اور {
بازگشت 'کوئی میچ نہیں ملا۔' ;
}
؟>
نوٹ :دی اوپر والے کوڈ میں ٹیگ آؤٹ پٹ کو فارمیٹ کرنے کے لیے استعمال ہوتا ہے۔
نیچے کی لکیر
ریگولر ایکسپریشنز پی ایچ پی میں ٹیکسٹ کو تلاش کرنے اور اس میں ہیرا پھیری کرنے کا ایک طاقتور ٹول ہیں۔ دی preg_match_all() فنکشن ایک بلٹ ان پی ایچ پی فنکشن ہے جو سٹرنگ کے خلاف ریگولر ایکسپریشن میچ کرنے اور پیٹرن کے تمام واقعات کو بازیافت کرنے کے لیے استعمال کیا جاتا ہے اور اگر پیٹرن موجود نہیں ہے تو یہ غلط ہو جائے گا۔ کو سمجھنا preg_match_all() فنکشن صارفین کو پی ایچ پی میں ٹیکسٹ ڈیٹا کو بہتر طریقے سے ہینڈل کرنے اور اس پر کارروائی کرنے میں مدد کرے گا۔