Files
XCEngine/docs/api/resources/resource-package/exists.md

53 lines
1.2 KiB
Markdown
Raw Normal View History

2026-03-20 02:35:35 +08:00
# Exists
检查指定文件是否存在于资源包中。
## 方法签名
```cpp
bool Exists(const Containers::String& relativePath) const;
```
## 详细描述
检查资源包中是否存在指定相对路径的文件。使用斜杠 `/` 作为路径分隔符,支持带或不带文件扩展名的路径。
## 参数
| 参数名 | 类型 | 描述 |
|--------|------|------|
| `relativePath` | `const Containers::String&` | 文件的相对路径,相对于包内根目录 |
## 返回值
| 类型 | 描述 |
|------|------|
| `bool` | 文件存在返回 `true`,不存在返回 `false` |
## 示例
```cpp
ResourcePackage package;
package.Open("assets/resources.xcp");
// 检查不同类型的文件
if (package.Exists("textures/player.png")) {
printf("Player texture exists\n");
}
if (package.Exists("audio/bgm_main.ogg")) {
printf("Background music exists\n");
}
// 使用通配符检查(当前实现会按字面量匹配)
if (package.Exists("shaders/*")) {
// 注意:当前实现不支持真正的通配符匹配
}
```
## 相关方法
- [Read](read.md) - 读取文件内容
- [GetSize](getsize.md) - 获取文件大小
- [Enumerate](enumerate.md) - 枚举文件