基本介绍

gfile模块是对文件操作的进一步封装，提供了常用的，简易的API来操作底层文件，隐藏了复杂的底层实现细节。文件管理组件提供了更加丰富的文件/目录操作能力。

使用方式：

Code Block

language	go

import "github.com/gogf/gf/v2/os/gfile"

接口文档：

https://pkg.go.dev/github.com/gogf/gf/v2/os/gfile

Tip
以下常用方法列表，文档更新可能滞后于代码新特性，更多的方法及示例请参考代码文档：https://pkg.go.dev/github.com/gogf/gf/v2/os/gfile

内容管理

`GetContents`

说明：读取指定路径文件内容，以字符串形式返回。
格式:
Code Block
language go
func GetContents(path string) string

示例：

Code Block

language	go

func ExampleGetContents() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// It reads and returns the file content as string.
	// It returns empty string if it fails reading, for example, with permission or IO error.
	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example content
}

`GetContentsWithCache`

说明：带缓存获取文件内容，可设置缓存超时，文件发生变化自动清除缓存。

格式:

Code Block

language	go

func GetContentsWithCache(path string, duration ...time.Duration) string

示例：

Code Block

language	go

func ExampleGetContentsWithCache() {
	// init
	var (
		fileName = "

gflie

gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_cache")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// It reads the file content with cache duration of one minute,
	// which means it reads from cache after then without any IO operations within on minute.
	fmt.Println(gfile.GetContentsWithCache(tempFile, time.Minute))

	// write new contents will clear its cache
	gfile.PutContents(tempFile, "new goframe example content")

	// There's some delay for cache clearing after file content change.
	time.Sleep(time.Second * 1)

	// read contents
	fmt.Println(gfile.GetContentsWithCache(tempFile))

	// May Output:
	// goframe example content
	// new goframe example content
}

`GetBytes`

`GetBytesWithCache`

说明：带缓存获取文件内容，可设置缓存超时，文件发生变化自动清除缓存，返回[]byte。
格式:
说明：读取指定路径文件内容，以字节形式返回。

示例：

Code Block

language	go

func GetBytesWithCache(path string, duration ...time.Duration) []byte

示例：

Code Block

language	go

func ExampleGetBytesWithCache() {
	// initExampleGetBytes() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_contentcache")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// It reads and returns the file content as []byte. with cache duration of one minute,
	// Itwhich means returnsit nilreads iffrom itcache failsafter reading,then forwithout example,any withIO permissionoperations orwithin IOon errorminute.
	fmt.Println(gfile.GetBytesGetBytesWithCache(tempFile, time.Minute))

	// Output:
	// [103 111 102 114 97 109 write new contents will clear its cache
	gfile.PutContents(tempFile, "new goframe example content")

	// There's some delay for cache clearing after file content change.
	time.Sleep(time.Second * 1)

	// read contents
	fmt.Println(gfile.GetBytesWithCache(tempFile))

	// Output:
	// [103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
}

`PutContents`

	// [110 101 119 32 103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
}

`GetBytes`

说明：读取指定路径文件内容，以字节形式返回。
格式:
Code Block
language go
func GetBytes(path string) []byte
说明：往指定路径文件添加字符串内容。如果文件不存在将会递归的形式自动创建。

示例：

Code Block

language	go

func ExamplePutContentsExampleGetBytes() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// It creates and puts content string into specifies file path.write contents
	gfile.PutContents(tempFile, "goframe example content")

	// It automaticallyreads createsand directoryreturns recursivelythe iffile itcontent does not exist.
	gfile.PutContents(tempFile, "goframe example content")

	// read contentsas []byte.
	// It returns nil if it fails reading, for example, with permission or IO error.
	fmt.Println(gfile.GetContentsGetBytes(tempFile))

	// Output:
	// goframe example content
}

`PutBytes`

 [103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
}

`GetBytesTilChar`

说明：以某个字符定位截取指定长度的文件内容以字节形式返回

格式:

Code Block

language	go

func GetBytesTilChar(reader io.ReaderAt, char byte, start int64) ([]byte, int64)

示例：

Code Block

language	go

func ExampleGetBytesTilChar() {
	// init
	var (
		fileName = "gfile_example.

说明：以字节形式写入指定文件，如果文件不存在将会递归的形式自动创建

示例：

Code Block

language	go

func ExamplePutBytes() {
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutBytesPutContents(tempFile, []byte("goframe example content"))

	// read contents
	fmt.Println(gfile.GetContents(tempFile))f, _ := gfile.OpenWithFlagPerm(tempFile, os.O_RDONLY, gfile.DefaultPermOpen)

	// Output:
	// goframe example content
}

`PutContentsAppend`

说明：追加字符串内容到指定文件，如果文件不存在将会递归的形式自动创建。

示例：

Code Block

language	go

func ExamplePutContentsAppend() { GetBytesTilChar returns the contents of the file as []byte
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile until the next specified byte `char` position.
	char, i := gfile.Join(tempDirGetBytesTilChar(f, 'f', fileName0)
	fmt.Println(char)

	// write contents
	gfile.PutContents(tempFile, "goframe example content"fmt.Println(i)

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

Output:
	// It[103 creates and append content string into specifies file path.111 102]
	// It automatically creates directory recursively if it does not exist.
	gfile.PutContentsAppend(tempFile, " append content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example content
	// goframe example content append content
}

`PutBytesAppend`

2 }

`GetBytesByTwoOffsets`

说明：以指定的区间读取文件内容
格式:
Code Block
language go
func GetBytesByTwoOffsets(reader io.ReaderAt, start int64, end int64) []byte
说明：追加字节内容到指定文件。如果文件不存在将会递归的形式自动创建。

示例：

Code Block

language	go

func ExamplePutBytesAppendExampleGetBytesByTwoOffsets() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))f, _ := gfile.OpenWithFlagPerm(tempFile, os.O_RDONLY, gfile.DefaultPermOpen)

	// write contents
	gfile.PutBytesAppend(tempFile,GetBytesTilChar returns the contents of the file as []byte(" append"))

	// read contents until the next specified byte `char` position.
	char := gfile.GetBytesByTwoOffsets(f, 0, 3)
	fmt.Println(gfile.GetContents(tempFile)char)

	// Output:
	// goframe[103 example111 content
	// goframe example content append
}

`GetNextCharOffsetByPath`

102] }

`PutContents`

说明：往指定路径文件添加字符串内容。如果文件不存在将会递归的形式自动创建。
格式:
说明：从某个偏移量开始，获取文件中指定字符所在下标

示例：

Code Block
language go
func

ExampleGetNextCharOffsetByPath

putContents(path string, data []byte, flag int, perm os.FileMode) error

示例：

Code Block

language	go

func ExamplePutContents() {
	// init
	var (
		) {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents It creates and puts content string into specifies file path.
	// It automatically creates directory recursively if it does not exist.
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	index := fmt.Println(gfile.GetNextCharOffsetByPathGetContents(tempFile, 'f', 0)
	fmt.Println(index)

	// Output:
	// 2goframe example content
}

`GetBytesTilCharByPath`

`PutBytes`

说明：以字节形式写入指定文件，如果文件不存在将会递归的形式自动创建
格式:
Code Block
language go
func PutBytes(path string, content []byte) error
说明：以某个字符定位截取指定长度的文件内容以字节形式返回

示例：

Code Block

language	go

func ExampleGetBytesTilCharByPathExamplePutBytes() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContentsPutBytes(tempFile, []byte("goframe example content"))

	// read contents
	fmt.Println(gfile.GetBytesTilCharByPathGetContents(tempFile, 'f', 0))

	// Output:
	// [103goframe 111 102] 2
}

`GetBytesByTwoOffsetsByPath`

example content }

`PutContentsAppend`

说明：追加字符串内容到指定文件，如果文件不存在将会递归的形式自动创建。
格式:
Code Block
language go
func PutContentsAppend(path string, content string) error
说明：用两个偏移量截取指定文件的内容以字节形式返回

示例：

Code Block

language	go

func ExampleGetBytesByTwoOffsetsByPathExamplePutContentsAppend() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetBytesByTwoOffsetsByPathGetContents(tempFile, 0, 7))

	// Output:
	// [103 111 102 114 97 109 101]
}

