gperl - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

gperl - препроцесор groff для частин Perl у файлах roff

СИНТАКСИС

gperl [-] [--] [ спец. файлу ....]
gperl -h|--допомога
gperl -v|-- версія

ОПИС

Це препроцесор для groff(1). Це дозволяє додати Perl(7) код у groff(7) файли.
Результат а Perl частина можна зберігати в groff струни or числовий регістри на основі
аргументи в кінцевому рядку a Perl частина.

ВАРІАНТИ

Поки що є лише спец. файлу or розрив Варіанти.

спец. файлу є іменами файлів або символом мінус - символ для стандартного введення. Зазвичай,
аргумент -- можна використовувати для того, щоб усі наступні аргументи означали навіть імена файлів
якщо імена починаються з символу мінус -.

Варіант є розрив, коли програма просто записує інформацію, яку запитали і
потім зупиняється. При цьому всі інші аргументи будуть проігноровані. Ці розрив варіанти є
ось

-h | --допомога
Роздрукуйте довідкову інформацію з коротким поясненням параметрів стандартного виводу.

-v | -- версія
Роздрукувати інформацію про версію до стандартного виводу.

PERL ЧАСТИНИ

Perl частини в groff файли охоплені двома .Perl запити з різними аргументами, а
початок і закінчення команда

Починаючи Perl режим
Стартовий Perl запросити може бути або без аргументів, або за запитом, який має
термін старт як його єдиний аргумент.

* .Perl

* .Perl старт

Закінчення Perl режим без зберігання
A .Perl командний рядок з аргументом, відмінним від старт закінчує біг Perl частина.
Звичайно, було б розумно додати аргумент СТОП; це можливо, але ні
необхідно.

* .Perl СТОП

* .Perl крім_початку
Аргумент крім_початку можна додатково використовувати як а groff ім'я рядкової змінної для
зберігання — див. наступний розділ.

Закінчення Perl режим з зберігання
Корисна функція gperl є збереження одного або кількох результатів із Perl режим.

Вихід а Perl частина можна отримати за допомогою галочки `...`.

Ця програма збирає весь друк у STDOUT (звичайний стандартний вихід) Perl друк
програма. Цей псевдодрук може мати кілька рядків через друковані розриви рядків
з \n. Таким чином, результат виконання Perl має зберігатися в масиві Perl з a
один рядок для кожного члена масиву.

Цей висновок масиву Perl може зберігатися за допомогою gperl у будь-якому

groff струни
шляхом створення команди groff .ds

groff номер реєструвати
шляхом створення команди groff .rn

Режими зберігання можуть бути визначені аргументами остаточної зупинки .Perl команда. Кожен
аргумент .ds змінює режим на groff рядок та .nr змінює режим на groff номер
реєструвати для всіх наступних вихідних частин.

За замовчуванням весь вихід зберігається у вигляді рядків .ds насправді не потрібно перед першим
.nr команда. Це підходить groff(7), оскільки кожен вихід можна зберегти як groff струна,
але кількість регістрів може бути дуже обмеженою.

In рядок режим, gperl породжує a groff рядок лінія зберігання
.ds Var_name зміст
In номер реєструвати режим генерується наступна команда groff
.nr Var_name зміст

Нижче ми представляємо колекції аргументів. Ви можете додати як перший аргумент для всіх
СТОП. Ми опускаємо цей додатковий елемент.

.Perl .ds Var_name
Це збереже 1 вихідний рядок у рядку groff з ім’ям Var_name по
автоматично створена команда
.ds Var_name вихід

.Perl Var_name
If Var_name відрізняється від старт це еквівалентно попередній команді,
тому що режим рядка – це рядок з .ds команда. за замовчуванням.

.Perl ім'я_варіанти1 ім'я_варіанти2
Це збереже 2 вихідні рядки в іменах рядків groff ім'я_варіанти1 та ім'я_варіанти2,
оскільки режим за замовчуванням .ds є активним, таким, що ні .ds потрібен аргумент. оф
звичайно, це еквівалентно
.Perl .ds ім'я_варіанти1 ім'я_варіанти2
та
.Perl .ds ім'я_варіанти1 .ds ім'я_варіанти2

.Perl .nr ім'я_варіанти1 Varname2
зберігає обидві змінні як змінні числового регістру. gperl генерує
.nr ім'я_варіанти1 рядок_виведення1
.nr ім'я_варіанти2 рядок_виведення2

.Perl .nr ім'я_варіанти1 .ds ім'я_варіанти2
зберігає 1-й аргумент як номер реєструвати а другий як рядок by
.nr ім'я_варіанти1 рядок_виведення1
.ds ім'я_варіанти2 рядок_виведення2

друк до STDERR is без зберігання
Друк до STDERR, (стандартна помилка) працює як зазвичай. Уся інформація про помилки йде
до справжньої норми standard помилка, без іншого автоматичного зберігання.

ПРИКЛАДИ

Можлива Perl частина В roff файл може виглядати так:
перед тим
Початок .Perl
my $result = 'деякі дані';
надрукувати $результат;
.Perl stop .ds string_var
після

Це зберігає результат "дещо дані» в roff рядок званий змінна_рядка, такий, що
друкується наступний рядок:
.ds string_var деякі дані
by gperl як їжа для майбутнього groff бігти.

A Perl частина з кількома виходами є:
Початок .Perl
надрукувати «перший\n»;
надрукувати ”другий рядок\n”;
надрукувати «3\n»;
.Perl вар1 вар2 .нр вар3
Це зберігає 3 надруковані рядки в 3 groff струни. вар1,вар2,вар3. Отже наступне groff
створюються командні рядки:
.ds вар1 спочатку
.ds var2 другий рядок
.nr var3 3

Використовуйте gperl онлайн за допомогою служб onworks.net