---
layout: doc
title: filesystem / get_dir
---
# get_dir

### 名称

    get_dir() - 返回文件目录的有关信息

### 语法

    mixed *get_dir( string dir, int default: 0 );

### 描述

    如果 `dir` 是一个文件名（支持 `*` 和 `?` 通配符），返回一个包括所有匹配指定名称的文件名字符串数组。如果 `dir` 是一个目录名（以 `/` 结尾，如 "/adm"、"/u/" 等），返回包括目录中所有文件名的字符串数组。

    如果第二个参数为 `-1`，get_dir() 返回一个二维数组，子数组的格式为：

    (\{ 文件名, 文件大小, 最近修改时间 \})

    文件名是字符串，最近修改时间是一个时间戳（和 time() 外部函数返回值的格式相同），文件大小的值和 file_size() 外部函数的返回值相同（单位为字节），如果是目录 值为 -2。

### 参考

    file_size(3), stat(3), time(3)

### 翻译

    雪风(i@mud.ren)
