class RakuAST::Doc::Paragraph { }

RakuAST::Doc::Paragraph 类包含有关 RakuDoc 块中逻辑段落的信息。

对 RakuAST 功能的支持在语言版本 6.e+ 中可用，并在 Rakudo 编译器版本 2023.02 中添加。在较早的语言版本中，仅在指定时可用

use experimental :rakuast;

对象内省§

通常在解析包含 RakuDoc 标记的 Raku 编程语言代码时创建 RakuAST::Doc::Paragraph 对象。因此，大多数开发人员只需要知道如何内省创建的对象。

方法 atoms§

.put for $paragraphs.atoms;
# Text before ␤B<and>␤ after markup␤ 

返回段落的原子。这些通常是字符串和 RakuAST::Doc::Markup 对象的混合。

方法 Str§

put $paragraph;  # Text before B<and> after markup␤␤ 

返回段落的字符串，其中任何标记都已字符串化。

方法 raku§

# method .gist falls back to .raku 
say $block;  # RakuAST::Doc::Paragraph.new(... 

返回使用 RakuAST 调用创建段落所需字符串。

对象创建§

人们很少直接创建 RakuAST::Doc::Paragraph 对象。本说明文档适用于希望设计自己的方式以编程方式构建 RakuAST::Doc::Paragraph 对象的少数人。

方法 new§

method new(*@atoms)

必须调用 new 方法才能创建新的 RakuAST::Doc::Paragraph 对象。它将任意数量的位置参数作为逻辑段落的原子，其中原子是字符串或 RakuAST::Doc::Markup 对象。

通常，仅当逻辑段落至少有一个标记对象时才创建 RakuAST::Doc::Paragraph 对象。

my $paragraph = RakuAST::Doc::Paragraph.new(
  "Text before ",
  RakuAST::Doc::Markup.new(:letter<B>, :atoms("and")),
  " after markup\n"
);

对象修改§

方法 add-atom§

$paragraph.add-atom("baz\n");

添加原子：应该是字符串或 RakuAST::Doc::Markup 对象。