`ReadLines`

说明：以字符串形式逐行读取文件内容

示例：

Code Block

language	go

func ExampleReadLines() {
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	It creates and append content string into specifies file path.
	// It automatically creates directory recursively if it does not exist.
	gfile.PutContentsAppend(tempFile, " append content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// write contents
	gfile.PutContents(tempFile, "L1Output:
	// goframe example content\nL2
	// goframe example content")

	// read contents
	gfile.ReadLines(tempFile, func(text string) error {
		// Process each line
		fmt.Println(text)
		return nil
	})

	// Output:
	// L1 goframe example content
	// L2 goframe example content
}

`ReadLinesBytes`

append content }

`PutBytesAppend`

说明：追加字节内容到指定文件。如果文件不存在将会递归的形式自动创建。

格式:

Code Block

language	go

func PutBytesAppend(path string, content []byte) error

示例：

Code Block

language	go

func ExamplePutBytesAppend() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile

说明：以字节形式逐行读取文件内容

示例：

Code Block

language	go

func ExampleReadLinesBytes() {
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "L1 goframe example content\nL2 goframe example content")

	// read contents
	fmt.Println(gfile.ReadLinesBytesGetContents(tempFile, func(bytes []byte) error {))

		// Processwrite each linecontents
		fmtgfile.Println(bytes)
		return nil
	}PutBytesAppend(tempFile, []byte(" append"))

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// [76goframe 49 32 103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
	// [76 50 32 103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
}

内容替换

`ReplaceFile`

example content
	// goframe example content append
}

`GetNextCharOffset`

说明：从某个偏移量开始，获取文件中指定字符所在下标

格式:

Code Block

language	go

func GetNextCharOffset(reader io.ReaderAt, char byte, start int64) int64

示例：

Code Block

language	go

func ExampleGetNextCharOffset() {
	// init
	var (
		fileName = "gfile

说明：替换指定文件的指定内容为新内容

示例：

Code Block

language	go

func ExampleReplaceFile() {
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replacecontent")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")
	
	// read contents
	fmt.Println(gfile.GetContents(tempFile)f, err := gfile.OpenWithFlagPerm(tempFile, os.O_RDONLY, DefaultPermOpen)
	defer f.Close()

	// It replaces content directly by file path.
	gfile.ReplaceFile("content", "replace word", tempFile)

read contents
	index := gfile.GetNextCharOffset(f, 'f', 0)
	fmt.Println(gfile.GetContents(tempFile)index)

	// Output:
	// goframe example content
	// goframe example replace word
}

`ReplaceFileFunc`

2 }

`GetNextCharOffsetByPath`

说明：从某个偏移量开始，获取文件中指定字符所在下标
格式:
说明：使用自定义函数替换指定文件内容

示例：

Code Block
language go
func

ExampleReplaceFileFunc

GetNextCharOffsetByPath(path string, char byte, start int64) int64

示例：

Code Block

language	go

func ExampleGetNextCharOffsetByPath() {
	// init) {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replacecontent")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example 123content")

	// read contents
	fmt.Println(index := gfile.GetContentsGetNextCharOffsetByPath(tempFile, 'f', 0)
	fmt.Println(index)

	// It replaces content directly by file path and callback function.
	gfile.ReplaceFileFunc(func(path, content string) string {
		// Replace with regular match
		reg, _ := regexp.Compile(`\d{3}`)
		return reg.ReplaceAllString(content, "[num]")
	}, tempFile)

	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example 123
	// goframe example [num]
}

`ReplaceDir`

Output: // 2 }

`GetBytesTilCharByPath`

说明：以某个字符定位截取指定长度的文件内容以字节形式返回

格式:

Code Block

language	go

func GetBytesTilCharByPath(path string, char byte, start int64) ([]byte, int64)

示例：

Code Block

language	go

func ExampleGetBytesTilCharByPath() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetBytesTilCharByPath(tempFile, 'f', 0))

	// Output:
	// [103 111 102] 2
}

`GetBytesByTwoOffsetsByPath`

说明：用两个偏移量截取指定文件的内容以字节形式返回
格式:
Code Block
language go
func GetBytesByTwoOffsetsByPath(path string, start int64, end int64) []byte
说明：扫描指定目录，替换符合条件的文件的指定内容为新内容

示例：

Code Block

language	go

func ExampleReplaceDirExampleGetBytesByTwoOffsetsByPath() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replacecontent")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetContentsGetBytesByTwoOffsetsByPath(tempFile, 0, 7))

	// It replaces content of all files under specified directory recursively.
	gfile.ReplaceDir("content", "replace word", tempDir, "gflie_example.txt", true)

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example content
	// goframe example replace word
}

`ReplaceDirFunc`

Output:
	// [103 111 102 114 97 109 101]
}

`ReadLines`

说明：以字符串形式逐行读取文件内容

格式:

Code Block

language	go

func ReadLines(file string, callback func(text string) error) error

说明：扫描指定目录，使用自定义函数替换符合条件的文件的指定内容为新内容

示例：

Code Block

language	go

func ExampleReplaceDirFuncExampleReadLines() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replacecontent")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "L1 goframe example 123"content\nL2 goframe example content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// It replaces content of all files under specified directory with custom callback function recursively.
	gfile.ReplaceDirFunc(func(path, content string) stringReadLines(tempFile, func(text string) error {
		// ReplaceProcess witheach regular matchline
		reg, _ := regexp.Compile(`\d{3}`fmt.Println(text)
		return reg.ReplaceAllString(content, "[num]")
	}, tempDir, "gflie_example.txt", true)

	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	//nil
	})

	// Output:
	// L1 goframe example 123content
	// L2 goframe example [num]content

}

文件时间

`ReadLinesBytes`

MTime

说明：以字节形式逐行读取文件内容说明：获取路径修改时间
格式:

示例：

Code Block
language go
func

ExampleMTime

ReadLinesBytes(

) { t := gfile.MTime(gfile.TempDir()) fmt.Println(t) // May Output: // 2021-11-02 15:18:43.901141 +0800 CST }

`MTimestamp`

file string, callback func(bytes []byte) error) error

示例：

Code Block

language	go

func ExampleReadLinesBytes() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_content")
		tempFile = gfile.Join(tempDir, fileName)

说明：获取路径修改时间戳（秒）

示例：

Code Block

language	go

func ExampleMTimestamp() {
	t := gfile.MTimestamp(gfile.TempDir())
	fmt.Println(t)

	// May Output: write contents
	gfile.PutContents(tempFile, "L1 goframe example content\nL2 goframe example content")

	// read 1635838398
}

`MTimestampMilli`

说明：获取路径修改时间戳（毫秒）

示例：

Code Block

language	go

func ExampleMTimestampMilli()contents
	gfile.ReadLinesBytes(tempFile, func(bytes []byte) error {
	t := gfile.MTimestampMilli(gfile.TempDir())
		// Process each line
		fmt.Println(tbytes)
		return nil
	})

	// May Output:
	// 1635838529330
}

文件大小

`Size`

[76 49 32 103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
	// [76 50 32 103 111 102 114 97 109 101 32 101 120 97 109 112 108 101 32 99 111 110 116 101 110 116]
}

`Truncate`

说明：裁剪文件为指定大小
注意：如果给定文件路径是软链，将会修改源文件

格式:

Code Block

language	go

func Truncate(path string, size int) error

示例：

Code Block

language	go

func ExampleTruncate(){
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	// Check whether the `path` size
	stat, _ := gfile.Stat(path)
	fmt.Println(stat.Size())

	// Truncate file
	gfile.Truncate(path, 0)

	// Check whether the `path` size
	stat, _ = gfile.Stat(path)
	fmt.Println(stat.Size())

	// Output:
	// 13
	// 0
}

内容替换

`ReplaceFile`

说明：替换指定文件的指定内容为新内容

格式:

Code Block

language	go

func ReplaceFile(search, replace, path string) error

示例：

Code Block

language	go

func ExampleReplaceFile() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replace")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// It replaces content directly by file path.
	gfile.ReplaceFile("content", "replace word", tempFile)

	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example content
	// goframe example replace word
}

`ReplaceFileFunc`

说明：使用自定义函数替换指定文件内容

格式:

Code Block

language	go

func ReplaceFileFunc(f func(path, content string) string, path string) error

