PHP Portal » PHP Handbuch » preg_match_all

Werbung

preg_match_all

PCRE-Funktionen PHP Manual

(PHP 4, PHP 5)

preg_match_all — Führt eine umfassende Suche nach Übereinstimmungen mit regulärem Ausdruck durch

Beschreibung

int preg_match_all ( string $pattern , string $subject , array &$matches [, int $flags [, int $offset ]] )

Durchsucht subject nach allen Übereinstimmungen mit dem in pattern angegebenen regulären Ausdruck und legt sie in der durch flags festgelegten Reihenfolge in matches ab.

Nachdem die erste Übereinstimmung gefunden wurde, wird die nachfolgende Suche jeweils am Ende der letzten Übereinstimmung fortgesetzt.

Parameter-Liste

pattern

Der Ausdruck, nach dem gesucht werden soll, als Zeichenkette.

subject

Die zu durchsuchende Zeichenkette.

matches

Ein mehrdimensionales Array mit allen gefundenen Übereinstimmungen, das den flags entsprechend sortiert ist.

flags

Kann eine Kombination folgender Flags sein (beachten Sie, dass es keinen Sinn hat, PREG_PATTERN_ORDER zusammen mit PREG_SET_ORDER zu verwenden):

PREG_PATTERN_ORDER

Ordnet die Ergebnisse so an, dass $matches[0] ein Array von Übereinstimmungen mit dem kompletten Suchmuster ist, $matches[1] ein Array von Zeichenketten, die auf das erste eingeklammerte Teilsuchmuster passen und so weiter.

PHP Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>Beispiel: </b><div align=left>das ist ein Test</div>", $ausgabe, PREG_PATTERN_ORDER); echo $ausgabe[0][0] . ", " . $ausgabe[0][1] . "\n"; echo $ausgabe[1][0] . ", " . $ausgabe[1][1] . "\n"; </code></div> </div> <p class="para">Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p> <div class="example-contents screen"> <div class="cdata"><pre> <b>Beispiel: </b>, <div align=left>das ist ein Test</div> Beispiel: , das ist ein Test </pre></div> </div> <p class="para"> Also enthält <var class="varname">$ausgabe[0]</var> ein Array von Zeichenketten, die auf das komplette Suchmuster passen und <var class="varname">$ausgabe[1]</var> ein Array von Zeichenketten, die sich zwischen Tags befinden. </p> </div> </dd> <dt class="varlistentry"> <span class="term"><b><tt class="constant">PREG_SET_ORDER</tt></b> </dt><dd class="listitem"> <p class="para"> Ordnet die Ergebnisse so an, dass <var class="varname">$matches[0]</var> ein Array aus dem ersten Satz von Übereinstimmungen ist, <var class="varname">$matches[1]</var> ein Array aus dem zweiten Satz von Übereinstimmungen und so weiter. </p><div class="informalexample"> <div class="example-contents programlisting"> <div class="phpcode"><code> preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>Beispiel: </b><div align="left">das ist ein Test</div>", $ausgabe, PREG_SET_ORDER); echo $ausgabe[0][0] . ", " . $ausgabe[0][1] . "\n"; echo $ausgabe[1][0] . ", " . $ausgabe[1][1] . "\n"; </code></div> </div> <p class="para">Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p> <div class="example-contents screen"> <div class="cdata"><pre> <b>Beispiel: </b>, Beispiel: <div align="left">das ist ein Test</div>, das ist ein Test </pre></div> </div> </div> </dd> <dt class="varlistentry"> <span class="term"><b><tt class="constant">PREG_OFFSET_CAPTURE</tt></b> </dt><dd class="listitem"> <p class="para"> Wenn dieses Flag gesetzt ist, wird mit jeder gefundenen Übereinstimmung der dazugehörige Versatz in der Zeichenkette zurückgegeben. Beachten Sie, dass dies den Wert von <i><tt class="parameter">matches</tt></i> in ein Array ändert, in dem jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als Element <i>0</i> und deren Stelle in <i><tt class="parameter">subject</tt></i> als Element <i>1</i> besteht. </p> </dd> </dl> <p class="para"> Falls kein Flag für die Anordnung angegeben wurde, wird <b><tt class="constant">PREG_PATTERN_ORDER</tt></b> angenommen. </p> </dd> <dt class="varlistentry"> <span class="term"><i><tt class="parameter">offset</tt></i> </dt><dd class="listitem"> <p class="para"> Normalerweise beginnt die Suche am Anfang der Zeichenkette. Der optionale Parameter <i><tt class="parameter">offset</tt></i> kann verwendet werden, um eine andere Stelle in Bytes anzugeben, ab der gesucht werden soll. </p> <blockquote><p><b class="note">Hinweis</b>: Die Verwendung von <i><tt class="parameter">offset</tt></i> entspricht nicht der Übergabe von <i>substr($zeichenkette, $versatz)</i> an Stelle der Zeichenkette an <b>preg_match_all()</b>, weil <i><tt class="parameter">pattern</tt></i> Angaben wie zum Beispiel <em class="emphasis">^</em>, <em class="emphasis">$</em> oder <em class="emphasis">(?<=x)</em> enthalten kann. Für Beispiele siehe <a href="manual/function.preg-match.html" class="function">preg_match()</a>. </p></blockquote> </dd> </dl> </div> <a name="function.preg-match-all.returnvalues"></a><div class="refsect1 returnvalues"> <h3 class="title">Rückgabewerte</h3> <p class="para"> Gibt die Anzahl der Übereinstimmungen mit dem kompletten Suchmuster zurück (die auch Null sein kann) oder <b><tt class="constant">FALSE</tt></b>, falls ein Fehler auftrat. </p> </div> <a name="function.preg-match-all.changelog"></a><div class="refsect1 changelog"> <h3 class="title">Changelog</h3> <p class="para"> </p><table class="doctable informaltable"> <thead valign="middle"> <tr valign="middle"> <th>Version</th> <th>Beschreibung</th> </tr> </thead> <tbody valign="middle" class="tbody"> <tr valign="middle"> <td align="left">5.2.2</td> <td align="left"> Benannte Teilsuchmuster(named subpatterns) akzeptieren nun die Syntaxen <i>(?<name>)</i> und <i>(?'name')</i> sowie <i>(?P<name>)</i>. Vorherige Versionen akzeptierten nur <i>(?P<name>)</i>. </td> </tr> <tr valign="middle"> <td align="left">4.3.3</td> <td align="left">Den Parameter <i><tt class="parameter">offset</tt></i> hinzugefügt</td> </tr> <tr valign="middle"> <td align="left">4.3.0</td> <td align="left"> Das Flag <b><tt class="constant">PREG_OFFSET_CAPTURE</tt></b> hinzugefügt </td> </tr> </tbody> </table> </div> <a name="function.preg-match-all.examples"></a><div class="refsect1 examples"> <h3 class="title">Beispiele</h3> <p class="para"> </p><div class="example"> <p><b>Beispiel #1 Alle Telefonnummern aus einem Text holen.</b></p> <div class="example-contents programlisting"> <div class="phpcode"><code> preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", "Wählen Sie 555-1212 oder 1-800-555-1212", $telefon);

