strncmp

(PHP 4, PHP 5, PHP 7, PHP 8)

strncmpString-Vergleich der ersten n Zeichen (binärsicher)

Beschreibung

strncmp(string $string1, string $string2, int $length): int

Diese Funktion ist ähnlich strcmp() mit dem Unterschied, dass die (maximale) Anzahl Zeichen angegeben werden kann, die bei jedem String verglichen werden sollen.

Es ist zu beachten, dass der Vergleich Groß- und Kleinschreibung berücksichtigt.

Parameter-Liste

string1

Die erste Zeichenkette.

string2

Die zweite Zeichenkette.

length

Die Anzahl der Zeichen, die für den Vergleich herangezogen werden soll.

Rückgabewerte

Gibt einen Wert kleiner als 0 zurück, wenn string1 in der Reihenfolge der Sortierung vor string2 kommt; einen Wert größer als 0, wenn string1 nach string2 kommt, und 0, wenn sie gleich sind. Aus dem Wert kann außer seinem Vorzeichen keine bestimmte Bedeutung abgeleitet werden.

Changelog

Version Beschreibung
8.2.0 Diese Funktion gibt nicht mehr garantiert strlen($string1) - strlen($string2) zurück, wenn die Längen der Zeichenketten nicht gleich sind, sondern kann nun stattdessen -1 oder 1 zurückgeben.

Beispiele

Beispiel #1 strncmp()-Beispiel

<?php

$var1
= 'Hello John';
$var2 = 'Hello Doe';
if (
strncmp($var1, $var2, 5) === 0) {
echo
'Die ersten 5 Zeichen von $var1 und $var2 sind bei einem Vergleich von Strings unter Berücksichtigung der Groß- und Kleinschreibung gleich';
}
?>

Siehe auch

  • strncasecmp() - Binärsicherer Vergleich von Zeichenketten der ersten n Zeichen ohne Berücksichtigung der Groß- und Kleinschreibung
  • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch
  • substr_compare() - Binärsicherer Vergleich zweier Strings, beginnend an einer bestimmten Position und endend nach einer festgelegten Länge
  • strcmp() - Vergleich zweier Strings (binärsicher)
  • strstr() - Findet das erste Vorkommen eines Strings
  • substr() - Liefert einen Teil eines Strings