path实现了对斜杠"/"分隔的路径的实用操作函数。
path.Base --获取文件名
func Base(path string) string
Base函数返回路径的最后一个元素。在提取元素前会求掉末尾的斜杠。如果路径是"",会返回".";如果路径是只有一个斜杆构成,会返回"/"。
例:fmt.Println(path.Base("http://www.baidu.com/file/aa.jpg"))
path.Clean–删除多余的路径分隔符
func Clean(path string) string
Clean函数通过单纯的词法操作返回和path代表同一地址的最短路径。
它会不断的依次应用如下的规则,直到不能再进行任何处理:
1. 将连续的多个斜杠替换为单个斜杠
2. 剔除每一个.路径名元素(代表当前目录)
3. 剔除每一个路径内的..路径名元素(代表父目录)和它前面的非..路径名元素
4. 剔除开始一个根路径的..路径名元素,即将路径开始处的"/.."替换为"/"
只有路径代表根地址"/“时才会以斜杠结尾。如果处理的结果是空字符串,Clean会返回”."。
例:fmt.Println(path.Clean("/home/file//abc///aa.jpg"))
fmt.Println(path.Clean("./file//abc///aa.jpg"))
fmt.Println(path.Clean("/../file//abc///aa.jpg"))
path.Dir–获取目录
func Dir(path string) string
Dir返回路径除去最后一个路径元素的部分,即该路径最后一个元素所在的目录。在使用Split去掉最后一个元素后,会简化路径并去掉末尾的斜杠。如果路径是空字符串,会返回".";如果路径由1到多个斜杠后跟0到多个非斜杠字符组成,会返回"/";其他任何情况下都不会返回以斜杠结尾的路径。
例:fmt.Println(path.Dir("./file//abc///aa.jpg"))
path.Ext–获取文件扩展名
func Ext(path string) string
Ext函数返回path文件扩展名。返回值是路径最后一个斜杠分隔出的路径元素的最后一个’.‘起始的后缀(包括’.’)。如果该元素没有’.'会返回空字符串。
例:path.Ext("./file/abc/aa.jpg")
path.IsAbs–判断是否是绝对路径
func IsAbs(path string) bool
IsAbs返回路径是否是一个绝对路径。
例:fmt.Println(path.IsAbs("./file/abc/aa.jpg"))
fmt.Println(path.IsAbs("/home/itcast/text/aa.txt"))
path.Split–将目录与文件名分开
func Split(path string) (dir, file string)
Split函数将路径从最后一个斜杠后面位置分隔为两个部分(dir和file)并返回。如果路径中没有斜杠,函数返回值dir会设为空字符串,file会设为path。两个返回值满足path == dir+file。
例:fmt.Println(path.Split("./file/abc/aaa.jpg"))
path.Join–添加路径分隔符“/”
func Join(elem ...string) string
Join函数可以将任意数量的路径元素放入一个单一路径里,会根据需要添加斜杠。结果是经过简化的,所有的空字符串元素会被忽略。
例:fmt.Println(path.Join("c:", "aa", "bb", "cc.txt"))
path.Match–匹配路径
func Match(pattern, name string) (matched bool, err error)
如果name匹配shell文件名模式匹配字符串,Match函数返回真。该模式匹配字符串语法为:
pattern:
{ term }
term:
'*' 匹配0或多个非/的字符
'?' 匹配1个非/的字符
'[' [ '^' ] { character-range } ']' 字符组(必须非空)
c 匹配字符c(c != '*', '?', '\\', '[')
'\\' c 匹配字符c
character-range:
c 匹配字符c(c != '\\', '-', ']')
'\\' c 匹配字符c
lo '-' hi 匹配区间[lo, hi]内的字符
Match要求匹配整个name字符串,而不是它的一部分。只有pattern语法错误时,会返回ErrBadPattern。
例:isMatch, err := path.Match("c:/windows/*/", "c:/windows/system/")
fmt.Println(isMatch, err)
filepath
filepath包实现了兼容各操作系统的文件路径的实用操作函数。
filepath.Clean–删除多余的路径分隔符并将“/”替换为“\”
func Clean(path string) string
Clean函数通过单纯的词法操作返回和path代表同一地址的最短路径。
它会不断的依次应用如下的规则,直到不能再进行任何处理:
1. 将连续的多个路径分隔符替换为单个路径分隔符
2. 剔除每一个.路径名元素(代表当前目录)
3. 剔除每一个路径内的..路径名元素(代表父目录)和它前面的非..路径名元素
4. 剔除开始一个根路径的..路径名元素,即将路径开始处的"/.."替换为"/"(假设路径分隔符是'/')
C:\
如果处理的结果是空字符串,Clean会返回"."。
例:fmt.Println(filepath.Clean("c:\\\\aa/c\\baa.exe"))
filepath.IsAbs–判断是否为绝对路径
func IsAbs(path string) bool
IsAbs返回路径是否是一个绝对路径。
例:fmt.Println(filepath.IsAbs("c:/wind/aa/bb/b.txt"))
filepath.Abs–强转为绝对路径
func Abs(path string) (string, error)
Abs函数返回path代表的绝对路径,如果path不是绝对路径,会加入当前工作目录以使之成为绝对路径。因为硬链接的存在,不能保证返回的绝对路径是唯一指向该地址的绝对路径。
例:fmt.Println(filepath.Abs("."))
filepath.Rel–获取相对路径
func Rel(basepath, targpath string) (string, error)
Rel函数返回一个相对路径,将basepath和该路径用路径分隔符连起来的新路径在词法上等价于targpath。也就是说,Join(basepath, Rel(basepath, targpath))等价于targpath本身。如果成功执行,返回值总是相对于basepath的,即使basepath和targpath没有共享的路径元素。如果两个参数一个是相对路径而另一个是绝对路径,或者targpath无法表示为相对于basepath的路径,将返回错误。
例:fmt.Println(filepath.Rel("c:/windows", "c:/windows/system/"))
filepath.SplitList–获取多个路径
func SplitList(path string) []string
将PATH或GOPATH等环境变量里的多个路径分割开(这些路径被OS特定的表分隔符连接起来)。与strings.Split函数的不同之处是:对"",SplitList返回[]string{},而strings.Split返回[]string{""}。
例:fmt.Println(filepath.SplitList("c:/windows/system/abc.exe;c:/windows/system/a.txt"))
filepath.Split–将目录与文件名分开
func Split(path string) (dir, file string)
Split函数将路径从最后一个路径分隔符后面位置分隔为两个部分(dir和file)并返回。如果路径中没有路径分隔符,函数返回值dir会设为空字符串,file会设为path。两个返回值满足path == dir+file。
例:fmt.Println(filepath.Split("c:/windows/system/abc.exe"))
filepath.Join–添加路径分隔符
func Join(elem ...string) string
Join函数可以将任意数量的路径元素放入一个单一路径里,会根据需要添加路径分隔符。结果是经过简化的,所有的空字符串元素会被忽略。如果是驱动路径不添加路径分隔符
例:fmt.Println(filepath.Join("c:", "aa", "bb", "cc.txt"))
filepath.FromSlash–将“/”替换为“\”
func FromSlash(path string) string
FromSlash函数将path中的斜杠(’/’)替换为路径分隔符并返回替换结果,多个斜杠会替换为多个路径分隔符。
例:fmt.Println(filepath.FromSlash("c:\\windows\\aa//bb/cc//path.exe"))
filepath.ToSlash–将“\”替换为“/”
func ToSlash(path string) string
ToSlash函数将path中的路径分隔符替换为斜杠(’/’)并返回替换结果,多个路径分隔符会替换为多个斜杠。
例:fmt.Println(filepath.FromSlash("c:\\windows\\aa//bb/cc//path.exe"))
filepath.VolumeName–获取卷名
func VolumeName(path string) (v string)
VolumeName函数返回最前面的卷名。如Windows系统里提供参数"C:\foo\bar"会返回"C:";Unix/linux系统的"\host\share\foo"会返回"\host\share";其他平台会返回""。
例:fmt.Println(filepath.VolumeName("c:\\windows\\"))
filepath.Dir–获取目录
func Dir(path string) string
Dir返回路径除去最后一个路径元素的部分,即该路径最后一个元素所在的目录。在使用Split去掉最后一个元素后,会简化路径并去掉末尾的斜杠。如果路径是空字符串,会返回".";如果路径由1到多个路径分隔符后跟0到多个非路径分隔符字符组成,会返回单个路径分隔符;其他任何情况下都不会返回以路径分隔符结尾的路径。
例:fmt.Println(filepath.Dir("c:/aa/c\\baa.exe"))
filepath.Base–获取文件名
func Base(path string) string
Base函数返回路径的最后一个元素。在提取元素前会求掉末尾的路径分隔符。如果路径是"",会返回".";如果路径是只有一个斜杆构成,会返回单个路径分隔符。
例:fmt.Println(filepath.Base("c:\\aa\\baa.exe"))
filepath.Ext–获取文件扩展名
func Ext(path string) string
Ext函数返回path文件扩展名。返回值是路径最后一个路径元素的最后一个’.‘起始的后缀(包括’.’)。如果该元素没有’.'会返回空字符串。
例:fmt.Println(filepath.Ext("./path.exe"))
filepath.EvalSymlinks–用于判断文件是否存在
func EvalSymlinks(path string) (string, error)
EvalSymlinks函数返回path指向的符号链接(软链接)所包含的路径。如果path和返回值都是相对路径,会相对于当前目录;除非两个路径其中一个是绝对路径。
例:fmt.Println(filepath.EvalSymlinks("./path.exe"))
filepath.Match–匹配路径
func Match(pattern, name string) (matched bool, err error)
Match returns true if name matches the shell file name pattern. The pattern syntax is:
pattern:
{ term }
term:
'*' 匹配0或多个非路径分隔符的字符
'?' 匹配1个非路径分隔符的字符
'[' [ '^' ] { character-range } ']' 字符组(必须非空)
c 匹配字符c(c != '*', '?', '\\', '[')
'\\' c 匹配字符c
character-range:
c 匹配字符c(c != '\\', '-', ']')
'\\' c 匹配字符c
lo '-' hi 匹配区间[lo, hi]内的字符
Match要求匹配整个name字符串,而不是它的一部分。只有pattern语法错误时,会返回ErrBadPattern。
Windows系统中,不能进行转义:’\'被视为路径分隔符。
例:fmt.Println(filepath.Match("c:/windows/*/", "c:/windows/system/"))
filepath.Glob–查找文件
func Glob(pattern string) (matches []string, err error)
Glob函数返回所有匹配模式匹配字符串pattern的文件或者nil(如果没有匹配的文件)。pattern的语法和Match函数相同。pattern可以描述多层的名字,如/usr/*/bin/ed(假设路径分隔符是’/’)。
例:fmt.Println(filepath.Glob("D:\\Program Files\\Tencent\\*\\*.exe"))
filepath.Walk–利用回调函数对目录下的目录和文件进行操作
func Walk(root string, walkFn WalkFunc) error
Walk函数会遍历root指定的目录下的文件树,对每一个该文件树中的目录和文件都会调用walkFn,包括root自身。所有访问文件/目录时遇到的错误都会传递给walkFn过滤。文件是按词法顺序遍历的,这让输出更漂亮,但也导致处理非常大的目录时效率会降低。Walk函数不会遍历文件树中的符号链接(快捷方式)文件包含的路径。
type WalkFunc func(path string, info os.FileInfo, err error) error
Walk函数对每一个文件/目录都会调用WalkFunc函数类型值。调用时path参数会包含Walk的root参数作为前缀;就是说,如果Walk函数的root为"dir",该目录下有文件"a",将会使用"dir/a"调用walkFn参数。walkFn参数被调用时的info参数是path指定的地址(文件/目录)的文件信息,类型为os.FileInfo。
如果遍历path指定的文件或目录时出现了问题,传入的参数err会描述该问题,WalkFunc类型函数可以决定如何去处理该错误(Walk函数将不会深入该目录);如果该函数返回一个错误,Walk函数的执行会中止;只有一个例外,如果Walk的walkFn返回值是SkipDir,将会跳过该目录的内容而Walk函数照常执行处理下一个文件。
例:
func main() {
filepath.Walk("D:\\Program Files", WalkFunc)
}
func WalkFunc(path string, info os.FileInfo, err error) error {
fmt.Println("File:", path, "IsDir:", info.IsDir(), "size:", info.Size())
return nil
}
filepath.HasPrefix
func HasPrefix(p, prefix string) bool
HasPrefix函数出于历史兼容问题保留,不应被使用。