示例：

Code Block

language	go

func ExampleReplaceFileFunc() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replace")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example 123")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// It replaces content directly by file path and callback function.
	gfile.ReplaceFileFunc(func(path, content string) string {
		// Replace with regular match
		reg, _ := regexp.Compile(`\d{3}`)
		return reg.ReplaceAllString(content, "[num]")
	}, tempFile)

	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example 123
	// goframe example [num]
}

`ReplaceDir`

说明：扫描指定目录，替换符合条件的文件的指定内容为新内容

格式:

Code Block

language	go

func ReplaceDir(search, replace, path, pattern string, recursive ...bool) error

示例：

Code Block

language	go

func ExampleReplaceDir() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replace")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// It replaces content of all files under specified directory recursively.
	gfile.ReplaceDir("content", "replace word", tempDir, "gfile_example.txt", true)

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example content
	// goframe example replace word
}

`ReplaceDirFunc`

说明：扫描指定目录，使用自定义函数替换符合条件的文件的指定内容为新内容

格式:

Code Block

language	go

func ReplaceDirFunc(f func(path, content string) string, path, pattern string, recursive ...bool) error

示例：

Code Block

language	go

func ExampleReplaceDirFunc() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_replace")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example 123")

	// read contents
	fmt.Println(gfile.GetContents(tempFile))

	// It replaces content of all files under specified directory with custom callback function recursively.
	gfile.ReplaceDirFunc(func(path, content string) string {
		// Replace with regular match
		reg, _ := regexp.Compile(`\d{3}`)
		return reg.ReplaceAllString(content, "[num]")
	}, tempDir, "gfile_example.txt", true)

	fmt.Println(gfile.GetContents(tempFile))

	// Output:
	// goframe example 123
	// goframe example [num]

}

文件时间

`MTime`

说明：获取路径修改时间
格式:
Code Block
language go
func MTime(path string) time.Time

示例：

Code Block

language	go

func ExampleMTime() {
	t := gfile.MTime(gfile.TempDir())
	fmt.Println(t)

	// May Output:
	// 2021-11-02 15:18:43.901141 +0800 CST
}

`MTimestamp`

说明：获取路径修改时间戳（秒）
格式:
Code Block
language go
func MTimestamp(path string) int64

示例：

Code Block

language	go

func ExampleMTimestamp() {
	t := gfile.MTimestamp(gfile.TempDir())
	fmt.Println(t)

	// May Output:
	// 1635838398
}

`MTimestampMilli`

说明：获取路径修改时间戳（毫秒）
格式:
Code Block
language go
func MTimestampMilli(path string) int64

示例：

Code Block

language	go

func ExampleMTimestampMilli() {
	t := gfile.MTimestampMilli(gfile.TempDir())
	fmt.Println(t)

	// May Output:
	// 1635838529330
}

文件大小

`Size`

说明：获取路径大小，不进行格式化
格式:
Code Block
language go
func Size(path string) int64

示例：

Code Block

language	go

func ExampleSize() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_size")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "0123456789")
	fmt.Println(gfile.Size(tempFile))

	// Output:
	// 10
}

`SizeFormat`

说明：获取路径大小，并格式化成硬盘容量
格式:
Code Block
language go
func SizeFormat(path string) string

示例：

Code Block

language	go

func ExampleSizeFormat() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_size")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "0123456789")
	fmt.Println(gfile.SizeFormat(tempFile))

	// Output:
	// 10.00B
}

`ReadableSize`

说明：获取给定路径容量大小，并格式化人类易读的硬盘容量格式
格式:
Code Block
language go
func ReadableSize(path string) string

示例：

Code Block

language	go

func ExampleReadableSize() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_size")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "01234567899876543210")
	fmt.Println(gfile.ReadableSize(tempFile))

	// Output:
	// 20.00B
}

`StrToSize`

说明：硬盘容量大小字符串转换为大小整形
格式:
Code Block
language go
func StrToSize(sizeStr string) int64

示例：

Code Block

language	go

func ExampleStrToSize() {
	size := gfile.StrToSize("100MB")
	fmt.Println(size)

	// Output:
	// 104857600
}

`FormatSize`

说明：大小整形转换为硬盘容量大小字符串`K、m、g、t、p、e、b`
格式:
Code Block
language go
func FormatSize(raw int64) string

示例：

Code Block

language	go

func ExampleFormatSize() {
	sizeStr := gfile.FormatSize(104857600)
	fmt.Println(sizeStr)
	sizeStr0 := gfile.FormatSize(1024)
	fmt.Println(sizeStr0)
	sizeStr1 := gfile.FormatSize(999999999999999999)
	fmt.Println(sizeStr1)

	// Output:
	// 100.00M
	// 1.00K
	// 888.18P
}

文件排序

`SortFiles`

说明：排序多个路径，按首字母进行排序，数字优先。
格式:
Code Block
language go
func SortFiles(files []string) []string

示例：

Code Block

language	go

func ExampleSortFiles() {
	files := []string{
		"/aaa/bbb/ccc.txt",
		"/aaa/bbb/",
		"/aaa/",
		"/aaa",
		"/aaa/ccc/ddd.txt",
		"/bbb",
		"/0123",
		"/ddd",
		"/ccc",
	}
	sortOut := gfile.SortFiles(files)
	fmt.Println(sortOut)

	// Output:
	// [/0123 /aaa /aaa/ /aaa/bbb/ /aaa/bbb/ccc.txt /aaa/ccc/ddd.txt /bbb /ccc /ddd]
}

文件检索

`Search`

说明：在指定目录（默认包含当前目录、运行目录、主函数目录；不会递归子目录）中搜索文件并返回真实路径。

格式:

Code Block

language	go

func Search(name string, prioritySearchPaths ...string) (realPath string, err error)

示例：

Code Block

language	go

func ExampleSearch() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_search")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// search file
	realPath, _ := gfile.Search(fileName, tempDir)
	fmt.Println(gfile.Basename(realPath))

	// Output:
	// gfile_example.txt
}

目录扫描

`ScanDir`

说明：扫描指定目录，可扫描文件或目录，支持递归扫描。

格式:

Code Block

language	go

func ScanDir(path string, pattern string, recursive ...bool) ([]string, error)

示例：

Code Block

language	go

func ExampleScanDir() {
	// init
	var (
		fileName = "gfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_scan_dir")
		tempFile = gfile.Join(tempDir, fileName)

		tempSubDir  = gfile.Join(tempDir, "sub_dir")
		tempSubFile = gfile.Join(tempSubDir

说明：获取路径大小，不进行格式化

示例：

Code Block

language	go

func ExampleSize() {
	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_size")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "0123456789goframe example content")
	fmt.Println(gfile.Size(tempFile))

	// Output:
	// 10
}

`SizeFormat`

说明：获取路径大小，并格式化成硬盘容量

示例：

Code Block

language	go

func ExampleSizeFormat() {PutContents(tempSubFile, "goframe example content")

	// init
	var (
		fileName = "gflie_example.txt"
		tempDir  scans directory recursively
	list, _ := gfile.TempDirScanDir("gfile_example_size"tempDir, "*", true)
		tempFile = gfile.Join(tempDir, fileName)
	)for _, v := range list {
		fmt.Println(gfile.Basename(v))
	}

	// write contents
	gfile.PutContents(tempFile, "0123456789")
	fmt.Println(gfile.SizeFormat(tempFile))

	// Output:
	// 10.00B
}

`ReadableSize`

Output:
	// gfile_example.txt
	// sub_dir
	// gfile_example.txt
}

`ScanDirFile`

说明：扫描指定目录的文件，支持递归扫描
格式:
Code Block
language go
func ScanDirFile(path string, pattern string, recursive ...bool) ([]string, error)
说明：获取给定路径容量大小，并格式化人类易读的硬盘容量格式

示例：

Code Block

language	go

func ExampleReadableSizeExampleScanDirFile() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_sizescan_dir_file")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "01234567899876543210")
	fmt.Println(gfile.ReadableSize(tempFile))

	// Output:
	// 20.00B
}

`StrToSize`

说明：硬盘容量大小字符串转换为大小整形

示例：

Code Block

language	go

