mpath

package
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 13, 2025 License: MIT Imports: 2 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Abs

func Abs(p string) (string, error)

Abs 返回给定路径的绝对路径 Abs("./a") -> ("/full/path/to/a", nil)

func Clean

func Clean(p string) string

Clean 规范化路径,移除多余的分隔符和相对段(wrapper for filepath.Clean) Clean("/a//b/./c") -> "/a/b/c"

func EnsureDir

func EnsureDir(dir string, perm os.FileMode) (bool, error)

EnsureDir 确保目录存在,若目录不存在则尝试创建。 参数:

dir  - 目标目录路径;若为空字符串,按仓库约定返回 (false, nil)
perm - 创建目录时使用的权限掩码

返回:

created - 如果本次调用创建了目录返回 true;如果目录已存在返回 false
err     - 发生错误时返回非 nil(例如权限问题或创建失败)

说明:

  • 对于并发创建场景,如果 MkdirAll 失败但随后检测到目录已存在,会视为创建成功并返回 true。

用例:

EnsureDir("/tmp/a/b", 0755) -> (true, nil) // 如果目录之前不存在

func Home

func Home() string

Home 返回用户的主目录。 它会尝试跨平台常用的环境变量。 若均未设置,返回空字符串。

func IsAbs

func IsAbs(p string) bool

IsAbs 判断路径是否为绝对路径(wrapper for filepath.IsAbs) IsAbs("/a/b") -> true

func IsDir

func IsDir(path string) bool

IsDir 判断给定路径是否为目录。 对于不存在的路径或发生错误时返回 false。

func IsExist

func IsExist(path string) bool

判断目录或文件是否存在

func IsFile

func IsFile(path string) bool

IsFile 判断给定路径是否存在且为常规文件。 对于不存在的路径、目录或发生错误时返回 false。

func Join

func Join(elem ...string) string

Join 将路径片段安全拼接为一个路径 Join("a", "b", "c.txt") -> "a/b/c.txt"

func Pwd

func Pwd() (string, error)

Pwd 返回当前工作目录及可能发生的错误。 建议调用方处理返回的 error,而不是吞掉它。

func Rel

func Rel(p, base string) (string, error)

Rel 返回从 base 到 p 的相对路径(filepath.Rel 的包装) 参数:

p    - 目标路径
base - 基准路径

返回: 相对路径字符串,以及可能的错误(若无法计算相对路径) 用例: Rel("/a/b/c", "/a") -> ("b/c", nil)

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL