prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » countPCRE()

countPCRE()

Die Anzahl der Treffer eines PCRE berechnen.

Syntax:

any countPCRE ( text, regex )
any countPCRE ( text, regex, pcre_options )

Parameter:

regex Der Text, in dem gesucht wird. Listen und Maps werden rekursiv abgearbeitet. Skalare werden in eine Zeichenkette gewandelt. Das Funktionsergebnis hat dann dieselbe Listen- und Map-Struktur wie regex.
regex Als Parameter wird eine Zeichenkette mit dem Perl kompatiblen regulären Ausdruck (PCRE) oder eine durch compilePCRE() erzeugte ID erwartet. Im Falle einer ID wird der Parameter options ignoriert.
ignore_case Der Parameter pcre_options wird zwangsweise mittels int32() in eine 32-Bit-Ganzzahl gewandelt, die als Bitfeld interpretiert wird. Dieses Bitfeld enthält Optionen für die PCRE-Compilierung (siehe compilePCRE()). Ohne Angabe wird der Wert Null verwendet.

Falls regex eine ID enthält, dann wird dieser Parameter ignoriert.

Beschreibung:

Die Funktion zählt die Anzahl der Treffer des regulären Ausdruckes regex im Text text.

Funktionsergebnis:   ANY

Bei einem ungültigen regulären Ausdruck wird NONE mit gesetzten Fehlerbits als Funktionsergebnis geliefert.

Anderenfalls wird eine Struktur bestehend aus Listen und Maps zurückgeliefert, die der Struktur von text entspricht. Für jeden Skalar in text wird die Anzahl der Treffer im Ergebnis an der selben Position geschrieben.

Siehe auch:
 countRE()   itemPCRE()   findAllPCRE() 

Weitere ähnliche Funktionen:

Perl kompatible Reguläre Ausdrücke
Funktion Kurzinfo
compilePCRE() Eine PCRE übersetzen und einer eindeutigen ID zuweisen.
countPCRE() Die Anzahl der Treffer eines PCRE berechnen.
findAllPCRE() Alle Vorkommen einer Zeichenkette mittels eines PCRE suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findPCRE() Eine Zeichenkette mittels eines PCRE suchen und die Startposition dieser Zeichenkette ermitteln.
findTextPCRE() Eine Zeichenkette mittels eines PCRE suchen und den gefundenen Text als Ergebnis liefern.
itemPCRE()
m$findKeysPCRE()
splitPCRE()
substPCRE() Eine Zeichenkette mittels eines Perl kompatiblen regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
 
Suchen & Ersetzen
Funktion Kurzinfo
compilePCRE() Eine PCRE übersetzen und einer eindeutigen ID zuweisen.
compileRE() Eine RegEx übersetzen und einer eindeutigen ID zuweisen.
count()
countNum() Die Anzahl der numerischen Elemente zählen.
countPCRE() Die Anzahl der Treffer eines PCRE berechnen.
countRE() Die Anzahl der Treffer eines RegEx berechnen.
countVal() Die Anzahl der skalaren Elemente zählen.
find()
findAllPCRE() Alle Vorkommen einer Zeichenkette mittels eines PCRE suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findAllRE() Alle Vorkommen einer Zeichenkette mittels eines RegEx suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findPCRE() Eine Zeichenkette mittels eines PCRE suchen und die Startposition dieser Zeichenkette ermitteln.
findRE() Eine Zeichenkette mittels eines RegEx suchen und die Startposition dieser Zeichenkette ermitteln.
findReverse()
findTextPCRE() Eine Zeichenkette mittels eines PCRE suchen und den gefundenen Text als Ergebnis liefern.
findTextRE() Eine Zeichenkette mittels eines RegEx suchen und den gefundenen Text als Ergebnis liefern.
item()
itemPCRE()
itemRE()
m$find2() Ein Element in einer Map oder ersatzweise die virtuellen Nachbarn suchen.
m$find3() Ein Element in einer Map und seine virtuellen Nachbarn suchen.
m$findKeys()
m$findKeysBegin()
m$findKeysEnd()
m$findKeysPCRE()
m$findKeysRE()
m$findNext() Den Nachfolger in einer Map zu einem gegebenen Schlüssel finden.
m$findPrev() Den Vorgänger in einer Map zu einem gegebenen Schlüssel finden.
replace()
split()
splitEol() Aus einem Text eine Liste mit den einzelnen Zeilen erzeugen.
splitPCRE()
splitRE()
splitString()
subst() Eine Zeichenkette suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substChar() In einer Zeichenkette nach einzelnen Zeichen suchen und die Fundstellen durch Zeichenketten ersetzen.
substPCRE() Eine Zeichenkette mittels eines Perl kompatiblen regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substRE() Eine Zeichenkette mittels eines regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.