func ExampleStrToSize() {
	size :(tempDir, fileName)

		tempSubDir  = gfile.StrToSizeJoin("100MBtempDir, "sub_dir")
		fmt.Println(sizetempSubFile = gfile.Join(tempSubDir, fileName)
	)

	// Output:
	// 104857600
}

`FormatSize`

说明：大小整形转换为硬盘容量大小字符串`K、m、g、t、p、e、b`

示例：

Code Block

language	go

func ExampleFormatSize() {
	sizeStr := gfile.FormatSize(104857600)
	fmt.Println(sizeStr)
	sizeStr0write contents
	gfile.PutContents(tempFile, "goframe example content")
	gfile.PutContents(tempSubFile, "goframe example content")

	// scans directory recursively exclusive of directories
	list, _ := gfile.FormatSize(1024)
	fmt.Println(sizeStr0)
	sizeStr1 := gfile.FormatSize(999999999999999999)
ScanDirFile(tempDir, "*.txt", true)
	for _, v := range list {
		fmt.Println(sizeStr1(gfile.Basename(v))
	}

	// Output:
	// 100gfile_example.00Mtxt
	// 1gfile_example.00K
	// 888.18P
}

文件排序

`SortFiles`

txt }

`ScanDirFunc`

说明：扫描指定目录（自定义过滤方法），可扫描文件或目录，支持递归扫描

格式:

Code Block

language	go

func ScanDirFunc(path string, pattern string, recursive bool, handler func(path string) string) ([]string, error)

说明：排序多个路径，按首字母进行排序，数字优先。

示例：

Code Block

language	go

func ExampleSortFilesExampleScanDirFunc() {
	files := []string{
		"/aaa/bbb/ccc.txt",
		"/aaa/bbb/",/ init
	var (
		"/aaa/",
		"/aaa",
		"/aaa/ccc/ddd.txt",
		"/bbb",
		"/0123",
		"/ddd",
		"/ccc",
	}
	sortOut :fileName = "gfile_example.txt"
		tempDir  = gfile.SortFiles(filesTempDir("gfile_example_scan_dir_func")
		fmt.Println(sortOuttempFile = gfile.Join(tempDir, fileName)

	// Output:
	// [/0123 /aaa /aaa/ /aaa/bbb/ /aaa/bbb/ccc.txt /aaa/ccc/ddd.txt /bbb /ccc /ddd]
}

文件检索

`Search`

说明：在指定目录（默认包含当前目录、运行目录、主函数目录；不会递归子目录）中搜索文件并返回真实路径。

示例：

Code Block

language	go

func ExampleSearch() {	tempSubDir  = gfile.Join(tempDir, "sub_dir")
		tempSubFile = gfile.Join(tempSubDir, fileName)
	)

	// initwrite contents
	var (
		fileName = "gflie_example.txt"
		tempDir  = gfile.TempDir("gfile_example_search")
		tempFile = gfile.Join(tempDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")

	// search file
	realPath, _ := gfile.Search(fileName, tempDir)
gfile.PutContents(tempFile, "goframe example content")
	gfile.PutContents(tempSubFile, "goframe example content")

	// scans directory recursively
	list, _ := gfile.ScanDirFunc(tempDir, "*", true, func(path string) string {
		// ignores some files
		if gfile.Basename(path) == "gfile_example.txt" {
			return ""
		}
		return path
	})
	for _, v := range list {
		fmt.Println(gfile.Basename(realPathv))
	}

	// Output:
	// gfliesub_example.txtdir
}

目录扫描

`ScanDir`

`ScanDirFileFunc`

说明：扫描指定目录的文件（自定义过滤方法），支持递归扫描。

格式:

Code Block

language	go

func ScanDirFileFunc(path string, pattern string, recursive bool, handler func(path string) string) ([]string, error)

说明：扫描指定目录，可扫描文件或目录，支持递归扫描。

示例：

Code Block

language	go

func ExampleScanDirExampleScanDirFileFunc() {
	// init
	var (
		fileName = "gfliegfile_example.txt"
		tempDir  = gfile.TempDir("gfile_example_scan_dir_file_func")
		tempFile = gfile.Join(tempDir, fileName)

		fileName1 = "gfile_example_ignores.txt"
		tempFile1 = gfile.Join(tempDir, fileName1)

		tempSubDir  = gfile.Join(tempDir, "sub_dir")
		tempSubFile = gfile.Join(tempSubDir, fileName)
	)

	// write contents
	gfile.PutContents(tempFile, "goframe example content")
	gfile.PutContents(tempFile1, "goframe example content")
	gfile.PutContents(tempSubFile, "goframe example content")

	// scans directory recursively exclusive of directories
	list, _ := gfile.ScanDir(tempDir, "*", true := gfile.ScanDirFileFunc(tempDir, "*.txt", true, func(path string) string {
		// ignores some files
		if gfile.Basename(path) == "gfile_example_ignores.txt" {
			return ""
		}
		return path
	})
	for _, v := range list {
		fmt.Println(gfile.Basename(v))
	}

	// Output:
	// gfliegfile_example.txt
	// sub_dir
	// gfliegfile_example.txt
}

常用目录

ScanDirFile

`Pwd`

说明：扫描指定目录的文件，支持递归扫描说明：获取当前工作路径。

示例：

格式:
Code Block
language go
func

ExampleScanDirFile

Pwd()

{ // init var ( fileName = "gflie_example.txt" tempDir = gfile.TempDir("gfile_example_scan_dir_file") tempFile = gfile.Join(tempDir, fileName) tempSubDir = gfile.Join(tempDir, "sub_dir") tempSubFile = gfile.Join(tempSubDir, fileName)

string

示例：

Code Block

language	go

func ExamplePwd() {
	// Get absolute path of current working directory.
	fmt.Println(gfile.Pwd())

	//

write

May

contents

Output: // xxx/gf/os/gfile }

`Home`

格式:

Code Block

language	go

func Home(names ...string) (string, error)

示例：

Code Block

language	go

func ExampleHome() {
	// user's home directory
	homePathgfile.PutContents(tempFile, "goframe example content")
	gfile.PutContents(tempSubFile, "goframe example content")

	// scans directory recursively exclusive of directories
	list, _ := gfile.ScanDirFile(tempDir, "*.txt", trueHome()
	for _, v := range list {
		fmt.Println(gfile.Basename(v))
	}homePath)

	// May Output:
	// gflie_example.txt
	// gflie_example.txt
}

`ScanDirFunc`

C:\Users\hailaz }

`Temp`

说明：获取拼接系统临时路径后的绝对地址。
格式:
Code Block
language go
func Temp(names ...string) string
说明：扫描指定目录（自定义过滤方法），可扫描文件或目录，支持递归扫描
示例：
Code Block
language go
func

ExampleScanDirFunc

ExampleTempDir() {
	// init
	var (
		fileName = "

gflie

gfile_example

.txt

_basic_dir"

tempDir = gfile.TempDir("

)

	// fetch an absolute representation of path.
	path := gfile.Temp(fileName)

	fmt.Println(path)

	// Output:
	// /tmp/gfile_example_

scan

basic_dir

_func") tempFile = gfile.Join(tempDir, fileName) tempSubDir = gfile.Join(tempDir, "sub_dir") tempSubFile = gfile.Join(tempSubDir, fileName)

}

`SelfPath`

说明：获取当前运行程序的绝对路径。
格式:
Code Block
language go
func SelfPath() string

示例：

Code Block

language	go

func ExampleSelfPath() {

	// Get absolute file path of current running process
	fmt.Println(gfile.SelfPath())

	//

write

May

contents

Output:
	// xxx/___github_com_gogf_gf_v2_os_gfile__ExampleSelfPath
}

类型判断

`IsDir`

说明：检查给定的路径是否是文件夹。
格式:
Code Block
language go
func IsDir(path string) bool

示例：

Code Block

language	go

func ExampleIsDir() {
	// init
	var (
		path     = gfile.TempDir("gfile_example_basic_dir")
		filePath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)
	// Checks whether given `path` a directory.

gfile.PutContents(tempFile, "goframe example content") gfile.PutContents(tempSubFile, "goframe example content") // scans directory recursively list, _ := gfile.ScanDirFunc(tempDir, "*", true, func(path string) string { // ignores some files if gfile.Basename(path) == "gflie_example.txt" { return "" } return path }) for _, v := range list {

fmt.Println(gfile.

Basename

IsDir(

v

path))

}

fmt.Println(gfile.IsDir(filePath))

	// Output:
	// true
	//

sub_dir

false }

ScanDirFileFunc

`IsFile`

说明：扫描指定目录的文件（自定义过滤方法），支持递归扫描。说明：检查给定的路径是否是文件。

示例：

格式:
Code Block
language go
func

ExampleScanDirFileFunc

IsFile(

) { // init var ( fileName = "gflie_example.txt" tempDir = gfile.TempDir("gfile_example_scan_dir_file_func") tempFile = gfile.Join(tempDir, fileName) fileName1 = "gflie_example_ignores.txt" tempFile1 = gfile.Join(tempDir, fileName1) tempSubDir = gfile.Join(tempDir, "sub_dir") tempSubFile

path string) bool

示例：

Code Block

language	go

func ExampleIsFile() {
	// init
	var (
		filePath = gfile.Join(

tempSubDir, fileName) ) // write contents

gfile.

PutContents

TempDir(

tempFile, "goframe example content") gfile.PutContents(tempFile1, "goframe example content

"gfile_example_basic_dir"), "file1")
		dirPath  = gfile.

PutContents

TempDir(

tempSubFile, "goframe example content

"gfile_example_basic_dir") ) //

scans

Checks

权限操作

`IsReadable`

说明：检查给定的路径是否可读。
格式:
Code Block
language go
func IsReadable(path string) bool

示例：

Code Block

language	go

func ExampleIsReadable() {
	// init
	var (
		path = gfile.Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

	// Checks whether given `path` is readable.
	fmt.Println(gfile.

Basename

IsReadable(

v

path))

}

// Output:

//

gflie_example.txt

Output: //

gflie_example.txt

true }

文件/目录操作

`Copy`

`IsWritable`

说明：检查指定路径是否可写，如果路径是目录，则会创建临时文件检查是否可写，如果是文件则判断是否可以打开
格式:
Code Block
language go
func IsWritable(path string) bool
说明：支持复制文件或目录
示例：
Code Block
language go
func

ExampleCopy

ExampleIsWritable() { // init var (

srcFileName = "gflie_example.txt" srcTempDir = gfile.TempDir("gfile_example_copy_src") srcTempFile = gfile.Join(srcTempDir, srcFileName) // copy file dstFileName = "gflie_example_copy.txt"

dstTempFile

path = gfile.

Join(srcTempDir, dstFileName

Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

//

copy dir dstTempDir = gfile.TempDir("gfile_example_copy_dst")

 Checks whether given `path` is writable.
	fmt.Println(gfile.IsWritable(path))

	// Output:
	// true
}

`Chmod`

说明：使用指定的权限，更改指定路径的文件权限。

格式:

Code Block

language	go

func Chmod(path string, mode os.FileMode) error

示例：
Code Block
language go
func ExampleChmod() {

write contents gfile.PutContents(srcTempFile, "goframe example copy")

//

copy file

init

gfile.Copy(srcTempFile, dstTempFile) // read contents after copy file fmt.Println(gfile.GetContents(dstTempFile)

var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	//

copy dir gfile.Copy(srcTempDir, dstTempDir) // list copy dir file fList, _

Get a FileInfo describing the named file.
	stat, err := gfile.

ScanDir(dstTempDir, "*", false

Stat(path)

for

if

_, v := range fList

err != nil { fmt.Println(

gfile

err.

Basename

Error(

v

)) }

//

Output:

Show original mode
	fmt.Println(stat.Mode())

	//

goframe

Change

example

file

copy

model

// gflie_example.txt

gfile.Chmod(path, gfile.DefaultPermCopy)

	//

gflie_example_copy.txt }

`Home`

示例：

Code Block

language	go

func ExampleHome() { // user's home directory homePath

 Get a FileInfo describing the named file.
	stat, _

:

= gfile.

Home

Stat(path)
	// Show the modified mode
	fmt.Println(

homePath

stat.Mode()) //

May

Output: // -rw-r--r-- //

C:\Users\hailaz

-rwxrwxrwx }

文件/目录操作

`Mkdir`

说明：创建文件夹，支持递归创建（建议采用绝对路径）,创建后的文件夹权限为：`drwxr创建后的文件夹权限为：drwxr-xr-x`。x。
格式:
Code Block
language go
func Mkdir(path string) error

示例：

Code Block

language	go

func ExampleMkdir() {
	// init
	var (
		path = gfile.TempDir("gfile_example_basic_dir")
	)

	// Creates directory
	gfile.Mkdir(path)

	// Check if directory exists
	fmt.Println(gfile.IsDir(path))

	// Output:
	// true
}

`Create`

说明：创建文件/文件夹,如果传入的路径中的文件夹不存在，则会自动创建文件夹以及文件，其中创建的文件权限为`如果传入的路径中的文件夹不存在，则会自动创建文件夹以及文件，其中创建的文件权限为-rw-r–r–`。r–r–。
注意：如果需要创建文件的已存在，则会清空该文件的内容！

格式:

Code Block

language	go

func Create(path string) (*os.File, error)

示例：

Code Block

language	go

func ExampleCreate() {
	// init
	var (
		path     = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		dataByte = make([]byte, 50)
	)
	// Check whether the file exists
	isFile := gfile.IsFile(path)

	fmt.Println(isFile)

	// Creates file with given `path` recursively
	fileHandle, _ := gfile.Create(path)
	defer fileHandle.Close()

	// Write some content to file
	n, _ := fileHandle.WriteString("hello goframe")

	// Check whether the file exists
	isFile = gfile.IsFile(path)

	fmt.Println(isFile)
	
	// Reset file uintptr
	unix.Seek(int(fileHandle.Fd()), 0, 0)
	// Reads len(b) bytes from the File
	fileHandle.Read(dataByte)

	fmt.Println(string(dataByte[:n]))

	// Output:
	// false
	// true
	// hello goframe
}

`Open`

说明：以只读的方式打开文件/文件夹。文件夹。

格式:

Code Block

language	go

func Open(path string) (*os.File, error)

示例：

Code Block

language	go

func ExampleOpen() {
	// init
	var (
		path     = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		dataByte = make([]byte, 4096)
	)
	// Open file or directory with READONLY model
	file, _ := gfile.Open(path)
	defer file.Close()

	// Read data
	n, _ := file.Read(dataByte)

	fmt.Println(string(dataByte[:n]))

	// Output:
	// hello goframe
}

`OpenFile`

说明：以指定`flag`以及`perm`的方式打开文件/文件夹。

格式:

Code Block

language	go

func OpenFile(path string, flag int, perm os.FileMode) (*os.File, error)

示例：

Code Block

language	go

func ExampleOpenFile() {
	// init
	var (
		path     = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		dataByte = make([]byte, 4096)
	)
	// Opens file/directory with custom `flag` and `perm`
	// Create if file does not exist,it is created in a readable and writable mode,prem 0777
	openFile, _ := gfile.OpenFile(path, os.O_CREATE|os.O_RDWR, gfile.DefaultPermCopy)
	defer openFile.Close()

	// Write some content to file
	writeLength, _ := openFile.WriteString("hello goframe test open file")

	fmt.Println(writeLength)

	// Read data
	unix.Seek(int(openFile.Fd()), 0, 0)
	n, _ := openFile.Read(dataByte)

	fmt.Println(string(dataByte[:n]))

	// Output:
	// 28
	// hello goframe test open file
}

`OpenWithFalg`

说明：以指定`flag`的方式打开文件/文件夹。

格式:

Code Block

language	go

func OpenWithFlag(path string, flag int) (*os.File, error)

示例：

Code Block

language	go

func ExampleOpenWithFlag() {
	// init
	var (
		path     = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		dataByte = make([]byte, 4096)
	)

	// Opens file/directory with custom `flag`
	// Create if file does not exist,it is created in a readable and writable mode with default `perm` is 0666
	openFile, _ := gfile.OpenWithFlag(path, os.O_CREATE|os.O_RDWR)
	defer openFile.Close()

	// Write some content to file
	writeLength, _ := openFile.WriteString("hello goframe test open file with flag")

	fmt.Println(writeLength)

	// Read data
	unix.Seek(int(openFile.Fd()), 0, 0)
	n, _ := openFile.Read(dataByte)

	fmt.Println(string(dataByte[:n]))

	// Output:
	// 38
	// hello goframe test open file with flag
}

`OpenWithFalgPerm`

说明：以指定`flag`以及`perm`的方式打开文件/文件夹。文件夹。

格式:

Code Block

language	go

func OpenWithFlagPerm(path string, flag int, perm os.FileMode) (*os.File, error)

示例：

Code Block

language	go

func ExampleOpenWithFlagPerm() {
	// init
	var (
		path     = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		dataByte = make([]byte, 4096)
	)

	// Opens file/directory with custom `flag` and `perm`
	// Create if file does not exist,it is created in a readable and writable mode with  `perm` is 0777
	openFile, _ := gfile.OpenWithFlagPerm(path, os.O_CREATE|os.O_RDWR, gfile.DefaultPermCopy)
	defer openFile.Close()

	// Write some content to file
	writeLength, _ := openFile.WriteString("hello goframe test open file with flag and perm")

	fmt.Println(writeLength)

	// Read data
	unix.Seek(int(openFile.Fd()), 0, 0)
	n, _ := openFile.Read(dataByte)

	fmt.Println(string(dataByte[:n]))

	// Output:
	// 38
	// hello goframe test open file with flag
}

`Stat`

说明：获取给定路径的文件详情。

格式:

Code Block

language	go

func Stat(path string) (os.FileInfo, error)

示例：

Code Block

language	go

func ExampleStat() {
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)
	// Get a FileInfo describing the named file.
	stat, _ := gfile.Stat(path)

	fmt.Println(stat.Name())
	fmt.Println(stat.IsDir())
	fmt.Println(stat.Mode())
	fmt.Println(stat.ModTime())
	fmt.Println(stat.Size())
	fmt.Println(stat.Sys())

	// May Output:
	// file1
	// false
	// -rwxr-xr-x
	// 2021-12-02 11:01:27.261441694 +0800 CST
	// &{16777220 33261 1 8597857090 501 20 0 [0 0 0 0] {1638414088 192363490} {1638414087 261441694} {1638414087 261441694} {1638413480 485068275} 38 8 4096 0 0 0 [0 0]}
}

`Move`

`Copy`

格式:

Code Block

language	go

func Copy(src string, dst string) error

示例：

Code Block

language	go

func ExampleCopy() {
	// init
	var (
		srcFileName = "gfile_example.txt"
		srcTempDir  = gfile.TempDir("gfile_example_copy_src")
		srcTempFile = gfile.Join(srcTempDir, srcFileName)

		// copy file
		dstFileName = "gfile_example_copy.txt"
		dstTempFile

说明：将`src`重命名为`dst`。
注意：如果dst已经存在并且是文件，将会被替换造成数据丢失！

示例：

Code Block

language	go

func ExampleMove() { // init var ( srcPath

 = gfile.Join(srcTempDir, dstFileName)

		// copy dir
		dstTempDir = gfile.TempDir("gfile_example_

basic

copy_

dir

dst")
	)

	// write contents
	gfile.PutContents(srcTempFile, "

file1

goframe example copy")

dstPath

//

=

copy

gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file2") )

file
	gfile.Copy(srcTempFile, dstTempFile)

	// read contents

Check

after

is

copy file fmt.Println(gfile.

IsFile

GetContents(

dstPath

dstTempFile)) //

Moves `src` to `dst` path.

copy dir
	gfile.Copy(srcTempDir, dstTempDir)

	//

If

list

`dst`

copy

already exists and is not a directory, it'll be replaced. gfile.Move(srcPath, dstPath) fmt.Println(gfile.IsFile(srcPath))

dir file
	fList, _ := gfile.ScanDir(dstTempDir, "*", false)
	for _, v := range fList {
		fmt.Println(gfile.

IsFile

Basename(

dstPath

v)) } // Output: // goframe

false

example copy //

false

gfile_example.txt //

true }

`Rename`

gfile_example_copy.txt }

`CopyFile`

说明：复制文件

格式:

Code Block

language	go

func CopyFile(src, dst string) (err error)

说明：Move的别名，将`src`重命名为`dst`。
注意：如果dst已经存在并且是文件，将会被替换造成数据丢失！
示例：
Code Block
language go
func

ExampleRename

ExampleCopyFile() { // init var (

srcPath

srcFileName = "gfile_example.txt"
		srcTempDir  = gfile.

Join

TempDir("gfile

.TempDir(

_example_copy_src")
		srcTempFile = gfile.Join(srcTempDir, srcFileName)

		// copy file
		dstFileName = "gfile_example_

basic_dir"), "file2")

copy.txt"

dstPath

dstTempFile = gfile.Join(

gfile.TempDir("gfile_example_basic_dir"), "file1"

srcTempDir, dstFileName) ) //

Check

write

is file

contents

fmt.Println(

gfile.

IsFile(dstPath))

PutContents(srcTempFile, "goframe example copy")

	//

renames (moves) `src` to `dst` path.

copy file
	gfile.CopyFile(srcTempFile, dstTempFile)

	//

If

read

`dst`

contents

already exists and is not a directory, it'll be replaced. gfile.Rename(srcPath, dstPath)

after copy file fmt.Println(gfile.

IsFile

GetContents(

srcPath

dstTempFile))

fmt.Println(gfile.IsFile(dstPath))

// Output: //

false // false // true }

`Remove`

goframe example copy }

`CopyDir`

说明：支持复制文件或目录
格式:
Code Block
language go
func CopyDir(src string, dst string) error
说明：删除给定路径的文件或文件夹。
示例：
Code Block
language go
func

ExampleRemove

ExampleCopyDir() { // init var (

path

srcTempDir = gfile.

Join(gfile.

TempDir("gfile_example_

basic

copy_

dir

src")

, "file1")

)

//

Checks whether given `path` a file, which means it's not a directory. fmt.Println(gfile.IsFile(path)

copy file
		dstFileName = "gfile_example_copy.txt"
		dstTempFile = gfile.Join(srcTempDir, dstFileName)

		//

deletes all file/directory with `path` parameter. gfile.Remove(path)

copy dir
		dstTempDir = gfile.TempDir("gfile_example_copy_dst")
	)
	//

Check again

read contents after copy file
	fmt.Println(gfile.

IsFile

GetContents(

path

dstTempFile)) //

Output: // true // false }

`IsEmpty`

说明：检查给定的路径,如果是文件夹则检查是否包含文件，如果是文件则检查`容量`是否为空。

示例：

Code Block

language	go

func ExampleIsEmpty() {

copy dir
	gfile.CopyDir(srcTempDir, dstTempDir)

	//

init var ( path

list copy dir file fList, _ := gfile.

Join(gfile.TempDir("gfile_example_basic_dir"), "file1") ) // Check whether the `path` is empty

ScanDir(dstTempDir, "*", false)
	for _, v := range fList {
		fmt.Println(gfile.

IsEmpty

Basename(

path

v)) } //

Truncate file

Output: // gfile

.Truncate(path, 0)

_example.txt //

Check whether the `path` is empty fmt.Println(gfile.IsEmpty(path)) // Output: // false // true }

`Chmod`

gfile_example_copy.txt }

`Move`

说明：将src重命名为dst。
注意：如果dst已经存在并且是文件，将会被替换造成数据丢失！
格式:
Code Block
language go
func Move(src string, dst string) error
说明：使用指定的权限，更改指定路径的文件权限。

示例：

Code Block

language	go

func ExampleChmodExampleMove() {
	// init
	var (
		pathsrcPath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	//dstPath Get a FileInfo describing the named file.
	stat, err := gfile.Stat(path)
	if err != nil {
		fmt.Println(err.Error())
	}= gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file2")
	)
	// ShowCheck originalis modefile
	fmt.Println(statgfile.ModeIsFile(dstPath))

	//  Moves `src` Changeto file model
	gfile.Chmod(path, gfile.DefaultPermCopy)
`dst` path.
	// Get a FileInfo describing the named file.
	stat, _ = gfile.Stat(path)
	// Show the modified modeIf `dst` already exists and is not a directory, it'll be replaced.
	gfile.Move(srcPath, dstPath)

	fmt.Println(gfile.IsFile(srcPath))
	fmt.Println(statgfile.ModeIsFile(dstPath))

	// Output:
	// -rw-r--r--false
	// false
	// -rwxrwxrwxtrue
}

路径操作

`Join`

`Rename`

说明：Move的别名，将src重命名为dst。
注意：如果dst已经存在并且是文件，将会被替换造成数据丢失！
格式:
Code Block
language go
func Rename(src string, dst string) error
说明：将多个字符串路径通过`/`进行连接。

示例：

Code Block

language	go

func ExampleJoinExampleRename() {
	// init
	var (
		dirPath srcPath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file2")
		dstPath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		filePath = "file1"
	)
)
	// Check is file
	fmt.Println(gfile.IsFile(dstPath))

	//  renames (moves) `src` to `dst` path.
	// If `dst` Joinsalready stringexists arrayand pathsis withnot filea separator of current systemdirectory, it'll be replaced.
	joinString := gfile.JoinRename(dirPathsrcPath, filePathdstPath)

	fmt.Println(joinStringgfile.IsFile(srcPath))
	fmt.Println(gfile.IsFile(dstPath))

	// Output:
	// /tmp/gfile_example_basic_dir/file1
}

`Exists`

false // false // true }

`Remove`

说明：删除给定路径的文件或文件夹。
格式:
Code Block
language go
func Remove(path string) error
说明：检查给定的路径是否存在。

示例：

Code Block

language	go

func ExampleExistsExampleRemove() {
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	// Checks whether given `path` a file, which means it's not a directory.
	fmt.Println(gfile.IsFile(path))

	// deletes all file/directory with `path` exist.parameter.
	gfile.Remove(path)

	// Check again
	fmt.Println(gfile.Exists(path))

	// Output:
	// true
}

`IsDir`

.IsFile(path))

	// Output:
	// true
	// false
}

`IsEmpty`

说明：检查给定的路径，如果是文件夹则检查是否包含文件，如果是文件则检查文件大小是否为空。
格式:
Code Block
language go
func IsEmpty(path string) bool
说明：检查给定的路径是否是文件夹。

示例：

Code Block

language	go

func ExampleIsDirExampleIsEmpty() {
	// init
	var (
		path     = gfile.TempDir("gfile_example_basic_dir")
		filePath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	// ChecksCheck whether giventhe `path` ais directory.empty
	fmt.Println(gfile.IsDirIsEmpty(path))
	fmt.Println(gfile.IsDir(filePath))

	// Output:
	// true
	// false
}

`Pwd`

说明：获取当前工作路径。

示例：

Code Block

language	go

func ExamplePwd() {Truncate file
	gfile.Truncate(path, 0)

	// GetCheck absolutewhether paththe of`path` current working directory.is empty
	fmt.Println(gfile.PwdIsEmpty(path))

	// May Output:
	// xxxfalse
	/gf/os/gfile true
}

`Chdir`

`DirNames`

说明：获取给定路径下的文件列表，返回的是一个切片。
格式:
Code Block
language go
func DirNames(path string) ([]string, error)
说明：使用给定的路径，更改当前的工作路径。

示例：

Code Block

language	go

func ExampleChdirExampleDirNames() {
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)
	// Get current working directory
	fmt.Println(gfile.Pwd())

	// Changes the current working directory to the named directory.
	gfile.Chdir(path)

	// Get current working directory sub-file names of given directory `path`.
	dirNames, _ := gfile.DirNames(path)

	fmt.Println(gfile.Pwd(dirNames))

	// May Output:
	// xxx/gf/os/gfile
	// /tmp/gfile_example_basic_dir/file1
}

`IsFile`

[file1] }

`Glob`

说明：模糊搜索给定路径下的文件列表，支持正则，第二个参数控制返回的结果是否带上绝对路径。
格式:
Code Block
language go
func Glob(pattern string, onlyNames ...bool) ([]string, error)
说明：检查给定的路径是否是文件。

示例：

Code Block

language	go

func ExampleIsFileExampleGlob() {
	// init
	var (
		filePath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")	var (
		dirPath path = gfile.TempDir("gfilePwd() + gfile.Separator + "*_example_basic_dirtest.go")
	)
	// Checks whether Get sub-file names of given directory `path` a.
	// Only show file name
	matchNames, which_ means it's not a directory.:= gfile.Glob(path, true)

	fmt.Println(matchNames)

	// Show full path of the file
	matchNames, _ = gfile.IsFile(filePath))Glob(path, false)

	fmt.Println(gfile.IsFilePrintln(dirPath)matchNames)

	// May Output:
	// true[gfile_z_example_basic_test.go]
	// false
}

`DirNames`

[xxx/gf/os/gfile/gfile_z_example_basic_test.go]
}

`Exists`

说明：检查给定的路径是否存在。
格式:
Code Block
language go
func Exists(path string) bool
说明：获取给定路径下的文件列表，返回的是一个切片。

示例：

Code Block

language	go

func ExampleDirNamesExampleExists() {
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)
	// GetChecks sub-file names of whether given directory`path` `path`exist.
	dirNames, _ := fmt.Println(gfile.DirNamesExists(path)

	fmt.Println(dirNames)

	// May Output:
	// [file1]true
}

`Glob`

`Chdir`

说明：使用给定的路径，更改当前的工作路径。
格式:
Code Block
language go
func Chdir(dir string) error
说明：模糊搜索给定路径下的文件列表，支持正则，第二个参数控制返回的结果是否带上绝对路径。

示例：

Code Block

language	go

func ExampleGlobExampleChdir() {
	// init
	var (
		path = gfile.PwdJoin() + gfile.Separator + "*TempDir("gfile_example_basic_test.go"dir"), "file1")
	)
	// Get sub-file names of givencurrent working directory `path`.
	// Only show file name
	matchNames, _ := gfile.Glob(path, true)

	fmt.Println(matchNames
	fmt.Println(gfile.Pwd())

	// Changes Showthe current fullworking pathdirectory ofto the named filedirectory.
	matchNames, _ = gfile.GlobChdir(path, false)

	// Get current working directory
	fmt.Println(gfile.Pwd(matchNames))

	// May Output:
	// [gfile_z_example_basic_test.go]xxx/gf/os/gfile
	// [xxx/gftmp/os/gfile/gfile_z_example_basic_test.go]
}

`IsReadable`

dir/file1 }

路径操作

`Join`

说明：将多个字符串路径通过`/`进行连接。
格式:
Code Block
language go
func Join(paths ...string) string
说明：检查给定的路径是否可读。

示例：

Code Block

language	go

func ExampleIsReadableExampleJoin() {
	// init
	var (
		pathdirPath  = gfile.Pwd() + gfile.Separator + "testdata/readline/file.logTempDir("gfile_example_basic_dir")
		filePath = "file1"
	)

	// Checks whether given `path` is readable.
 Joins string array paths with file separator of current system.
	joinString := gfile.Join(dirPath, filePath)

	fmt.Println(gfile.IsReadable(path)joinString)

	// Output:
	// true/tmp/gfile_example_basic_dir/file1
}

`Abs`

说明：返回路径的绝对路径。
格式:
Code Block
language go
func Abs(path string) string

示例：

Code Block

language	go

func ExampleAbs() {
	// init
	var (
		path = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	// Get an absolute representation of path.
	fmt.Println(gfile.Abs(path))

	// Output:
	// /tmp/gfile_example_basic_dir/file1
}

`RealPath`

说明：获取给定路径的绝对路径地址。
注意：如果文件不存在则返回空。
格式:
Code Block
language go
func RealPath(path string) string
说明：获取给定路径的绝对路径地址，如果文件不存在则返回空。

示例：

Code Block

language	go

func ExampleRealPath() {
	// init
	var (
		realPath  = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "file1")
		worryPath = gfile.Join(gfile.TempDir("gfile_example_basic_dir"), "worryFile")
	)

	// fetch an absolute representation of path.
	fmt.Println(gfile.RealPath(realPath))
	fmt.Println(gfile.RealPath(worryPath))

	// Output:
	// /tmp/gfile_example_basic_dir/file1
	//
}

`SelfPath`

`SelfName`

说明：获取当前运行程序的名称。
格式:
Code Block
language go
func SelfName() string
说明：获取当前运行程序的绝对路径。

示例：

Code Block

language	go

func ExampleSelfPathExampleSelfName() {

	// Get absolute file pathname of current running process
	fmt.Println(gfile.SelfPathSelfName())

	// May Output:
	// xxx/___github_com_gogf_gf_v2_os_gfile__ExampleSelfPathExampleSelfName
}

`SelfName`

`Basename`

说明：获取给定路径中的最后一个元素，包含扩展名。
格式:
Code Block
language go
func Basename(path string) string
说明：获取当前运行程序的名称。

示例：

Code Block

language	go

func ExampleSelfName() { ExampleBasename() {
	// init
	var (
		path = gfile.Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

	// Get the filelast nameelement of current running process path, which contains file extension.
	fmt.Println(gfile.SelfNameBasename(path))

	// May Output:
	// ___github_com_gogf_gf_v2_os_gfile__ExampleSelfName
}

`Basename`

file.log }

`Name`

说明：获取给定路径中的最后一个元素，不包含扩展名。
格式:
Code Block
language go
func Name(path string) string
说明：获取给定路径中的最后一个元素，包含扩展名。

示例：

Code Block

language	go

func ExampleBasenameExampleName() {
	// init
	var (
		path = gfile.Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

	// Get the last element of path, which containswithout file extension.
	fmt.Println(gfile.Basename(path))

	// Output:
	// file.log
}

`Name`

Name(path)) // Output: // file }

`Dir`

说明：获取给定路径的目录部分，排除最后的元素。
格式:
Code Block
language go
func Dir(path string) string
说明：获取给定路径中的最后一个元素，不包含扩展名。

示例：

Code Block

language	go

func ExampleNameExampleDir() {
	// init
	var (
		path = gfile.PwdJoin() + gfile.Separator + "testdata/readline/file.log"gfile.TempDir("gfile_example_basic_dir"), "file1")
	)

	// Get all but the last element of path, typically withoutthe filepath's extensiondirectory.
	fmt.Println(gfile.Name(path))

	// Output:
	// file
}

`Dir`

.Dir(path))

	// Output:
	// /tmp/gfile_example_basic_dir
}

`Ext`

说明：获取给定路径的扩展名，包含`.`。
格式:
Code Block
language go
func Ext(path string) string
说明：获取给定路径的目录部分，排除最后的元素。

示例：

Code Block

language	go

func ExampleDirExampleExt() {
	// init
	var (
		path = gfile.JoinPwd(gfile.TempDir("gfile_example_basic_dir"), "file1")) + gfile.Separator + "testdata/readline/file.log"
	)

	// Get all but the lastfile elementname ofextension path, typically theused by path's directory.
	fmt.Println(gfile.DirExt(path))

	// Output:
	// /tmp/gfile_example_basic_dir
}

