strncmp

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

strncmp — String-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