gperl – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gperl – Groff-Präprozessor für Perl-Teile in Roff-Dateien

ZUSAMMENFASSUNG

gperl [-] [--] [ Dateispezifikation ....]
gperl -h|--help
gperl -v|--Version

BESCHREIBUNG

Dies ist ein Präprozessor für groff(1). Es ermöglicht das Hinzufügen perl(7) Code in groff(7) Dateien.
Das Ergebnis von a Perl Teil kann in groff gespeichert werden Streicher or numerisch registriert basiert auf
die Argumente in einer letzten Zeile von a Perl Teil.

OPTIONAL

Bisher gibt es nur Dateispezifikation or Bruch Optionen.

Dateispezifikation sind Dateinamen oder das Minuszeichen - Zeichen für die Standardeingabe. Wie gewöhnlich,
das Argument -- kann verwendet werden, um alle folgenden Argumente auch Dateinamen bedeuten zu lassen
wenn die Namen mit einem Minuszeichen beginnen -.

Eine Option ist Bruch, wenn das Programm nur die angeforderten Informationen schreibt und
dann hört es auf. Alle anderen Argumente werden dabei ignoriert. Diese Bruch Optionen sind
Hier

-h | --help
Drucken Sie Hilfeinformationen mit einer kurzen Erläuterung der Optionen zur Standardausgabe.

-v | --Version
Versionsinformationen in die Standardausgabe drucken.

PERL TEILE

Perl Teile in groff Dateien werden von zwei umschlossen .Perl Anfragen mit unterschiedlichen Argumenten, a
beginnend und ein Ende Befehl.

Beginnen Sie Perl Model
Der Start Perl Anforderung kann entweder ohne Argumente sein oder durch eine Anfrage, die das hat
Begriff Anfang als einziges Argument.

* .Perl

* .Perl Anfang

Ende Perl Model ohne Lagerung
A .Perl Befehlszeile mit einem anderen Argument als Anfang beendet einen Lauf Perl Teil.
Natürlich wäre es sinnvoll, das Argument hinzuzufügen halt; das ist möglich, aber nicht
notwendig.

* .Perl halt

* .Perl other_than_start
Das Argument other_than_start kann zusätzlich als verwendet werden groff String-Variablenname für
Lagerung – siehe nächster Abschnitt.

Ende Perl Model mit Lagerung
Eine nützliche Funktion von gperl besteht darin, ein oder mehrere Ergebnisse aus dem zu speichern Perl Modus.

Die Ausgabe von a Perl Teil kann mit Backticks erreicht werden „…“..

Dieses Programm sammelt alle Druckvorgänge von Perl auf STDOUT (normale Standardausgabe). drucken
Programm. Diese Pseudodruckausgabe kann aufgrund gedruckter Zeilenumbrüche mehrere Zeilen umfassen
mit \n. Dadurch sollte die Ausgabe eines Perl-Laufs in einem Perl-Array gespeichert werden, mit a
einzelne Zeile für jedes Array-Mitglied.

Diese Perl-Array-Ausgabe kann von gespeichert werden gperl In entweder

groff Streicher
durch Erstellen eines Groff-Befehls .ds

groff Anzahl Registrieren
durch Erstellen eines Groff-Befehls .rn

Die Speichermodi können durch Argumente eines Endstopps bestimmt werden .Perl Befehl. Jede
Argument .ds wechselt den Modus in groff Schnur und .nr wechselt den Modus in groff Anzahl
Registrieren für alle folgenden Ausgabeteile.

Standardmäßig werden alle Ausgaben als Zeichenfolgen gespeichert .ds ist vor dem ersten nicht wirklich nötig
.nr Befehl. Das passt groff(7), da jede Ausgabe als gespeichert werden kann groff Schnur
aber die Nummernregister können sehr restriktiv sein.

In Schnur Modus, gperl erzeugt a groff Schnur Lagerlinie
.ds var_name Inhalt
In Anzahl Registrieren Modus Der folgende Groff-Befehl wird generiert
.nr var_name Inhalt

Im Folgenden stellen wir Argumentsammlungen vor. Sie können als erstes Argument für alle hinzufügen
halt. Wir lassen dieses zusätzliche Element weg.

.Perl .ds var_name
Dadurch wird eine Ausgabezeile in der Groff-Zeichenfolge mit dem Namen gespeichert var_name von dem
automatisch erstellter Befehl
.ds var_name Ausgabe

.Perl var_name
If var_name unterscheidet sich von Anfang Dies entspricht dem vorherigen Befehl,
weil der String-Modus String mit ist .ds Befehl. Standard.

.Perl var_name1 var_name2
Dadurch werden zwei Ausgabezeilen in Groff-String-Namen gespeichert var_name1 und var_name2,
weil der Standardmodus .ds ist aktiv, so dass nein .ds Argumentation ist nötig. Von
Das ist natürlich gleichbedeutend mit
.Perl .ds var_name1 var_name2
und
.Perl .ds var_name1 .ds var_name2

.Perl .nr var_name1 Varname2
speichert beide Variablen als Zahlenregistervariablen. gperl erzeugt
.nr var_name1 Ausgabezeile1
.nr var_name2 Ausgabezeile2

.Perl .nr var_name1 .ds var_name2
speichert das 1. Argument als Anzahl Registrieren und der zweite als Schnur by
.nr var_name1 Ausgabezeile1
.ds var_name2 Ausgabezeile2

Druck gegenüber STDERR is ohne Lagerung
Der Druck hin STDERR, (Standardfehler) funktioniert wie gewohnt. Alle Fehlerinformationen gehen
zur echten Normalität Standard Fehler, ohne sonstige automatische Speicherung.

Beispiele:

Ein möglicher Perl Teil in einem ab Datei könnte so aussehen:
Bevor
.Perl-Start
mein $result = 'einige Daten';
drucke $ergebnis;
.Perl stoppt .ds string_var
nachdem

Dadurch wird das Ergebnis gespeichert "manche Daten" in die ab Schnur namens string_var, so dass die
Folgende Zeile wird gedruckt:
.ds string_var einige Daten
by gperl als Nahrung für das Kommende groff laufen.

A Perl Teil mit mehreren Ausgängen ist:
.Perl-Start
print „first\n“;
print „zweite Zeile\n“;
print „3\n“;
.Perl var1 var2 .nr var3
Dadurch werden 3 gedruckte Zeilen in 3 gespeichert groff Saiten. var1,var2,var3. Also folgendes groff
Befehlszeilen werden erstellt:
.ds var1 zuerst
.ds var2 zweite Zeile
.nr var3 3

Verwenden Sie Gperl online über die Dienste von onworks.net