وظيفة PHP preg_match()

الكاتب：Eve Cole وقت التحديث：2024-12-28 15:48:01

يتم استخدام الدالة preg_last_error لإجراء مطابقة التعبير العادي.

القواعد

 int preg_match ( سلسلة $pattern , سلسلة $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )

يبحث في الموضوع عن تطابق التعبير العادي المعطى بواسطة النمط.

وصف المعلمة:

$pattern: النمط المطلوب البحث عنه، في شكل سلسلة.

$الموضوع: سلسلة الإدخال.

$matches: إذا تم توفير معلمة التطابقات، فسيتم ملؤها بنتائج البحث. سيحتوي $matches[0] على النص المطابق للنمط الكامل، وسيحتوي $matches[1] على النص المطابق بالمجموعة الفرعية الأولى الملتقطة، وهكذا.

أعلام $: يمكن تعيين الأعلام على قيم الأعلام التالية:

PREG_OFFSET_CAPTURE: إذا تم تمرير هذه العلامة، فسيتم إلحاق إزاحة السلسلة (بالنسبة إلى السلسلة الهدف) بالإرجاع لكل تكرار للمطابقة. ملاحظة: سيؤدي هذا إلى تغيير المصفوفة المملوءة بمعلمات التطابقات بحيث يصبح كل عنصر سلسلة حيث يكون العنصر 0 هو السلسلة المتطابقة والعنصر الأول هو إزاحة السلسلة المطابقة في موضوع السلسلة الهدف.

الإزاحة: عادة، يبدأ البحث من بداية السلسلة المستهدفة. يتم استخدام إزاحة المعلمة الاختيارية لتحديد بدء البحث من نقطة غير معروفة في السلسلة المستهدفة (الوحدة هي بايت).

قيمة الإرجاع

إرجاع عدد التطابقات للنمط. ستكون قيمته 0 (لا يوجد تطابق) أو 1 لأن preg_match() سيتوقف عن البحث بعد المطابقة الأولى. يختلف preg_match_all() عن ذلك في أنه يبحث عن الموضوع حتى يصل إلى النهاية. في حالة حدوث خطأ، تُرجع الدالة preg_match()‎ القيمة FALSE.

مثال

ابحث عن السلسلة النصية "php":

<?php // العلامة "i" الموجودة بعد فاصل النمط عبارة عن بحث غير حساس لحالة الأحرف لو ( preg_match ( " /php/i " ، " PHP هي لغة البرمجة النصية للويب المفضلة. " ) ) { صدى " تم العثور على السلسلة المطابقة php . " } آخر { صدى " لم يتم العثور على سلسلة مطابقة في php. " } ?>

نتيجة التنفيذ هي كما يلي:

 ابحث عن السلسلة المطابقة php.

ابحث عن كلمة "كلمة"

<?php /* يشير b في النمط إلى حد الكلمة، لذا ستتم مطابقة الكلمة المستقلة "web" فقط، وليس * المحتوى الجزئي للكلمة مثل "webbing" أو "cobweb" */ لو ( preg_match ( " /bwebb/i " ، " PHP هي لغة البرمجة النصية للويب المفضلة. " ) ) { صدى " ابحث عن السلسلة المطابقة . n " } آخر { صدى " لم يتم العثور على سلسلة مطابقة. n " } لو ( preg_match ( " /bwebb/i " ، " PHP هي لغة البرمجة النصية لمواقع الويب المفضلة. " ) ) { صدى " ابحث عن السلسلة المطابقة . n " } آخر { صدى " لم يتم العثور على سلسلة مطابقة. n " } ?>

نتيجة التنفيذ هي كما يلي:

 تم العثور على سلسلة مطابقة. لم يتم العثور على سلسلة مطابقة.

احصل على اسم المجال في URL

<?php // احصل على اسم المضيف من عنوان URL preg_match ( ' @^(?:http://) ? ([ ^ /]+)@i ' , " http://www.codercto.com/index.html " , $ matches ) ; [ 1 ] // احصل على الجزأين الأخيرين من اسم المضيف preg_match ( ' /[^.]+.[^.]+$/ ' , $host , $ matches ) ; " اسم المجال هو: {$matches[0]} n " ? >

نتيجة التنفيذ هي كما يلي:

 اسم النطاق هو: codercto.com

استخدم المجموعات الفرعية المسماة

<?php $str = ' foobar: 2008 ' ; preg_match ( ' /(?P<name>w+): (?P<digit>d+)/ ' , $str , $matches ) ; /* المثال التالي موجود في PHP 5.2.2 (pcre 7.0) أو أحدث، ومع ذلك، من أجل التوافق مع الإصدارات السابقة، فإن الطريقة المذكورة أعلاه هي طريقة الكتابة الموصى بها . // preg_match('/(?<name>w+): (?<digit>d+)/', $str, $matches); print_r ( $matches ) ? >

نتيجة التنفيذ هي كما يلي:

 المصفوفة( [0] => foobar: 2008 [name] => foobar [1] => foobar [digit] => 2008 [2] => 2008)