gperl - 云端在线

程序：

您的姓名

gperl - roff 文件中 Perl 部分的 groff 预处理器

概要

金珀 [-[--[ 文件规格 ....]
金珀 -h| - 帮帮我
金珀 -v|- 版

商品描述

这是一个预处理器 groff的(1). 它允许添加 perl的(7) 码入 groff的(7) 档案。
一个的结果 Perl的 部分 可以存储在 groff 字符串 or 数字的 寄存器 4.9分
a 最后一行的参数 Perl的 部分.

配置

到目前为止，只有 文件规格 or 破坏 选项​​。

文件规格 是文件名或减号 - 标准输入的字符。 照常，
争论 -- 可用于让所有以下参数表示文件名，甚至
如果名称以减号开头 -.

一个选项是 破坏, 当程序只写入要求的信息时
然后停止。 所有其他参数都将被忽略。 这些 破坏 选项是
在这里

-h | - 帮帮我
打印带有标准输出选项的简短说明的帮助信息。

-v | - 版
将版本信息打印到标准输出。

PERL 零件

Perl的 零件在 groff的 档 被两个包围 .Perl 具有不同参数的请求，一个
开始 和 结束 命令。

开始 Perl的 时尚
开始 Perl的 请求 可以不带参数，也可以通过具有
术语 开始 作为它唯一的论据。

* .Perl

* .Perl 开始

结束 Perl的 时尚 也完全不需要 存储
A .Perl 带有不同参数的命令行 开始 跑完 Perl的 部分.
当然，添加论点是合理的 停止; 这是可能的，但不是
必要。

* .Perl 停止

* .Perl 开始以外的时间
论据 开始以外的时间 还可以用作 groff的 字符串变量名
存储——见下一节。

结束 Perl的 时尚 存储
一个有用的功能 金珀 是存储一个或多个结果 Perl的 模式.

一个的输出 Perl的 部分 可以用反引号得到 ``...``.

该程序通过 Perl 收集所有打印到 STDOUT（正常标准输出） 打印
程序。 由于打印的换行符，此伪打印输出可能有几行
\n. 这样，Perl 运行的输出应该存储到 Perl 数组中，并带有
每个数组成员的一行。

这个 Perl 数组输出可以通过 金珀 在任何一个

groff的 字符串
通过创建 groff 命令 .ds

groff的 数 寄存器
通过创建 groff 命令 .rn

存储模式可以由最终停止的参数决定 .Perl 命令。 每个
论点 .ds 将模式更改为 groff的 绳子 和 .nr 将模式更改为 groff的 数
寄存器 对于以下所有输出部件。

默认情况下，所有输出都保存为字符串，因此 .ds 在第一个之前并不是真的需要
.nr 命令。 那适合 groff的(7)，因为每个输出都可以保存为 groff的 细绳，
但是寄存器的数量可能非常有限。

In 绳子 模式, 金珀 产生一个 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 变量名2
将两个变量存储为数字寄存器变量。 金珀 产生
.nr 变量名1 输出行1
.nr 变量名2 输出行2

.Perl .nr 变量名1 .ds 变量名2
将第一个参数存储为 数 寄存器 第二个是 绳子 by
.nr 变量名1 输出行1
.ds 变量名2 输出行2

印刷 向 斯特德 is 也完全不需要 存储
印刷朝向 斯特德,（标准错误）照常工作。 所有错误信息消失
到真正的正常 标准 错误，无需其他自动存储。

示例

一个可能 Perl的 部分 在 罗夫 文件 看起来像这样：
before
.Perl 启动
我的 $result = '一些数据';
打印 $result;
.Perl 停止 .ds string_var
after

这存储结果 “一些 数据” 到 罗夫 绳子 被称为 字符串变量，使得
打印以下行：
.ds string_var 一些数据
by 金珀 作为未来的食物 groff的 运行。

A Perl的 部分 有几个输出是：
.Perl 启动
打印“第一个\n”；
打印“第二行\n”；
打印“3\n”；
.Perl 变量 1 变量 2 .nr 变量 3
这将 3 条打印线存储为 3 groff的 字符串。 无功1,无功2,无功3. 所以以下 groff的
创建命令行：
.ds var1 首先
.ds var2 第二行
.nr var3 3

使用 onworks.net 服务在线使用 gperl