`Ext`

.log }

`ExtName`

说明：获取给定路径的扩展名，不包含`.`。
格式:
Code Block
language go
func ExtName(path string) string
说明：获取给定路径的扩展名，包含`.`。

示例：

Code Block

language	go

func ExampleExtExampleExtName() {
	// init
	var (
		path = gfile.Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

	// Get the file name extension used by path but the result does not contains symbol '.'.
	fmt.Println(gfile.ExtExtName(path))

	// Output:
	// .log
}

`ExtName`

`MainPkgPath`

说明：获取main文件（主入口）所在的绝对路径，。
注意：
- 该方法仅在开发环境中可用，同时仅在源代码开发环境中有效，build二进制后将显示源代码的路径地址。
- 第一次调用该方法时，如果处于异步的goroutine中，可能会无法获取主包的路径
格式:
Code Block
language go
func MainPkgPath() string
说明：获取给定路径的扩展名，不包含`.`。

示例：

Code Block

language	go

func ExampleExtNameTest() {
	// init
	var (
		path = gfile.Pwd() + gfile.Separator + "testdata/readline/file.log"
	)

	// Get the file name extension used by path but the result does not contains symbol '.'.
	fmt.Println(gfile.ExtName(path))

	// Output:
	// log
}

`TempDir`

说明：获取拼接系统临时路径后的绝对地址。

示例：

Code Block

language	go

func ExampleTempDir() {
	// init
	var (
		fileName = "gfile_example_basic_dir"
	)

	// fetch an absolute representation of path.
	path := gfile.TempDir(fileName)

	fmt.Println(path)

	// Output:
	// /tmp/gfile_example_basic_dir
}fmt.Println("main pkg path on main :", gfile.MainPkgPath())
	char := make(chan int, 1)
	go func() {
		fmt.Println("main pkg path on goroutine :", gfile.MainPkgPath())
		char <- 1
	}()
	select {
	case <-char:
	}
	// Output:
	// /xxx/xx/xxx/xx
	// /xxx/xx/xxx/xx
}
// 二进制包
$ ./testDemo 
main pkg path on main : /xxx/xx/xxx/xx
main pkg path on goroutine : /xxx/xx/xxx/xx

