PHP-Zeichenkettenfunktionen: suchen und vergleichen #

eZTemplateStringsOperator (lib/eztemplate/classes/eztemplatestringsoperator.php) stellt 60 PHP-Zeichenkettenfunktionen unter ihren PHP-Namen als Template-Operatoren bereit. Diese Seite behandelt die 27, die Zeichenketten messen, durchsuchen und vergleichen. Die übrigen finden Sie unter PHP-Zeichenkettenfunktionen: umwandeln und PHP-Zeichenkettenfunktionen: kodieren und formatieren.

Inhalt #

1. Wie die PHP-Funktionen abgebildet werden
2. Länge und Position
3. Teilzeichenketten finden
4. Enthält, beginnt mit, endet mit
5. Vergleichen
6. Ähnlichkeit
7. Verwandte Seiten

Wie die PHP-Funktionen abgebildet werden #

Der Kommentar der Klasse nennt die Regel, und modify() folgt ihr:

• Die Eingabe über die Pipe ist das Haupt-Zeichenkettenargument der PHP-Funktion (in eine Zeichenkette umgewandelt).
• Die Template-Parameter sind die übrigen PHP-Argumente in ihrer Reihenfolge, jeweils in den Typ umgewandelt, den PHP erwartet.
• Es gibt keine benannten Parameter: Jedes Argument ist positionsbezogen (operatorTemplateHints() deklariert keine).
• Eine Funktion, die für „nicht gefunden“ false zurückgibt, gibt auch im Template false zurück. Prüfen Sie das mit choose, eq( false() ) oder is_boolean, denn Position 0 ist ebenfalls eine gültige Antwort.
• Ein fehlendes erforderliches Argument protokolliert eine Warnung wie „Missing required parameter: needle“ und lässt die Eingabe unverändert.

Registriert werden nur die Namen in lib/eztemplate/classes/eztemplateautoload.php. Funktionen, die bereits einen eigenen Template-Operator haben (trim, nl2br, md5 und weitere, die im Kommentar der Klasse aufgeführt sind), werden hier nicht doppelt angeboten.

In den Beispielen gibt choose( 'false', 'true' ) einen Boolean-Wert als Wort aus.

Länge und Position #

strlen #

PHP strlen(): die Länge in Bytes. Für Zeichen verwenden Sie count_chars. Keine Parameter. Gibt eine Ganzzahl zurück. Generierte Referenz: strlen.

strpos, stripos, strrpos, strripos #

Die Position des ersten (strpos, ohne Beachtung der Groß- und Kleinschreibung stripos) oder letzten (strrpos, ohne Beachtung der Groß- und Kleinschreibung strripos) Vorkommens einer Suchzeichenkette, in Bytes ab 0 gezählt, oder false.

Gibt eine Ganzzahl oder false zurück. Generierte Referenzen: strpos, stripos, strrpos, strripos.

{def $s = 'Fit & Healthy: healthy eating'}
strlen = {$s|strlen}
strpos( 'healthy' ) = {$s|strpos( 'healthy' )}
stripos( 'healthy' ) = {$s|stripos( 'healthy' )}
strrpos( 'h' ) = {$s|strrpos( 'h' )}
strripos( 'HEALTHY' ) = {$s|strripos( 'HEALTHY' )}
strpos( 'healthy', 20 ) = [{$s|strpos( 'healthy', 20 )|choose( 'false', 'true' )}] (false: not found after 20)

Ausgabe:

strlen = 29
strpos( 'healthy' ) = 15
stripos( 'healthy' ) = 6
strrpos( 'h' ) = 20
strripos( 'HEALTHY' ) = 15
strpos( 'healthy', 20 ) = [false] (false: not found after 20)

Teilzeichenketten finden #

strstr und stristr #

Der Teil der Eingabe ab dem ersten Vorkommen der Suchzeichenkette (strstr; ohne Beachtung der Groß- und Kleinschreibung stristr) oder, wenn der zweite Parameter wahr ist, der Teil davor. false, wenn die Suchzeichenkette nicht gefunden wird.

Generierte Referenzen: strstr, stristr.

strrchr #

Der Teil ab dem letzten Vorkommen eines Zeichens oder false. Parameter: needle (Zeichenkette, erforderlich). Generierte Referenz: strrchr.

strpbrk #

Der Teil ab dem ersten Zeichen, das in der Liste vorkommt, oder false. Parameter: char_list (Zeichenkette, erforderlich). Generierte Referenz: strpbrk.

strspn und strcspn #

