Golang学习 - path/filepath 包
-----------------------
filepath 中的函数会根据不同平台做不同的处理,比如路径分隔符、卷名等。
-----------------------
路径分隔符转换:
const (
Separator = os.PathSeparator // 路径分隔符(分隔路径元素)
ListSeparator = os.PathListSeparator // 路径列表分隔符(分隔多个路径)
)
下面两个函数主要用于将 Windows 路径分隔符转换为 Linux 路径分隔符,处理完后再转换回去,只在 Windows 中有用,在 Linux 中没必要:
// 将 path 中平台相关的路径分隔符转换为 '/'
ToSlash(path string) string
// 将 path 中的 '/' 转换为系统相关的路径分隔符
FromSlash(path string) string
func main() {
s := `http://www.site.com/a/b/c/d`
u, _ := url.Parse(s)
s = u.Path
// 下面这句用于 Windows 系统
s = filepath.FromSlash(s)
fmt.Println(s)
// 结果:/a/b/c/d 或 \a\b\c\d
// 创建目录试试
if err := os.MkdirAll(s[1:], 0777); err != nil {
fmt.Println(err)
}
// 下面这句用于 Windows 系统
s = filepath.ToSlash(s)
fmt.Println(s)
// /a/b/c/d
}
-----------------------
// 获取 path 中最后一个分隔符之前的部分(不包含分隔符)
Dir(path string) string
// 获取 path 中最后一个分隔符之后的部分(不包含分隔符)
Base(path string) string
// 获取 path 中最后一个分隔符前后的两部分
// 之前包含分隔符,之后不包含分隔符
Split(path string) (dir, file string)
// 获取路径字符串中的文件扩展名
Ext(path string) string
func main() {
path := `a///b///c///d`
path = filepath.FromSlash(path) // 平台处理
d1 := filepath.Dir(path)
f1 := filepath.Base(path)
d2, f2 := filepath.Split(path)
fmt.Printf("%q %q\n%q %q\n", d1, f1, d2, f2)
// "a/b/c"
// "d"
// "a///b///c///"
// "d"
ext := filepath.Ext(path)
fmt.Println(ext) // .txt
}
-----------------------
// 获取 targpath 相对于 basepath 的路径。
// 要求 targpath 和 basepath 必须“都是相对路径”或“都是绝对路径”。
Rel(basepath, targpath string) (string, error)
func main() {
// 都是绝对路径
s, err := filepath.Rel(`/a/b/c`, `/a/b/c/d/e`)
fmt.Println(s, err)
// d/e
// 都是相对路径
s, err = filepath.Rel(`a/b/c`, `a/b/c/d/e`)
fmt.Println(s, err)
// d/e
// 一个绝对一个相对
s, err = filepath.Rel(`/a/b/c`, `a/b/c/d/e`)
fmt.Println(s, err)
// Rel: can't make a/b/c/d/e relative to /a/b/c
// 一个相对一个绝对
s, err = filepath.Rel(`a/b/c`, `/a/b/c/d/e`)
fmt.Println(s, err)
// Rel: can't make /a/b/c/d/e relative to a/b/c
// 从 `a/b/c` 进入 `a/b/d/e`,只需要进入 `../d/e` 即可
s, err = filepath.Rel(`a/b/c`, `a/b/d/e`)
fmt.Println(s, err) // ../d/e
}
------------------------------------------------------------
// 将 elem 中的多个元素合并为一个路径,忽略空元素,清理多余字符。
Join(elem ...string) string
func main() {
// Linux 示例
s := filepath.Join("a", "b", "", ":::", " ", `//c////d///`)
fmt.Println(s)
// a/b/:::/ /c/d
}
------------------------------------------------------------
// 清理路径中的多余字符,比如 /// 或 ../ 或 ./
Clean(path string) string
func main() {
// Linux 示例
s := filepath.Clean("a/./b/:::/..// /c/..///d///")
fmt.Println(s)
// a/b/ /d
}
------------------------------------------------------------
// 获取 path 的绝对路径
Abs(path string) (string, error)
// 判断路径是否为绝对路径
IsAbs(path string) bool
func main() {
s1 := `a/b/c/d`
fmt.Println(filepath.Abs(s1)) // 不同系统显示不一样
s2 := `/a/b/c/d`
fmt.Println(filepath.IsAbs(s1)) // false
fmt.Println(filepath.IsAbs(s2)) // true
}
------------------------------------------------------------
// 将路径序列 path 分割为多条独立的路径
SplitList(path string) []string
func main() {
path := `a/b/c:d/e/f: g/h/i`
s := filepath.SplitList(path)
fmt.Printf("%q", s) // ["a/b/c" "d/e/f" " g/h/i"]
}
------------------------------------------------------------
// 返回路径字符串中的卷名
// Windows 中的 `C:\Windows` 会返回 "C:"
// Linux 中的 `//host/share/name` 会返回 `//host/share`
VolumeName(path string) string
// 返回链接(快捷方式)所指向的实际文件
EvalSymlinks(path string) (string, error)
// 判断 name 是否和指定的模式 pattern 完全匹配
Match(pattern, name string) (matched bool, err error)
// pattern 规则如下:
// 可以使用 ? 匹配单个任意字符(不匹配路径分隔符)。
// 可以使用 * 匹配 0 个或多个任意字符(不匹配路径分隔符)。
// 可以使用 [] 匹配范围内的任意一个字符(可以包含路径分隔符)。
// 可以使用 [^] 匹配范围外的任意一个字符(无需包含路径分隔符)。
// [] 之内可以使用 - 表示一个区间,比如 [a-z] 表示 a-z 之间的任意一个字符。
// 反斜线用来匹配实际的字符,比如 \* 匹配 *,\[ 匹配 [,\a 匹配 a 等等。
// [] 之内可以直接使用 [ * ?,但不能直接使用 ] -,需要用 \]、\- 进行转义。
func main() {
fmt.Println(filepath.Match(`???`, `abc`)) // true
fmt.Println(filepath.Match(`???`, `abcd`)) // false
fmt.Println(filepath.Match(`*`, `abc`)) // true
fmt.Println(filepath.Match(`*`, ``)) // true
fmt.Println(filepath.Match(`a*`, `abc`)) // true
fmt.Println(filepath.Match(`???\\???`, `abc\def`)) // true
fmt.Println(filepath.Match(`???/???`, `abc/def`)) // true
fmt.Println(filepath.Match(`/*/*/*/`, `/a/b/c/`)) // true
fmt.Println(filepath.Match(`[aA][bB][cC]`, `aBc`)) // true
fmt.Println(filepath.Match(`[^aA]*`, `abc`)) // false
fmt.Println(filepath.Match(`[a-z]*`, `a+b`)) // true
fmt.Println(filepath.Match(`\[*\]`, `[a+b]`)) // true
fmt.Println(filepath.Match(`[[\]]*[[\]]`, `[]`)) // true
}
---------------------------
// 列出与指定的模式 pattern 完全匹配的文件或目录(匹配原则同上)
Glob(pattern string) (matches []string, err error)
func main() {
// 列出 usr 的子目录中所包含的以 ba(忽略大小写)开头的项目
list, err := filepath.Glob("/usr/*/[Bb][Aa]*")
if err != nil {
fmt.Println(err)
}
for _, v := range list {
fmt.Println(v)
}
}
---------------------------
// 遍历指定目录(包括子目录),对遍历到的项目用 walkFn 函数进行处理。
Walk(root string, walkFn WalkFunc) error
// 文件处理函数定义如下,如果 WalkFunc 返回 nil,则 Walk 函数继续
// 遍历,如果返回 SkipDir,则 Walk 函数会跳过当前目录(如果当前遍
// 历到的是文件,则同时跳过后续文件及子目录),继续遍历下一个目录。
// 如果返回其它错误,则 Walk 函数会中止遍历过程。
// 在 Walk 遍历过程中,如果遇到错误,则会将错误通过 err 传递给
// WalkFunc 函数,同时 Walk 会跳过出错的项目,继续处理后续项目。
type WalkFunc func(path string, info os.FileInfo, err error) error
// WalkFunc 函数:
// 列出含有 *.txt 文件的目录(不是全部,因为会跳过一些子目录)
func findTxtDir(path string, info os.FileInfo, err error) error {
ok, err := filepath.Match(`*.txt`, info.Name())
if ok {
fmt.Println(filepath.Dir(path), info.Name())
// 遇到 txt 文件则继续处理所在目录的下一个目录
// 注意会跳过子目录
return filepath.SkipDir
}
return err
}
// WalkFunc 函数:
// 列出所有以 ab 开头的目录(全部,因为没有跳过任何项目)
func findabDir(path string, info os.FileInfo, err error) error {
if info.IsDir() {
ok, err := filepath.Match(`[aA][bB]*`, info.Name())
if err != nil {
return err
}
if ok {
fmt.Println(path)
}
}
return nil
}
func main() {
// 列出含有 *.txt 文件的目录(不是全部,因为会跳过一些子目录)
err := filepath.Walk(`/usr`, findTxtDir)
fmt.Println(err)
fmt.Println("==============================")
// 列出所有以 ab 开头的目录(全部,因为没有跳过任何项目)
err = filepath.Walk(`/usr`, findabDir)
fmt.Println(err)
}
在 path 包中有一些同名的函数,但它们只处理 Linux 路径分隔符 '/'。