Panel

title	Content Menu

Table of Contents

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 34

New Version Current

Key

基本介绍

内容管理

GetContents

GetContentsWithCache

GetBytes

GetBytesWithCache

PutContents

GetBytes

PutBytes

GetBytesTilChar

PutContentsAppend

PutBytesAppend

GetBytesByTwoOffsets

GetNextCharOffsetByPath

PutContents

GetBytesTilCharByPath

PutBytes

GetBytesByTwoOffsetsByPath

PutContentsAppend

ReadLines

ReadLinesBytes

PutBytesAppend

内容替换

ReplaceFile

GetNextCharOffset

ReplaceFileFunc

GetNextCharOffsetByPath

ReplaceDir

GetBytesTilCharByPath

GetBytesByTwoOffsetsByPath

ReplaceDirFunc

ReadLines

ReadLinesBytes

MTimestamp

MTimestampMilli

文件大小

Size

Truncate

内容替换

ReplaceFile

ReplaceFileFunc

ReplaceDir

ReplaceDirFunc

文件时间

MTime

MTimestamp

MTimestampMilli

文件大小

Size

SizeFormat

ReadableSize

StrToSize

FormatSize

文件排序

SortFiles

文件检索

Search

目录扫描

ScanDir

SizeFormat

ReadableSize