strspn: die Länge des Anfangsstücks, das nur aus Zeichen der Maske besteht. strcspn: die Länge des Anfangsstücks, das aus Zeichen besteht, die nicht in der Maske vorkommen.

Gibt eine Ganzzahl zurück. Generierte Referenzen: strspn, strcspn.

substr_count #

Wie oft die Suchzeichenkette vorkommt (nicht überlappend).

Gibt eine Ganzzahl zurück. Generierte Referenz: substr_count.

{def $s = 'recipes/pasta/almond-french-toast'}
strstr( '/' ) = {$s|strstr( '/' )}
strstr( '/', true() ) = {$s|strstr( '/', true() )}
stristr( 'PASTA' ) = {$s|stristr( 'PASTA' )}
strrchr( '/' ) = {$s|strrchr( '/' )}
strpbrk( '-/' ) = {$s|strpbrk( '-/' )}
strspn( 'abcdefghijklmnopqrstuvwxyz' ) = {$s|strspn( 'abcdefghijklmnopqrstuvwxyz' )}
strcspn( '/' ) = {$s|strcspn( '/' )}
substr_count( '-' ) = {$s|substr_count( '-' )}

Ausgabe:

strstr( '/' ) = /pasta/almond-french-toast
strstr( '/', true() ) = recipes
stristr( 'PASTA' ) = pasta/almond-french-toast
strrchr( '/' ) = /almond-french-toast
strpbrk( '-/' ) = /pasta/almond-french-toast
strspn( 'abcdefghijklmnopqrstuvwxyz' ) = 7
strcspn( '/' ) = 7
substr_count( '-' ) = 2

Enthält, beginnt mit, endet mit #

str_contains, str_starts_with, str_ends_with #

PHP 8s str_contains(), str_starts_with() und str_ends_with(): Prüfungen auf Bytes, die Groß- und Kleinschreibung unterscheiden. Die Klasse hat einen Ersatz mit strpos()/substr() für ein PHP, dem sie fehlen. Eine leere Suchzeichenkette wird immer gefunden.

Gibt einen Boolean-Wert zurück. Die Array-Operatoren contains, begins_with und ends_with tun dasselbe für Zeichenketten mit mb_*-Funktionen (Array-Operatoren). Generierte Referenzen: str_contains, str_starts_with, str_ends_with.

{def $file = 'Healthy-Breakfast.JPG'}
str_contains( 'Breakfast' ) = {$file|str_contains( 'Breakfast' )|choose( 'false', 'true' )}
str_starts_with( 'Healthy' ) = {$file|str_starts_with( 'Healthy' )|choose( 'false', 'true' )}
str_ends_with( '.jpg' ) = {$file|str_ends_with( '.jpg' )|choose( 'false', 'true' )}
str_ends_with( '.JPG' ) = {$file|str_ends_with( '.JPG' )|choose( 'false', 'true' )}

Ausgabe:

str_contains( 'Breakfast' ) = true
str_starts_with( 'Healthy' ) = true
str_ends_with( '.jpg' ) = false
str_ends_with( '.JPG' ) = true

Vergleichen #

Alle Vergleichsfunktionen geben 0 zurück, wenn die Zeichenketten gleich sind, eine negative Zahl, wenn die Eingabe zuerst einsortiert wird, und eine positive Zahl, wenn sie danach einsortiert wird. Sie sind die Operatoren, mit denen Sie Text ordnen, denn die logischen Operatoren lt und gt vergleichen Zeichenketten nach ihrer Länge (Logische Operatoren).

strcmp und strcasecmp #

Binärer Vergleich, mit (strcmp) oder ohne (strcasecmp) Unterscheidung der Groß- und Kleinschreibung. Parameter: string2 (Zeichenkette, erforderlich). Generierte Referenzen: strcmp, strcasecmp.

strncmp und strncasecmp #

Dasselbe, nur für die ersten n Bytes.

Fehlt einer der beiden, protokolliert der Operator „Missing required parameters: string2 and n“. Generierte Referenzen: strncmp, strncasecmp.

strnatcmp und strnatcasecmp #

Vergleich in „natürlicher Reihenfolge“, der Ziffernfolgen als Zahlen behandelt: img2 kommt vor img10. Parameter: string2 (Zeichenkette, erforderlich). Generierte Referenzen: strnatcmp, strnatcasecmp.

strcoll #

Vergleich nach dem aktuellen Locale (LC_COLLATE). Parameter: string2 (Zeichenkette, erforderlich). Generierte Referenz: strcoll.

substr_compare #

Vergleicht die Eingabe ab einem Offset mit einer anderen Zeichenkette.

