以下是一个编译指令列表,其中包含每个编译指令意图的简短描述或指向其使用的更多详细信息的链接。(注意:标记为“[NYI]”的编译指令尚未实现,标记为“[TBD]”的编号将在稍后定义。)

该编译指令 声明了将要使用的编译器的版本,如果它们是可选的,则开启它的功能。

  1. use v6; # Load latest supported version (non-PREVIEW).
  2. # executing the program with `perl` instead of `raku`
  3. use v6.c; # Use the "Christmas" version of Raku
  4. use v6.d; # Use the "Diwali" version of Raku
  5. use v6.d.PREVIEW; # On 6.d-capable compilers, enables 6.d features,
  6. # otherwise enables the available experimental
  7. # preview features for 6.d language
  8. # This will only work on releases previous to 6.d.

由于这些编译指令是在编译器版本上开启的,所以它们应该是文件中的第一个语句(前面的注释和 Pod 都没问题)。

MONKEY-GUTS

该编译指令目前不是任何 Raku 规范的一部分,但作为 use nqp 的同义词存在于 Rakudo 中(见下文)。

MONKEY-SEE-NO-EVAL

EVAL

MONKEY-TYPING

augment

MONKEY

  1. use MONKEY;

打开所有可用的 MONKEY 编译指令,目前有上面的三个; 因此,它等同于:

  1. use MONKEY-TYPING;
  2. use MONKEY-SEE-NO-EVAL;
  3. use MONKEY-GUTS;

experimental

允许使用

fatal

在第二个块中,use fatal 编译指定开启了,因此 say 永远不会到达该行,因为从前缀 + 返回的 中包含的 Exception 被抛出并且 块被运行,打印出 Caught…​ 行。请注意,这两个块都是相同的程序,use fatal 只会影响它所使用的词法块:Caught…​use fatal

在 块内部,默认开启 fatal 编译指令,您可以使用 no fatal *禁用*它:

  1. try {
  2. my $x = +"a";
  3. say $x.^name;
  4. CATCH { default { say "Caught {.^name}" } }
  5. } # OUTPUT: «Caught X::Str::Numeric»
  6. try {
  7. no fatal;
  8. my $x = +"a";
  9. say $x.^name;
  10. } # OUTPUT: «Failure»

invocant

isms

  1. [2018.09 and later]

允许被认为是正常 Raku 编程中的警告和/或错误的陷阱的一些其他语言结构。目前,Perl5C++ 是被允许的。

  1. sub abs() { say "foo" }
  2. abs;
  3. # Unsupported use of bare "abs"; in Raku please use .abs if you meant
  4. # or use &abs to refer to the function as a noun

在这种情况下,提供一个不带任何参数的 abs sub,并没有使编译错误消失。

有了这个,编译器将允许违规的 Perl 5 构造,允许实际执行代码。

如果未指定任何语言,则允许使用所有已知语言结构。

  1. use isms; # allow for Perl5 and C++ isms

lib

该编译指令将子目录添加到库搜索路径,以便解释器可以找到模块

  1. use lib <lib /opt/lib /usr/local/lib>;

这将搜索列表中传递的目录。有关更多示例,请查看。

newline

nqp

使用风险由您自己承担。

这是一个 Rakudo 特有的编译指令。有了它,Rakudo 可以访问顶级命名空间中的nqp操作码

  1. use nqp;
  2. nqp::say("hello world");

这使用底层的 nqp say 操作码而不是 Raku 例程。这个编译指示可能会使您的代码依赖于特定版本的 nqp,并且由于该代码不是 Raku 规范的一部分,因此不能保证它是稳定的。您可能会在 Rakudo 核心中找到大量用法,这些用法用于尽可能快地实现核心功能。Rakudo 代码生成的未来优化可能会废弃这些用法。

parameters

默认允许预编译源代码,特别是在模块中使用时。如果由于某种原因您不希望预编译(模块的)代码,您可以使用 no precompilation。这将阻止整个编译单元(通常是文件)被预编译。

soft

Re-dispatching,

strict

strict 是默认行为,并要求您在使用变量之前声明变量。你可以用 no 放松这个限制。

trace

use trace 被激活时,执行的代码的任何行将被写入 stderr。您可以使用 no trace 关闭该功能,因此这仅适用于某些代码段。

v6

variables

worries

词法地控制是否显示编译器生成的编译时警告。默认情况下启用。

  1. $ raku -e 'say :foo<>.Pair'
  2. Potential difficulties:
  3. Pair with <> really means an empty list, not null string; use :foo('') to represent the null string,
  4. or :foo() to represent the empty list more accurately
  5. at -e:1
  6. ------> say :foo<>⏏.Pair
  7. foo => Nil
  8. foo => Nil