strcmp

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

strcmpVergleich zweier Strings (binärsicher)

Beschreibung

strcmp(string $string1, string $string2): int

Es ist zu beachten, dass dieser Vergleich Groß-/Kleinschreibung berücksichtigt. Für einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung siehe strcasecmp().

Des weiteren ist zu beachten, dass der Vergleich die locale Einstellung ignoriert. Für einen Vergleich, der die locale Einstellung respektiert, siehe strcoll() oder Collator::compare()

Parameter-Liste

string1

Die erste Zeichenkette.

string2

Die zweite Zeichenkette.

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 strcmp()-Beispiel

<?php
$var1
= "Hallo";
$var2 = "hallo";
if (
strcmp($var1, $var2) !== 0) {
echo
'$var1 ist ungleich $var2 bei einem Vergleich, der Groß-/Kleinschreibung berücksichtigt';
}
?>

Siehe auch

  • Vollständiger String-Vergleich
    • strcasecmp() - Vergleich von Zeichenketten ohne Unterscheidung der Groß- und Kleinschreibung (binärsicher)
    • Collator::compare() - Compare two Unicode strings
    • strcoll() - Locale-basierter Zeichenkettenvergleich
  • Teilweiser String-Vergleich
    • substr_compare() - Binärsicherer Vergleich zweier Strings, beginnend an einer bestimmten Position und endend nach einer festgelegten Länge
    • strncmp() - String-Vergleich der ersten n Zeichen (binärsicher)
    • strstr() - Findet das erste Vorkommen eines Strings
  • Vergleich ähnlicher / verschiedener Strings
    • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch
    • levenshtein() - Berechnet die Levenshtein-Distanz zwischen zwei Strings
    • metaphone() - Berechnet den Metaphone-Schlüssel eines Strings
    • similar_text() - Berechnet die Ähnlichkeit zweier Zeichenketten
    • soundex() - Berechnet die Laut-Ähnlichkeit eines Strings