Generierte Referenz: substr_compare.

'apple'|strcmp( 'banana' ) = {'apple'|strcmp( 'banana' )}
'Apple'|strcasecmp( 'apple' ) = {'Apple'|strcasecmp( 'apple' )}
'img12'|strcmp( 'img10' ) = {'img12'|strcmp( 'img10' )}
'img2'|strcmp( 'img10' ) = {'img2'|strcmp( 'img10' )}
'img2'|strnatcmp( 'img10' ) = {'img2'|strnatcmp( 'img10' )}
'IMG2'|strnatcasecmp( 'img10' ) = {'IMG2'|strnatcasecmp( 'img10' )}
'Healthy'|strncmp( 'Health', 6 ) = {'Healthy'|strncmp( 'Health', 6 )}
'HEALTHY'|strncasecmp( 'health', 6 ) = {'HEALTHY'|strncasecmp( 'health', 6 )}
'b'|strcoll( 'a' ) = {'b'|strcoll( 'a' )}
'Hello world'|substr_compare( 'world', 6 ) = {'Hello world'|substr_compare( 'world', 6 )}
'Hello WORLD'|substr_compare( 'world', 6, 5, true() ) = {'Hello WORLD'|substr_compare( 'world', 6, 5, true() )}

Ausgabe:

'apple'|strcmp( 'banana' ) = -1
'Apple'|strcasecmp( 'apple' ) = 0
'img12'|strcmp( 'img10' ) = 2
'img2'|strcmp( 'img10' ) = 1
'img2'|strnatcmp( 'img10' ) = -1
'IMG2'|strnatcasecmp( 'img10' ) = -1
'Healthy'|strncmp( 'Health', 6 ) = 0
'HEALTHY'|strncasecmp( 'health', 6 ) = 0
'b'|strcoll( 'a' ) = 1
'Hello world'|substr_compare( 'world', 6 ) = 0
'Hello WORLD'|substr_compare( 'world', 6, 5, true() ) = 0

Eine Prüfung auf „dasselbe Wort, ohne Beachtung der Groß- und Kleinschreibung“:

{def $a = 'Running'
     $b = 'running'}
{if $a|strcasecmp( $b )|eq( 0 )}"{$a}" and "{$b}" are the same word, ignoring case.{/if}

Ausgabe:

"Running" and "running" are the same word, ignoring case.

Ohne seinen erforderlichen Parameter lässt ein Vergleich die Eingabe unverändert und protokolliert eine Warnung:

[{'abc'|strcmp}]

Ausgabe:

[abc]

Von der Template-Engine protokolliert:

WARNING strcmp: Missing required parameter: string2

Ähnlichkeit #

levenshtein #

Der Editierabstand zwischen der Eingabe und einer anderen Zeichenkette. Parameter: string2 (Zeichenkette, erforderlich). Gibt eine Ganzzahl zurück. Generierte Referenz: levenshtein.

similar_text #

Die Anzahl übereinstimmender Zeichen (PHP similar_text() ohne sein Prozent-Argument). Parameter: string2 (Zeichenkette, erforderlich). Gibt eine Ganzzahl zurück. Generierte Referenz: similar_text.

soundex und metaphone #

Phonetische Schlüssel für englische Wörter: soundex (keine Parameter) und metaphone (optional max_phonemes, Ganzzahl). Geben Zeichenketten zurück. Generierte Referenzen: soundex, metaphone.

'recipe'|levenshtein( 'recipes' ) = {'recipe'|levenshtein( 'recipes' )}
'healthy'|similar_text( 'wealthy' ) = {'healthy'|similar_text( 'wealthy' )}
'Robert'|soundex = {'Robert'|soundex}, 'Rupert'|soundex = {'Rupert'|soundex}
'Thompson'|metaphone = {'Thompson'|metaphone}
'Thompson'|metaphone( 2 ) = {'Thompson'|metaphone( 2 )}

Ausgabe:

'recipe'|levenshtein( 'recipes' ) = 1
'healthy'|similar_text( 'wealthy' ) = 6
'Robert'|soundex = R163, 'Rupert'|soundex = R163
'Thompson'|metaphone = 0MPSN
'Thompson'|metaphone( 2 ) = 0M

Verwandte Seiten #

• PHP-Zeichenkettenfunktionen: umwandeln
• PHP-Zeichenkettenfunktionen: kodieren und formatieren
• Zeichenketten-Operatoren: wash, shorten, upcase und die anderen nativen Operatoren
• Zeichenketten-Operatoren für Designer
• Alle Template-Operatoren (generiert)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.