PHP Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Das \\2 ist ein Beispiel für Rückreferenzierung. Es teilt pcre mit, dass // der reguläre Ausdruck auf den für das zweite Klammerpaar gefundenen // Ausdruck selbst, also in diesem Fall auf den für([\w]+) gefundenen // Ausdruck passen muss. // Der zusätzliche Backslash wird wegen der doppelten Anführungsstriche // benötigt. $html = "<b>fett gedruckter Text</b><a href=howdy.html>klick mich an</a>"; preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $treffer, PREG_SET_ORDER); foreach ($treffer as $wert) { echo "gefunden: " . $wert[0] . "\n"; echo "Teil 1: " . $wert[1] . "\n"; echo "Teil 2: " . $wert[2] . "\n"; echo "Teil 3: " . $wert[3] . "\n"; echo "Teil 4: " . $wert[4] . "\n\n"; }

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

gefunden: <b>fett gedruckter Text</b>
Teil 1: <b>
Teil 2: b
Teil 3: fett gedruckter Text
Teil 4: </b>
gefunden: <a href=howdy.html>klick mich an</a>
Teil 1: <a href=howdy.html>
Teil 2: a
Teil 3: klick mich an
Teil 4: </a>

PHP Code
1
2
3
4
5
6
7
8
9
10
$str = <<<FOO a: 1 b: 2 c: 3 FOO; preg_match_all('/(?P<name>\w+): (?P<zahl>\d+)/', $str, $treffer); /* Folgendes funktioniert ab PHP 5.2.2(PCRE 7.0) ebenfalls, für die * Rückwärtskompatibilität wird aber die vorherige Form empfohlen. */ // preg_match_all('/(?<name>\w+): (?<zahl>\d+)/', $str, $treffer); print_r($treffer);

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => Array
        (
            [0] => a: 1
            [1] => b: 2
            [2] => c: 3
        )
    [name] => Array
        (
            [0] => a
            [1] => b
            [2] => c
        )
    [1] => Array
        (
            [0] => a
            [1] => b
            [2] => c
        )
    [zahl] => Array
        (
            [0] => 1
            [1] => 2
            [2] => 3
        )
    [2] => Array
        (
            [0] => 1
            [1] => 2
            [2] => 3
        )
)

Siehe auch

  • preg_match() - Führt eine Suche mit einem regulären Ausdruck durch
  • preg_replace() - Sucht und ersetzt mit regulären Ausdrücken
  • preg_split() - Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks
PCRE-Funktionen PHP Manual