WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

preg_match()

Sucht den ersten Treffer. 1 bedeutet Treffer, 0 keinen Treffer und false einen Kompilierungs- oder Ausführungsfehler.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

preg_match(string $pattern, string $subject, array &$matches = null, int $flags = 0, int $offset = 0): int|false

Sucht den ersten Treffer. 1 bedeutet Treffer, 0 keinen Treffer und false einen Kompilierungs- oder Ausführungsfehler. Index null enthält den ganzen Treffer. PREG_OFFSET_CAPTURE ergänzt jede Gruppe um ihre Byteposition, auch bei UTF-8. Auch der Eingabeparameter $offset zählt Bytes. Liegt er bei Modifikator u innerhalb eines UTF-8-Zeichens, folgen false und PREG_BAD_UTF8_OFFSET_ERROR.

Signatur

preg_match(string $pattern, string $subject, array &$matches = null, int $flags = 0, int $offset = 0): int|false

Ausgabe des Beispiels

[1,[["A42",3],["42",4]],0]
[false,true]

Beispiele

<?php
$input="é A42"; $found=preg_match("~A(\\d+)~u",$input,$m,PREG_OFFSET_CAPTURE);
echo json_encode([$found,$m,preg_match("~Z~",$input)]);
$bad=preg_match("~.~u","é",$matches,0,1); echo "\n",json_encode([$bad,preg_last_error()===PREG_BAD_UTF8_OFFSET_ERROR]);

Ergebnis

[1,[["A42",3],["42",4]],0]
[false,true]

Quellen