الدالة strncmp()‎ في PHP

(PHP 4, PHP 5, PHP 7)

توازن الدالة strncmp()‎ بطريقة آمنة ثنائيًّا (binary safe) بين سلسلتين نصيَّتين لعدد محدَّد من المحارف الأولى.

الوصف

int strncmp ( string $str1 , string $str2 , int $len )

تشبه هذه الدالة الدالة strcmp()‎ باستثناء أنَّه يمكن تحديد عدد المحارف الأولى التي ستُوازن بين السلسلتين النصيَّتين.

ملاحظة: هذه الدالة حساسة لحالة الأحرف.

المعاملات

str1

السلسلة النصيَّة الأولى.

str2

السلسلة النصيَّة الثانية.

len

عدد المحارف المستعملة في الموازنة.

القيم المعادة

تُعاد قيمة أصغر من الصفر إن كان المعامل str1 أصغر من المعامل str2، وقيمة أكبر من الصفر إن كان str1 أكبر من str2، والقيمة صفر إن كان المعاملان السابقان متساويين.

انظر أيضًا

• الدالة preg_match()‎: تبحث عن تعبير نمطي (regular expression) في سلسلة نصيَّة.
• الدالة strcmp()‎: توازن بطريقة آمنة ثنائيًّا بين سلسلتين نصيَّتين.
• الدالة substr()‎: تعيد جزءًا من السلسلة النصيَّة.
• الدالة strstr()‎: تبحث عن أول ظهور لسلسلة نصيَّة محدَّدة ضمن سلسلة نصيَّة أخرى.
• الدالة strncasecmp()‎: توازن بطريقة آمنة ثنائيًّا بين سلسلتين نصيَّتين لعدد محدَّد من المحارف الأولى دون التحسُّس لحالة الأحرف.
• الدالة substr_compare()‎: توازن بطريقة آمنة ثنائيًّا بين سلسلتين نصيَّتين بدءًا من إزاحة معيَّنة وحتى عدد محدَّد من المحارف.

مصادر

• صفحة الدالة strncmp في توثيق PHP الرسمي.