simbot-api/love.forte.simbot.resource/fileResource

fileResource

@JvmName(name = "valueOfPath")
@ExperimentalIOResourceAPI
fun fileResource(filePath: String): Resource(source)

根据完整的文件路径 filePath 得到一个基于对应文件的 Resource。

如果不确定文件系统使用的路径分隔符，或可能在多个使用不同路径分隔符的系统上使用， 则考虑使用 fileResource(base, ...parts)。

Since

4.7.0

Parameters

filePath

文件路径，是使用 路径分隔符 的多个片段。 其中， 路径分隔符 在不同的文件系统中可能是不同的，例如在 Unit 中的 / 和在 Windows 的 \。

Throws

FileNotFoundException

see kotlinx.io.files.FileSystem.source.

IOException

see kotlinx.io.files.FileSystem.source.

@JvmName(name = "valueOfPath")
@ExperimentalIOResourceAPI
fun fileResource(base: String, vararg parts: String): Resource(source)

根据文件路径片段集得到一个基于对应文件的 Resource。

文件会先在初始化时构造 RawSource, 而后在读取 Resource.data 时使用 Source. 因此对文件存在性的校验和错误报告可能不会立即报告， 而是被推迟到真正读取数据时。

文件会在通过 Resource.data 读取数据时才会校验存在性。届时如果文件不存在， 则会得到 IllegalStateException 异常。 此异常的 IllegalStateException.cause 可能是：

  • kotlinx.io.files.FileNotFoundException

  • kotlinx.io.IOException 如果是这两个类型，则成因参考 kotlinx.io.files.FileSystem.source。

Since

4.7.0

Throws

FileNotFoundException

see kotlinx.io.files.FileSystem.source.

IOException

see kotlinx.io.files.FileSystem.source.