ScanDirFile

StrToSize

FormatSize

文件排序

SortFiles

ScanDirFunc

文件检索

Search

目录扫描

ScanDir

ScanDirFileFunc

常用目录

`GetContents`

`GetContentsWithCache`

`GetBytes`

`GetBytesWithCache`

`PutContents`

`GetBytes`

`PutBytes`

`GetBytesTilChar`

`PutContentsAppend`

`PutBytesAppend`

`GetBytesByTwoOffsets`

`GetNextCharOffsetByPath`

`PutContents`

`GetBytesTilCharByPath`

`PutBytes`

`GetBytesByTwoOffsetsByPath`

`PutContentsAppend`

`ReadLines`

`ReadLinesBytes`

`PutBytesAppend`

`ReplaceFile`

`GetNextCharOffset`

`ReplaceFileFunc`

`GetNextCharOffsetByPath`

`ReplaceDir`

`GetBytesTilCharByPath`

`GetBytesByTwoOffsetsByPath`

`ReplaceDirFunc`

`ReadLines`

`ReadLinesBytes`

`MTimestamp`

`MTimestampMilli`

`Size`

`Truncate`

`ReplaceFile`

`ReplaceFileFunc`

`ReplaceDir`

`ReplaceDirFunc`

`MTime`

`MTimestamp`

`MTimestampMilli`

`Size`

`SizeFormat`

`ReadableSize`

`StrToSize`

`FormatSize`

`SortFiles`

`Search`

`ScanDir`

`SizeFormat`

`ReadableSize`

`ScanDirFile`

`StrToSize`

`FormatSize`

`SortFiles`

`ScanDirFunc`

`Search`

`ScanDir`

`ScanDirFileFunc`

`Pwd`

`Home`

`ScanDirFunc`

`Temp`

`SelfPath`

`IsDir`

`IsFile`

`IsReadable`

`Copy`

`IsWritable`

`Chmod`

`Home`

`Mkdir`

`Create`

`Open`

`OpenFile`

`OpenWithFalg`

`OpenWithFalgPerm`

`Stat`

`Move`

`Copy`