在 IO::Handle 中§
请参阅主要文档 在上下文中 了解方法 spurt
multi method spurt(IO::Handle: Blob , : = False)multi method spurt(IO::Handle: Cool , : = False)
将所有 $data
写入文件句柄,如果 $close
为 True
,则在完成时关闭文件句柄。对于 Cool
$data
,将使用句柄设置为使用的编码(IO::Handle.open
或 IO::Handle.encoding
)。
当句柄处于二进制模式或在句柄不在二进制模式时喷射 Blob
时,喷射 Cool
的行为是未定义的。
在 IO::Path 中§
请参阅主要文档 在上下文中 了解方法 spurt
method spurt(IO::Path: , :, :, :)
打开路径以进行写入,并将所有 $data
写入其中。文件将在之后关闭。如果由于任何原因而无法成功,则会 fail
。$data
可以是任何 Cool
类型或任何 Blob
类型。参数如下
:$enc
— 数据的字符编码。采用与IO::Handle.open
中的:$enc
相同的值。默认为utf8
。如果$data
是Blob
,则忽略。:$append
— 以append
模式打开文件,保留现有内容,并将数据追加到文件的末尾。:$createonly
— 如果文件已存在,则fail
。
method spurt(IO::Path:)
从 Rakudo 编译器的 2020.12 版本开始,还可以调用 spurt
方法而没有任何数据。这将创建一个空文件,或截断给定路径处的任何现有文件。
在独立例程中§
请参阅主要文档 在上下文中 了解子例程 spurt
multi spurt(IO() , |c)
$path
可以是具有 IO 方法的对象,该方法返回 IO::Path
对象。在 $path
上调用 IO::Path.spurt
,转发任何剩余参数。