Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

substr_compare

String-Funktionen

    Befehl:
int substr_compare ( string $main_str , string $str , int $offset [, int $length [, bool $case_insensitivity = false ]] )


    Parameter-Liste:
NameBeschreibung
main_strDie zu vergleichende Hauptzeichenkette.
strDie zweite zu vergleichende Zeichenkette.
offsetDie Anfangsposition für Höhle Vergleich. WENN der Wert negativ IST, WIRD rückwärts vom Ende der Zeichenkette ein gezählt. Die Startposition für den Vergleich. Wenn negativ, beginnt ab dem Ende der Zeichenfolge.
lengthDie Länge der zu vergleichenden Zeichensequenz. Standardwert ist der größere Wert des Vergleiches der Länge des str mit der Länge von main_str minus offset.
case_insensitivityWenn case_insensitivity den Wert TRUE hat, wird der Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung durchgeführt.

    Rückgabewerte:
Gibt eine Zahl < 0 zurück, wenn main_str ab der in offset festgelegten Position kürzer ist als str, eine Zahl > 0, wenn der ermittelte String länger ist als str, und 0, wenn sie gleich sind. Wenn der Parameter offset gesetzt und gleich oder grösser als die Länge von main_str ist oder length gesetzt und kleiner als 1 ist, gibt substr_compare() eine Warnung aus und hat den Rückgabewert FALSE.

    Beschreibung:
substr_compare() vergleicht main_str ab der in offset definierten Position mit str. Die Länge des verglichenen String-Bestandteils wird vom length-Parameter bestimmt.


    Aktiv in Version:
(PHP 5, PHP 7)

substr_compare() - Beispiel:


Eingabe:
<?php
echo substr_compare("abcde", "bc", 1, 2); // 0
echo substr_compare("abcde", "de", -2, 2); // 0
echo substr_compare("abcde", "bcg", 1, 2); // 0
echo substr_compare("abcde", "BC", 1, 2, true); // 0
echo substr_compare("abcde", "bc", 1, 3); // 1
echo substr_compare("abcde", "cd", 1, 2); // -1
echo substr_compare("abcde", "abc", 5, 1); // warning
?>

Beschreibung:
Version Beschreibung
5.6.0 length kann nun 0 sein.
5.1.0 Die Möglichkeit, einen negativen Wert für offset festzulegen, wurde eingeführt.
String-Funktionen