| << Gesamtübersicht | << Klassenübersicht | Details der Klasse | Funktionsbeschreibungen |
SRegExp
Klasse für die Verwendung regulärer Ausdrücke. [Mehr ...]
Vererbung
| Basisklassen(n) | abgeleitete Klassen | |
|---|---|---|
| SRegExp |
|
Attribute
protected:
| Attribut | Typ | Beschreibung |
|---|---|---|
| lastCompiledRE | pcre* | Letzter ausgeführter Regulärer Ausdruck |
| lastContent | SString | Letzter verarbeiteter String |
| lastExecPA | int | Letzter Rückgabe-Wert der Funktion pcre_exec() |
| ovector[OVECCOUNT] | int | Speicher für gefundene Übereinstimmungen |
Operationen
public:
| Name | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| compile | const SString& regExpression | BOOL | Kompiliert den regulären Ausdruck zur Vorbereitung der Suche. |
| findAll | const SString& content, const SString& regExpression, SStringList& paMatchStrings, SNumList* pFoundPos=NULL |
int | Sucht alle Übereinstimmungen von 'regExpression' in 'content'. |
| findAll | const SString& content, SStringList& paMatchStrings, SNumList* pFoundPos=NULL |
int | Sucht alle Übereinstimmungen von mit der letzten 'regExpression' in 'content'. |
| findOne | const SString& content, const SString& regExpression, int start=0 |
int | Sucht die erste Übereinstimmung von 'regExpression' in 'content'. |
| findOne | const SString& content, int start=0 |
int | Sucht die erste Übereinstimmung von mit der letzten 'regExpression' in 'content'. |
| getFoundSubstrings | SStringList& paSubstrings | int | Fügt an eine vorhandene Stringliste gefunden Teilstrings an. |
| replace | const SString& content, const SString& regExpression, const SString& replacement |
SString | Ersetzt Teilstrings, auf die der Reguläre Ausdruck passt durch die angegebene Zeichenkette. |
| replace | const SString& content, const SString& replacement |
SString | Ersetzt Teilstrings, auf die der letzte Reguläre Ausdruck passt durch die angegebene Zeichenkette. |
protected:
| Name | Parameter | Rückgabewert | Beschreibung |
|---|---|---|---|
| exec | const SString& content, int start=0, int options=PCRE_NO_UTF8_CHECK |
BOOL | Wendet den letzten kompilierten regulären Ausdruck auf den übergebenen String an. |
Detailbeschreibung SRegExp
Klasse für die Verwendung regulärer Ausdrücke.
Reguläre Ausdrücke dienen der Mustersuche in Zeichenketten.
Für weiterführende Informationen, auch zur Verwendung von regulären Ausdrücken dient das Beispiel RegExp.
Funktionsbeschreibungen
| compile(const SString& regExpression) BOOL |
|
Kompiliert den regulären Ausdruck zur Vorbereitung der Suche.
Parameter:
| regExpression | der reguläre Ausdruck |
Rückgabe:
| BOOL | Kompilieren erfolgreich. |
| exec(const SString& content, int start=0, int options=PCRE_NO_UTF8_CHECK) BOOL |
|
Wendet den letzten kompilierten regulären Ausdruck auf den übergebenen String an.
Parameter:
| content | zu überprüfende Zeichenkette |
| start | Startposition der Überprüfung |
| options | Optionen nach PCRE |
Rückgabe:
| BOOL | true wenn gefunden |
| findAll(const SString& content, const SString& regExpression, SStringList& paMatchStrings, SNumList* pFoundPos=NULL) int |
|
Sucht alle Übereinstimmungen von 'regExpression' in 'content'.
Parameter:
| content | Zeichenkette in der gesucht werden soll |
| regExpression | der Reguläre Ausdruck |
| paMatchStrings | Stringliste zur Ausgabe der Ergebnisse |
Rückgabe:
| int | Anzahl der gefunden Substrings. |
| paMatchStrings | Liste der gefundenen Zeichenketten |
| findAll(const SString& content, SStringList& paMatchStrings, SNumList* pFoundPos=NULL) int |
|
Sucht alle Übereinstimmungen von mit der letzten 'regExpression' in 'content'.
Parameter:
| content | Zeichenkette in der gesucht werden soll |
| paMatchStrings | Stringliste zur Ausgabe der Ergebnisse |
Rückgabe:
| int | Anzahl der gefunden Substrings. |
| paMatchStrings | Liste der gefundenen Zeichenketten |
| findOne(const SString& content, const SString& regExpression, int start=0) int |
|
Sucht die erste Übereinstimmung von 'regExpression' in 'content'.
Nach der erfolgreichen Suche können gespeicherte Substrings mittels getFoundSubstrings() abgeholt werden.
Parameter:
| content | Text in dem gesucht werden soll |
| regExpression | regulärer Ausdruck = Suchmuster |
| start | Position im Text ab der gesucht werden soll |
Rückgabe:
| int | Position (mit Null beginnend) in 'content', an der die Übereinstimmung beginnt. Wenn nichts gefunden wurde wird ein Wert kleiner als 0 zurückgegeben. |
| findOne(const SString& content, int start=0) int |
|
Sucht die erste Übereinstimmung von mit der letzten 'regExpression' in 'content'.
Nach der erfolgreichen Suche können gespeicherte Substrings mittels getFoundSubstrings() abgeholt werden.
Parameter:
| content | Text in dem gesucht werden soll |
| start | Position im Text ab der gesucht werden soll |
Rückgabe:
| int | Position (mit Null beginnend) in 'content', an der die Übereinstimmung beginnt. Wenn nichts gefunden wurde wird ein Wert kleiner als 0 zurückgegeben. |
| getFoundSubstrings(SStringList& paSubstrings) int |
|
Fügt an eine vorhandene Stringliste gefunden Teilstrings an.
Der erste angefügte Teilstring ist das Ergebnis der Suche, alle weiteren Teilstrings sind auf Grund von runden Klammern gespeicherte Bestandteile.
Parameter:
| paSubstrings | Liste an die angehängt werden soll |
Rückgabe:
| int | Anzahl der angefügten Suchergebnisse |
| psSubstrings | vervollständigte Stringliste |
| replace(const SString& content, const SString& regExpression, const SString& replacement) SString |
|
Ersetzt Teilstrings, auf die der Reguläre Ausdruck passt durch die angegebene Zeichenkette.
Parameter:
| content | Originaltext |
| regExpression | der reguläre Ausdruck |
| replacement | der einzusetzende String |
Rückgabe:
| SString | die geänderte Zeichenkette |
| replace(const SString& content, const SString& replacement) SString |
|
Ersetzt Teilstrings, auf die der letzte Reguläre Ausdruck passt durch die angegebene Zeichenkette.
Parameter:
| content | Originaltext |
| replacement | der einzusetzende String, ggf mit Ersetzungen in der Form "{{1}}" |
Rückgabe:
| SString | die geänderte Zeichenkette |
| << Gesamtübersicht | << Klassenübersicht | Details der Klasse | Funktionsbeschreibungen |