YStudio Y++

目录操作（基础支持库）

Y++ / YStudio 开发文档 · 一点滴

路径：支持库 → 基础支持库 → 目录操作。

硬约束

  1. 扁平命令；与「文件操作」中的创建/删除/枚举等配合使用。
  2. 失败多为逻辑假或整数 -1 / 空文本；无统一「取错误」时以返回值判断。
  3. 重命名目录 的「新名称」是目录名（不含路径），不是完整目标路径。
  4. 取特定目录 类型非法或失败 → 空文本。

快速开始

如果 (是否为目录("D:\\data") 且 !目录为空("D:\\data")) {
    输出(取目录大小("D:\\data"))
}
文本 桌面 = 取特定目录(1)
如果 (复制目录("D:\\src", "D:\\dst", 真)) {
    输出("ok")
}

目录操作

本分类共 10 条。

是否为目录

  • 签名：逻辑 是否为目录(文本 路径)
  • 说明：判断路径是否存在且为目录（与「目录存在」相同）。
  • 参数一│文本 路径

是否为文件

  • 签名：逻辑 是否为文件(文本 路径)
  • 说明：判断路径是否存在且为普通文件（与「文件存在」相同）。
  • 参数一│文本 路径

路径存在

  • 签名：逻辑 路径存在(文本 路径)
  • 说明：判断路径是否存在（文件或目录均可）。
  • 参数一│文本 路径

目录为空

  • 签名：逻辑 目录为空(文本 路径)
  • 说明：判断目录是否存在且不含任何文件/子目录（忽略. 与..）。
  • 参数一│文本 路径: 目录路径

复制目录

  • 签名：逻辑 复制目录(文本 源目录, 文本 目标目录, [逻辑 覆盖=假])
  • 说明：递归复制整个目录树到目标路径。
  • 参数一│文本 源目录
  • 参数二│文本 目标目录: 不存在则创建
  • 参数三│[逻辑 覆盖=假]: 真=覆盖已存在的同名文件

移动目录

  • 签名：逻辑 移动目录(文本 源目录, 文本 目标目录)
  • 说明：移动（或跨卷复制后删除）整个目录。
  • 参数一│文本 源目录
  • 参数二│文本 目标目录

重命名目录

  • 签名：逻辑 重命名目录(文本 目录路径, 文本 新名称)
  • 说明：在同级父目录下重命名目录；新名称为不含路径的目录名。
  • 参数一│文本 目录路径
  • 参数二│文本 新名称: 新目录名（不含路径）

清空目录

  • 签名：逻辑 清空目录(文本 目录路径)
  • 说明：删除目录内全部文件与子目录，但保留该目录本身。
  • 参数一│文本 目录路径

取目录大小

  • 签名：整数 取目录大小(文本 目录路径)
  • 说明：递归统计目录下全部文件总字节数；失败返回 -1。
  • 参数一│文本 目录路径

取特定目录

  • 签名：文本 取特定目录(整数 类型)
  • 说明：按类型取系统常用目录路径（末尾一般无分隔符）。
  • 参数一│整数 类型: 1桌面 2文档 3下载 4音乐 5图片 6视频 7应用数据 8本地应用数据 9临时 10程序目录

常配合的文件操作

本分类共 10 条。

创建目录

  • 签名：逻辑 创建目录(文本 目录路径)
  • 说明：创建目录，支持递归创建多级目录。
  • 参数一│文本 目录路径: 要创建的目录路径

取当前目录

  • 签名：文本 取当前目录()
  • 说明：获取当前工作目录。

置当前目录

  • 签名：逻辑 置当前目录(文本 目录路径)
  • 说明：设置进程当前工作目录；成功返回真。
  • 参数一│文本 目录路径: 要切换到的目录，须已存在

删除目录

  • 签名：逻辑 删除目录(文本 目录路径, [逻辑 递归删除=假])
  • 说明：删除目录；可选递归删除目录内所有文件和子目录。
  • 参数一│文本 目录路径: 要删除的目录
  • 参数二│[逻辑 递归删除=假]: 为真时删除目录内所有内容

取临时目录

  • 签名：文本 取临时目录()
  • 说明：获取系统临时文件目录。

取程序目录

  • 签名：文本 取程序目录()
  • 说明：获取工程保存目录（IDE 运行时）或 exe 所在目录（独立运行/分发后）。末尾无分隔符。

文件存在

  • 签名：逻辑 文件存在(文本 文件路径)
  • 说明：判断路径是否存在且为文件（非目录）。
  • 参数一│文本 文件路径: 要检测的路径

目录存在

  • 签名：逻辑 目录存在(文本 路径)
  • 说明：判断目录路径是否存在。
  • 参数一│文本 路径: 目录路径

取文件列表

  • 签名：文本数组 取文件列表(文本 目录, [文本 筛选="*.*"], [逻辑 递归=假], [逻辑 完整路径=真])
  • 说明：获取目录下的文件列表（可筛选、递归、返回完整路径）。
  • 参数一│文本 目录: 欲获取目标目录，如 “D:/”
  • 参数二│[文本 筛选=”.”]: 文件名通配符，如 “.txt”、”.cpp”；可用分号分隔多个模式
  • 参数三│[逻辑 递归=假]: 真=包含子目录，假=仅当前目录
  • 参数四│[逻辑 完整路径=真]: 真=返回完整路径，假=仅文件名

取子目录列表

  • 签名：文本数组 取子目录列表(文本 目录, [逻辑 递归=假], [逻辑 完整路径=真])
  • 说明：枚举子目录列表；可递归、完整路径。别名「取目录列表」。
  • 参数一│文本 目录: 父目录
  • 参数二│[逻辑 递归=假]: 为真时包含子目录的子目录
  • 参数三│[逻辑 完整路径=真]: 真=返回完整路径，假=仅目录名

取特定目录 · 类型

值 目录
1 桌面
2 文档
3 下载
4 音乐
5 图片
6 视频
7 应用数据
8 本地应用数据
9 临时
10 程序目录

易错对照

错误 正确
重命名目录第二参写完整路径 只写新目录名
取特定目录传文字 传整数类型码
非空目录删除不递归 清空目录 或 删除目录(路径, 真)

相关

文件操作 · 路径类 · 文件监视