# Das Handbuch zum Editor von regulären Ausdrücken

Jesper K.
Pedersen

    blackie@kde.org

2001-07-03
0.1
&underFDL;
2001
Jesper K. Pedersen

Dieses Handbuch beschreibt die Benutzung des Editors für reguläre Ausdrücke

KDE
regulärer Ausdruck

## Einführung

Mit dem Editor für reguläre Ausdrücke können reguläre Ausdrücke mit graphischer Unterstützung zusammengestellt werden und müssen nicht mit komplizierten und kryptischen Zeichenfolgen definiert werden (Dies sieht zum Beispiel etwa so aus: `^.*kde\b`.) Die hauptsächlichen Nachteile dieser Art sind:

- Es ist für Nicht-Programmierer schwierig zu verstehen.

- Sie müssen einige Zeichen speziell kennzeichnen (um zum Beispiel einen Stern zu finden, müssen Sie `\*` tippen).

- Sie müssen sich die Regeln für die Reihenfolge merken. (Was trifft auf `x|y*` zu? Ein einzelnes `x` oder eine Anzahl `y`, ODER eine Anzahl `x` und `y`'s gemischt?)

Mit dem Editor für reguläre Ausdrücke können Sie reguläre Ausdrücke auf eindeutige Weise zeichnen. Der Editor beseitigt auf alle Fälle die zwei letzten Probleme. Ob dieser Editor reguläre Ausdrücke für Nicht-Programmierer zugänglich macht, weiss der Autor nicht. Falls Sie aber ein Nicht-Programmierer sind, der dank diesem Editor reguläre Ausdrücke verwenden kann, schicken sie ihm bitte eine kurze Nachricht.

## Was ein regulärer Ausdruck ist

In einem normalen Suchdialog eines Texteditors, können sie nur eine bestimmte Zeichenfolge als Suchtext eingeben. Mit einem regulären Ausdruck hingegen können Sie eine Menge von Zeichenketten suchen, die alle einem bestimmten Muster entsprechen. Beispiele hierfür sind: Suche das Wort `KDE` aber nur am Zeilenanfang. Oder suche das Wort `der` aber nur wenn es allein steht. Oder suche alle Dateien, die mit `test` beginnen und danach eine beliebige Anzahl Ziffern haben, wie `test107` und `test007`

Reguläre Ausdrücke werden zusammengesetzt aus kleineren regulären Ausdrücken, genau so wie Lego-Bauwerke aus kleineren Teilen zusammengesetzt werden. Genau gleich wie bei Lego gibt es auch für reguläre Ausdrücke elementare Bausteine. Diese werden im folgenden mit Beispielen vorgestellt.

### Suche nach normalem Text.

Wenn nur nach einem bestimmten Text gesucht werden soll, sind reguläre Ausdrücke keine speziell gute Wahl. Grund dafür ist, dass in regulären Ausdrücken gewisse Zeichen eine Spezialbedeutung besitzen. Diese sind `.*|$`. Wenn also nach dem Text `kde.` (also den Zeichen `kde` gefolgt von einem Punkt), gesucht werden soll, muss dies als `kde\.` angegeben werden. Der Editor für reguläre Ausdrücke übernimmt dieses sogenannte Escapen für Sie

### Finden von URLs

Wenn Sie in &kde; etwas das wie eine URL aussieht auswählen, so ermöglicht Ihnen &klipper;, diese ausgewählte URL mit &konqueror; zu öffnen.

&klipper; ermöglicht dies, indem es den ausgewählten Text mit mehreren verschiedenen regulären Ausdrücken vergleicht und bei Übereinstimmung eine der URL entsprechende Funktion anbietet.

Der reguläre Ausdruck für URLs sagt (unter anderem), dass die Adresse mit `http://` starten muss. Dies wird durch den regulären Ausdruck erreicht, der ein Dach `^`vor das `http://`setzt.

Die erwähnte Anwendung ist ein Beispiel bei dem die Position übereinstimmen muss. Auf ähnliche Weise kann auch das Ende der Zeile durch das `$`-Zeichen gefunden werden.

### Suche nach dem Wort `der`, aber nicht `o` der, `glie` der `t` oder der `einst`.

Zwei weitere Grenzen können auf gleiche Weise gefunden werden. Einerseits die Wortgrenze andererseits die Nicht-Wort-Grenze. Diese werden durch `\b` für die Wortgrenze und `\B` für die Nicht-Wort-Grenze gekennzeichnet.

So kann also die Suche nach dem Wort `der` durch den regulären Ausdruck `\bthe\b` erfolgen. Dies bedeutet, dass wir nach dem Wort `der` ohne Buchstaben hinten und vorne (also einer Wortgrenze) suchen.

Die vier Grenzen für reguläre Ausdrücke werden im Editor für reguläre Ausdrücke über die vierGrenzen-Werkzeuge eingefügt.

### Suche nach entweder `dies` oder `das`

Angenommen Sie wollen nach den beiden Wörtern `dies` und `das` suchen. Mit einer normalen Suchfunktion sind Sie gezwungen, dies in zwei Schritten durchzuführen: Im ersten suchen Sie nach `dies`, im zweiten nach `das`.

Mit der Benutzung von regulären Ausdrücken, ist es möglich, gleichzeitig nach beiden Begriffen zu suchen. Hierzu wird der Ausdruck `dies|das` verwendet, die beiden gesuchten Wörter also durch einen vertikalen Strich getrennt. Auf beiden Seiten des vertikalen Striches können wiederum reguläre Ausdrücke stehen. Es ist also nicht nur möglich, nach zwei unterschiedlichen Wörtern, sondern sogar nach zwei unterschiedlichen regulären Ausdrücken zu suchen.

Im Editor für reguläre Ausdrücke schreiben Sie den vertikalen Strich nicht selbst, sondern wählen stattdessen das Alternativen-Werkzeug und fügen die verschiedenen Teile (die selbst reguläre Ausdrücke sind) übereinander.

### Finden von irgendwas

Reguläre Ausdrücke werden oft mit den Platzhaltern auf der Befehlszeile verglichen, also der Möglichkeit eine Menge von Dateien mit dem Stern (*) oder dem Fragezeichen (?) einzuschränken. Sie kennen sicher die Platzhalter in den folgenden Beispielen:

- `rm *~` - Hier ist `*~` der Platzhalter für alle Dateien, die auf `~` enden.

- cat test??.res - entspricht allen Dateien, die mit `test` beginnen, dann zwei beliebige Zeichen enthalten und schließlich von der Dateierweiterung `.res` gefolgt sind.

Auf der Befehlszeile entspricht der Stern (*) einer beliebigen Anzahl beliebiger Zeichen. Mit anderen Worten entspricht der Stern allem. Für reguläre Ausdrücke wird das gleiche mit der Zeichenfolge `.*` erreicht. Der Punkt entspricht jedem Einzelzeichen, also jeweils nur einem einzigen Zeichen und der Stern besagt, dass der reguläre Ausdruck davor beliebig oft wiederholt sein muss. Zusammen ergibt das also eine beliebige Anzahl beliebiger Zeichen.

Auf den ersten Blick erscheint dies übermässig kompliziert, eröffnet aber mächtige Möglichkeiten. Ein weiterer einfacher regulärer Ausdruck ist `a`. Der Buchstabe `a` stellt einen regulären Ausdruck dar, der einem einzelnen Buchstaben entspricht, dem Buchstaben `a`. Wenn wir diesen mit einem Stern (*) kombinieren, also `a*`, haben wir einen regulären Ausdruck, der jeder beliebigen Anzahl a's entspricht.

Es ist möglich, mehrere reguläre Ausdrücke hintereinander zu stellen, z.B. `ba(na)*`. `(na)*` sagt aus, dass der Inhalt zwischen den Klammern beliebig oft wiederholt wird. Mit diesem Ausdruck würden Sie also unter anderem die folgenden Texte finden: `ba`, `bana`, `banana`, `banananananananana`.

Mit diesen Informationen ist es jetzt nicht schwer, die Befehlszeilen-Platzhalter `test??.res` als regulären Ausdruck nachzubilden. Dieser heisst `test..\.res`. Der einzelne Punkt ist jedes beliebige Zeichen. Um einen einzelnen Punkt zu finden, muss `\.` angegeben werden. Dies wird Escapen genannt. Mit anderen Worten findet der reguläre Ausdruck `\.` einen Punkt, während der einzelne Punkt jedes Zeichen findet.

Im Editor für reguläre Ausdrücke wird ein wiederholter regulärer Ausdrcuk mit dem Wiederholungs-Werkzeug erstellt.

### Ersetzen von `&` mit `&amp;` in einem HTML-Dokument

In HTML muss das Zeichen `&` als `&amp;` geschrieben werden. Das ist ähnlich wie das Escapen in einem regulären Ausdruck.

Stellen Sie sich vor, Sie hätten in einem gewöhnlichen Editor (z.B. Kate oder (X)Emacs) ein HTML-Dokument erstellt und hätten dabei diese Regel vollkommen vergessen. In diesem Fall müssten Sie also alle Vorkommen von `&` durch `&amp;` ersetzen.

Dies können Sie problemlos mit einem gewöhnlichen Ersetzen erledigen. Wenn Sie allerdings manchmal an die Regel gedacht haben, funktioniert das nicht. Ein gewöhnliches Ersetzen würde zur Folge haben, dass `&amp;` durch `&amp;amp;` ersetzt würde.

Was eigentlich gemacht werden soll, ist alle Vorkommen von `&` ersetzt werden sollen, die nicht von den Buchstaben `amp;` gefolgt sind. Dies wird mit vorausschauenden regulären Ausdrücken erreicht.

Der reguläre Ausdruck, der ein kaufmännisches Und nur dann findet, wenn es nicht von den Buchstaben `amp;` gefolgt ist, sieht wie folgt aus: `&(?!amp;)` Es ist natürlich leichter, diesen Ausdruck im Editor zu lesen, wo dafür die vorausschauenden Werkzeuge zur Verfügung stehen.

## Benutzung des Editors für reguläre Ausdrücke

Dieses Kapitel erklärt die Arbeitsweise des Editors für reguläre Ausdrücke.

### Aufbau der Benutzungsschnittstelle

Der bedeutendste Teil des Editors ist natürlich der Arbeitsbereich, wo ein regulärer Ausdruck gezeichnet wird.

Oberhalb des Arbeitsbereichs gibt es zwei Werkzeugleisten, die Erste enthält Bearbeitungsaktionen - ähnlich den Werkzeugen in einem Zeichenprogramm. Die zweite Werkzeugleiste enthält Knöpfe für die Bearbeitungsfunktionen (Kopieren, Einfügen etc.)

Unterhalb des Arbeitsbereichs steht der aktuell bearbeitete reguläre Ausdruck in seiner ASCII-Notation. Diese wird laufend nachgeführt, wenn im graphischen Editor eine Änderung vorgenommen wird. Umgekehrt können auch Änderungen in der ASCII-Notation vorgenommen werden, die dann ebenfalls unmittelbar auch im graphischen Editor dargestellt werden.

Schlussendlich finden sich auf der linken Seite des Eingabebereichs eine Anzahl vordefinierter regulärer Ausdrücke. Sie dienen zu zweierlei Zwecken: (1) Wird ein vordefinierter regulärer Ausdruck verwendet wird er verständlicher dargestellt. So wird zum Beispiel der reguläre Ausdruck "."durch ein Symbol mit dem Text "anything"dargestellt. (2) Wenn Sie einen regulären Ausdruck erzeugen, können Sie vielleicht Teile dafür aus der Menge der vordefinierten Ausdrücke benutzen. Wie Sie selbst definierte reguläre Ausdrücke speichern können, sehen sie unter Benutzerdefinierte reguläre Ausdrücke.

### Bearbeitungswerkzeuge

Für diesen Abschnitt ist es erforderlich, dass Sie das Kapitel Was ist ein regulärer Ausdruck schon gelesen haben oder über äquivalentes Wissen verfügen.

Alle Bearbeitungswerkzeuge befinden sich oberhalb des Arbeitsbereichs. Im folgenden wird jedes einzelne davon beschrieben.

#### Auswahlwerkzeug

Das Auswahlwerkzeug wird gebraucht, um Elemente auszuwählen, welche ausgeschnitten oder verschoben werden sollen. Es funktioniert gleich wie in Zeichenprogrammen.

#### Textwerkzeug

Dieses Werkzeug dient dem Einfügen von gewöhnlichem Text. Der Text wird Zeichen für Zeichen auf Gleichheit überprüft, es müssen hierfür auch keine Zeichen speziell gekennzeichnet werden.

#### Buchstabenwerkzeug

Mit diesem Werkzeug werden Zeichenbereiche eingefügt. Zum Beispiel alle Zeichen zwischen "a" und "z" oder "0" und "9". Bei der Auswahl dieses Werkzeugs erscheint ein Dialog, in dem die Zeichenbereiche eingegeben werden können.

Siehe die Beschreibung von wiederholten regulären Ausdrücken.

#### Werkzeug für beliebige Zeichen

Dies ist der reguläre Ausdruck "Punkt" (.). Er entspricht jedem beliebigen Zeichen.

#### Wiederholungswerkzeug

Dieses Werkzeug dient dem Wiederholen von Teilausdrücken. Darunter sind die regulären Ausdrücke "Stern" (*), "Plus" (+), "Fragezeichen" (?) und Bereiche ({3,5}). Beim Einfügen mit diesem Werkzeug erscheint ein Dialogfenster, in dem die Anzahl Wiederholungen eingegeben werden kann.

Was wiederholt werden soll, kommt im Innern dieses Elements zu stehen.

Wiederholte Teilausdrücke können sowohl von innen nach außen als auch von außen nach innen erzeugt werden. Es spielt also keine Rolle, ob zuerst die Wiederholung oder der zu wiederholende Teilausdruck eingefügt wird.

Siehe die Beschreibung von Wiederholten regulären Ausdrücken.

#### Alternativen-Werkzeug

Dies ist der reguläre Ausdruck der Alternative (|). Alle Alternativen werden übereinander gezeichnet.

Siehe die Beschreibung des Alternativen regulären Ausdrucks

#### Zusammensetzungswerkzeug

Das Zusammensetzungswerkzeug stellt keinen regulären Ausdruck dar. Es wird stattdessen gebraucht, um Teilausdrücke zusammenzufassen und diese nur durch einen Titel gekennzeichnet, darzustellen.

#### Zeilenanfang und Zeilenende-Werkzeuge

Die Zeilenanfangs und -ende-Werkzeuge finden den Beginn respektive das Ende einer Zeile.

Siehe die Beschreibung von Ortsbezogenen regulären Ausdrücken.

#### (Nicht)Wortgrenzen-Werkzeuge:

Die Wortgrenzen-Werkzeuge finden Wortgrenzen respektive Nicht-Wortgrenzen.

Siehe die Beschreibung von Wortgrenzen in regulären Ausdrücken

#### Positiv und negativ vorausschauende Werkzeuge

Die vorausschauenden Werkzeuge definieren entweder einen positiven oder negativen regulären Ausdruck. Der gefundene Teilausdruck selbst ist jedoch nicht Teil der gesamten gefundenen Zeichenkette.

Bemerkung: Vorausschauende reguläre Ausdrücke dürfen nur am Ende von regulären Ausdrücken verwendet werden. Der Editor für reguläre Ausdrücke erzwingt dies jedoch nicht.

Siehe die Beschreibung von vorausschauenden regulären Ausdrücken.

### Benutzerdefinierte reguläre Ausdrücke

Links vom Arbeitsbereich ist eine Liste mit benutzerdefinierten regulären Ausdrücken. Einige vordefinierte reguläre Ausdrücke werden mit &kde; mitgeliefert, weitere können Sie selbst speichern.

Mit diesen regulären Ausdrücken wird zweierlei erreicht (Details. Erstens werden Bausteine für eigene reguläre Ausdrücke zur Verfügung gestellt und zweitens werden häufig gebrauchte reguläre Ausdrücke schöner dargestellt.

Ihren eigenen regulären Ausdruck speichern Sie, indem Sie im Arbeitsbereich auf die rechte Maustaste klicken und `Regulären Ausdruck speichern` wählen.

Wenn der zu speichernde reguläre Ausdruck eine Zusammensetzung ist, so werden reguläre Ausdrücke, die ihn verwenden, ebenfalls schöner dargestellt.

Benutzerdefinierte reguläre Ausdrücke können gelöscht oder umbenannt werden, indem mit der rechten Maustaste das Kontextmenü geöffnet und der entsprechende Menüeintrag ausgewählt wird.

## Berichten von Fehlern und Wünschen

Fehlermeldungen und Wünsche zur Funktionalität werden mit der KDE-Fehlerverfolgung gemeldet. Bevor Sie eine Fehlermeldung abschicken oder eine Funktionalitätserweiterung wünschen, prüfen Sie bitte, ob nicht schon jemand dasselbe bemerkt oder gewünscht hat.

## Fragen und Antworten

### Unterstützt der Editor für reguläre Ausdrücke Rückwärtsreferenzen?

Im Moment wird dies nicht unterstützt. Es ist für die nächste Version geplant.

### Unterstützt der Editor für reguläre Ausdrücke die Anzeige von Übereinstimmungen?

Nein, es ist Ziel, dies in der nächsten Version zur Verfügung zu stellen.

### Ich bin Entwickler einer &kde;-Anwendung. Wie kann ich dieses GUI-Element in meiner Anwendung benutzen?

Vergleichen Sie die Dokumentation für die Klasse KRegExpEditorInterface.

### Ich kann den Knopf Regulären Ausdruck bearbeiten in &konqueror; oder einer anderen &kde;-Anwendung nicht finden.

Der Editor für reguläre Ausdrücke befindet sich im Paket kdeutils. Ist dieses nicht installiert, gibt es auch den Knopf Regulären Ausdruck bearbeiten nicht.

## Mitwirkende und Lizenz

Copyright für die Dokumentation 2001, Jesper K. Pedersen blackie@kde.org Copyright für die Übersetzung 2002, Gregor Zumstein zumstein@ssd.ethz.ch

&underGPL; &underFDL;