glücklich - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

happy – der Parser-Generator für Haskell

ZUSAMMENFASSUNG

glücklich [zur Auswahl] ... Datei [zur Auswahl] ...

BESCHREIBUNG

Diese Handbuchseite dokumentiert kurz die glücklich Befehl.

Diese Handbuchseite wurde für die Debian GNU/Linux-Distribution geschrieben, weil das Original
Das Programm verfügt nicht über eine Handbuchseite. Stattdessen gibt es Dokumentation in verschiedenen anderen
Formate, einschließlich DVI, Info und HTML; siehe unten.

glücklich ist ein Parser-Generatorsystem für Haskell. „HAPPY“ ist ein Legastheniker-Akronym für „A
Yacc-ähnlicher Haskell-Parser-Generator.

Es gibt zwei Arten von Grammatikdateien: Datei.y und file.ly, wobei letzterer die beobachtet
Umgekehrte Kommentar-Vogelverfolgungskonvention (d. h. jede Codezeile muss mit „>“ beginnen). Der
Beispiele verteilt mit glücklich sind alle .ly Form.

Vorsichtsmaßnahme: Bei der Verwendung hbc (Chalmers Haskell) Die Befehlsargumentstruktur ist geringfügig
anders. Dies liegt daran, dass das hbc-Laufzeitsystem einige Flags als seine eigenen annimmt (z
Festlegen von Dingen wie der Heap-Größe usw.). Dieses Problem kann durch Hinzufügen von a umgangen werden
Geben Sie einen einzelnen Bindestrich („-“) in Ihre Befehlszeile ein. Wenn Sie also eine hbc-generierte Version von Happy verwenden,
Die Argumentstruktur ist:

glücklich - [zur Auswahl] ... Datei [zur Auswahl] ...

OPTIONAL

Die Programme folgen der üblichen GNU-Befehlszeilensyntax, mit langen Optionen, die mit zwei beginnen
Bindestriche (`--'). Nachfolgend finden Sie eine Zusammenfassung der Optionen. Eine vollständige Beschreibung finden Sie unter
die andere Dokumentation.

-h, --help
Zusammenfassung der Optionen anzeigen.

-v, --Version
Versionsinformationen auf der Standardausgabe drucken und dann erfolgreich beenden.

-a, --array
Weist Happy an, einen Parser mithilfe eines Array-basierten Shift-Reduction-Parsers zu generieren.
Bei Verwendung in Verbindung mit -g, werden die Arrays als Strings codiert, was zur Folge hat
in schnelleren Parsern. Ohne -gwerden Standard-Haskell-Arrays verwendet.

-g, --ghc
Weist Happy an, einen Parser zu generieren, der zum Abrufen GHC-spezifische Erweiterungen verwendet
schnellerer Code.

-c, --zwingen
Verwenden Sie GHCs unsicherCoerce# Erweiterung, um kleinere, schnellere Parser zu generieren. Ein Nachteil
besteht darin, dass eine gewisse Typsicherheit verloren geht, was bedeutet, dass ein Parser mit generiert wurde -c Mai
Läuft gut kompilieren, stürzt aber zur Laufzeit ab. Stellen Sie sicher, dass Sie Ihre Grammatik ohne kompilieren -c
Stellen Sie zunächst sicher, dass der Typ korrekt ist.

Diese Option hat einen erheblichen Einfluss auf die Leistung des Ergebnisses
Parser, aber denken Sie daran, dass auf diese Weise generierte Parser nur von kompiliert werden können
GHC 3.02 und höher.

Diese Option darf nur in Verbindung mit verwendet werden -g.

-d, --debuggen
Generieren Sie einen Parser, an den Debugging-Informationen ausgegeben werden stderr zur Laufzeit,
einschließlich aller durchgeführten Verschiebungen, Reduzierungen, Zustandsübergänge und Token-Eingaben
durch den Parser.

Diese Option darf nur in Verbindung mit verwendet werden -a.

-i [FILE], --die Info[=FILE]
Leitet gerne eine Info-Datei mit detaillierten Informationen zum Thema an
Grammatik, Parser-Zustände, Parser-Aktionen und Konflikte. Infodateien sind dabei von entscheidender Bedeutung
das Debuggen von Grammatiken.

Das Argument Dateiname ist optional. Wenn es weggelassen wird, wird in die Infodatei geschrieben
Dateiinformation (woher FILE ist der Name der Eingabedatei ohne entfernte Erweiterung).

-o FILE, --outfile=FILE
Gibt das Ziel des generierten Parsermoduls an. Wenn weggelassen, der Parser
wird platziert DATEI.hs, Wobei FILE ist der Name der Eingabedatei mit any
Erweiterung entfernt. Wenn FILE is - Der generierte Parser wird an den Standard gesendet
Ausgabe.

-m NAME/FUNKTION, --magic-name=NAME/FUNKTION
Happy stellt allen intern verwendeten Symbolen eines davon voran glücklich or glücklich. Nach
Verwenden Sie eine andere Zeichenfolge, beispielsweise wenn die Verwendung von glücklich steht im Konflikt mit einem von
Wenn Sie Ihre eigenen Funktionen verwenden möchten, geben Sie das Präfix mit an -m .

-t DIR, --Vorlage=DIR
Weist gerne an, bei der Suche nach Vorlagendateien dieses Verzeichnis zu verwenden: diese Dateien
enthalten den statischen Code, den Happy in jeden generierten Parser einfügt. Du
Sie sollten diese Option nicht verwenden müssen, wenn Happy für Sie richtig konfiguriert ist
Computer.

-l, --glr
Weist Happy an, einen GLR-Parser anstelle eines auszugeben Lalr(1) Parser.

-k, --dekodieren
Veranlasst den GLR-Parser, Code zum Dekodieren der Parse-Gesamtstruktur in eine Liste von zu generieren
semantische Ergebnisse (erfordert --ghc).

-f, --Filter
Bewirkt, dass der GLR-Parser Knoten herausfiltert, die für die Semantik nicht erforderlich sind
Ergebnisse (eine experimentelle Optimierung, erfordert --ghc).

Nutzen Sie die Online-Dienste von onworks.net gerne online