1.4 KiB
1.4 KiB
Read
读取资源包中指定文件的内容。
方法签名
Containers::Array<Core::uint8> Read(const Containers::String& relativePath) const;
详细描述
从资源包中读取指定文件的完整内容并返回。如果文件不存在或读取失败，返回空的数组。
文件内容以字节数组形式返回，适用于读取二进制资源如图像、音频、着色器等。
参数
| 参数名 | 类型 | 描述 |
|---|---|---|
relativePath |
const Containers::String& |
文件的相对路径 |
返回值
| 类型 | 描述 |
|---|---|
Containers::Array<Core::uint8> |
文件内容的字节数组，失败时返回空数组 |
示例
ResourcePackage package;
package.Open("assets/resources.xcp");
// 读取图像文件
Array<uint8> imageData = package.Read("textures/player.png");
if (!imageData.Empty()) {
printf("Loaded image: %zu bytes\n", imageData.Size());
}
// 读取文本文件（需要额外处理 UTF-8 编码）
Array<uint8> textData = package.Read("config/settings.txt");
if (!textData.Empty()) {
// 转换为字符串
String text(reinterpret_cast<const char*>(textData.Data()), textData.Size());
}
// 读取着色器
Array<uint8> shaderData = package.Read("shaders/pbr.glsl");