type readdirMode … const readdirName … const readdirDirEntry … const readdirFileInfo … // Readdir reads the contents of the directory associated with file and // returns a slice of up to n [FileInfo] values, as would be returned // by [Lstat], in directory order. Subsequent calls on the same file will yield // further FileInfos. // // If n > 0, Readdir returns at most n FileInfo structures. In this case, if // Readdir returns an empty slice, it will return a non-nil error // explaining why. At the end of a directory, the error is [io.EOF]. // // If n <= 0, Readdir returns all the FileInfo from the directory in // a single slice. In this case, if Readdir succeeds (reads all // the way to the end of the directory), it returns the slice and a // nil error. If it encounters an error before the end of the // directory, Readdir returns the FileInfo read until that point // and a non-nil error. // // Most clients are better served by the more efficient ReadDir method. func (f *File) Readdir(n int) ([]FileInfo, error) { … } // Readdirnames reads the contents of the directory associated with file // and returns a slice of up to n names of files in the directory, // in directory order. Subsequent calls on the same file will yield // further names. // // If n > 0, Readdirnames returns at most n names. In this case, if // Readdirnames returns an empty slice, it will return a non-nil error // explaining why. At the end of a directory, the error is [io.EOF]. // // If n <= 0, Readdirnames returns all the names from the directory in // a single slice. In this case, if Readdirnames succeeds (reads all // the way to the end of the directory), it returns the slice and a // nil error. If it encounters an error before the end of the // directory, Readdirnames returns the names read until that point and // a non-nil error. func (f *File) Readdirnames(n int) (names []string, err error) { … } type DirEntry … // ReadDir reads the contents of the directory associated with the file f // and returns a slice of [DirEntry] values in directory order. // Subsequent calls on the same file will yield later DirEntry records in the directory. // // If n > 0, ReadDir returns at most n DirEntry records. // In this case, if ReadDir returns an empty slice, it will return an error explaining why. // At the end of a directory, the error is [io.EOF]. // // If n <= 0, ReadDir returns all the DirEntry records remaining in the directory. // When it succeeds, it returns a nil error (not io.EOF). func (f *File) ReadDir(n int) ([]DirEntry, error) { … } var testingForceReadDirLstat … // ReadDir reads the named directory, // returning all its directory entries sorted by filename. // If an error occurs reading the directory, // ReadDir returns the entries it was able to read before the error, // along with the error. func ReadDir(name string) ([]DirEntry, error) { … } // CopyFS copies the file system fsys into the directory dir, // creating dir if necessary. // // Files are created with mode 0o666 plus any execute permissions // from the source, and directories are created with mode 0o777 // (before umask). // // CopyFS will not overwrite existing files. If a file name in fsys // already exists in the destination, CopyFS will return an error // such that errors.Is(err, fs.ErrExist) will be true. // // Symbolic links in fsys are not supported. A *PathError with Err set // to ErrInvalid is returned when copying from a symbolic link. // // Symbolic links in dir are followed. // // Copying stops at and returns the first error encountered. func CopyFS(dir string, fsys fs.FS) error { … }
Codebase Browser
go