以下是一个编译指令列表,其中包含每个编译指令意图的简短描述或指向其使用的更多详细信息的链接。(注意:标记为“[NYI]”的编译指令尚未实现,标记为“[TBD]”的编号将在稍后定义。)
该编译指令 声明了将要使用的编译器的版本,如果它们是可选的,则开启它的功能。
use v6; # Load latest supported version (non-PREVIEW).
# executing the program with `perl` instead of `raku`
use v6.c; # Use the "Christmas" version of Raku
use v6.d; # Use the "Diwali" version of Raku
use v6.d.PREVIEW; # On 6.d-capable compilers, enables 6.d features,
# otherwise enables the available experimental
# preview features for 6.d language
# This will only work on releases previous to 6.d.
由于这些编译指令是在编译器版本上开启的,所以它们应该是文件中的第一个语句(前面的注释和 Pod 都没问题)。
MONKEY-GUTS
该编译指令目前不是任何 Raku 规范的一部分,但作为 use nqp
的同义词存在于 Rakudo 中(见下文)。
MONKEY-SEE-NO-EVAL
MONKEY-TYPING
MONKEY
use MONKEY;
打开所有可用的 MONKEY
编译指令,目前有上面的三个; 因此,它等同于:
use MONKEY-TYPING;
use MONKEY-SEE-NO-EVAL;
use MONKEY-GUTS;
experimental
允许使用
fatal
在第二个块中,use fatal
编译指定开启了,因此 say
永远不会到达该行,因为从前缀 +
返回的 中包含的 Exception 被抛出并且 块被运行,打印出 Caught…
行。请注意,这两个块都是相同的程序,use fatal
只会影响它所使用的词法块:Caught…use fatal
在 块内部,默认开启 fatal
编译指令,您可以使用 no fatal
*禁用*它:
try {
my $x = +"a";
say $x.^name;
CATCH { default { say "Caught {.^name}" } }
} # OUTPUT: «Caught X::Str::Numeric»
try {
no fatal;
my $x = +"a";
say $x.^name;
} # OUTPUT: «Failure»
invocant
isms
[2018.09 and later]
允许被认为是正常 Raku 编程中的警告和/或错误的陷阱的一些其他语言结构。目前,Perl5
和 C++
是被允许的。
sub abs() { say "foo" }
abs;
# Unsupported use of bare "abs"; in Raku please use .abs if you meant
# or use &abs to refer to the function as a noun
在这种情况下,提供一个不带任何参数的 abs
sub,并没有使编译错误消失。
有了这个,编译器将允许违规的 Perl 5 构造,允许实际执行代码。
如果未指定任何语言,则允许使用所有已知语言结构。
use isms; # allow for Perl5 and C++ isms
lib
该编译指令将子目录添加到库搜索路径,以便解释器可以找到模块。
use lib <lib /opt/lib /usr/local/lib>;
这将搜索列表中传递的目录。有关更多示例,请查看。
newline
nqp
使用风险由您自己承担。
这是一个 Rakudo 特有的编译指令。有了它,Rakudo 可以访问顶级命名空间中的nqp操作码:
use nqp;
nqp::say("hello world");
这使用底层的 nqp say
操作码而不是 Raku 例程。这个编译指示可能会使您的代码依赖于特定版本的 nqp,并且由于该代码不是 Raku 规范的一部分,因此不能保证它是稳定的。您可能会在 Rakudo 核心中找到大量用法,这些用法用于尽可能快地实现核心功能。Rakudo 代码生成的未来优化可能会废弃这些用法。
parameters
默认允许预编译源代码,特别是在模块中使用时。如果由于某种原因您不希望预编译(模块的)代码,您可以使用 no precompilation
。这将阻止整个编译单元(通常是文件)被预编译。
soft
strict
strict
是默认行为,并要求您在使用变量之前声明变量。你可以用 no
放松这个限制。
trace
当 use trace
被激活时,执行的代码的任何行将被写入 stderr。您可以使用 no trace
关闭该功能,因此这仅适用于某些代码段。
v6
variables
worries
词法地控制是否显示编译器生成的编译时警告。默认情况下启用。
$ raku -e 'say :foo<>.Pair'
Potential difficulties:
Pair with <> really means an empty list, not null string; use :foo('') to represent the null string,
or :foo() to represent the empty list more accurately
at -e:1
------> say :foo<>⏏.Pair
foo => Nil
foo => Nil