qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-26 16:07:00 -07:00
Code Releases Activity

io/fs: clarify additional File interface docs

Browse Source 
Emphasize ReadDirFile. It isn't really optional,
and all filesystems have at least one directory (".").

The remaining two additional interfaces are optimizations.
Call them that.

Fully qualify package package io identifiers.

Change-Id: Ibc425a5dfd27e08c2c10c353f780e4a6304cfd87
Reviewed-on: https://go-review.googlesource.com/c/go/+/296390
Trust: Josh Bleecher Snyder <josharian@gmail.com>
Run-TryBot: Josh Bleecher Snyder <josharian@gmail.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
This commit is contained in:
Josh Bleecher Snyder 2021-02-25 09:32:38 -08:00
parent 0a655598e1
commit bbf79793bd
1 changed files with 2 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/io/fs/fs.go
View File

@ -73,8 +73,8 @@ func ValidPath(name string) bool {
// A File provides access to a single file. // A File provides access to a single file.
// The File interface is the minimum implementation required of the file. // The File interface is the minimum implementation required of the file.
// A file may implement additional interfaces, such as // Directory files should also implement ReadDirFile.
// ReadDirFile, ReaderAt, or Seeker, to provide additional or optimized functionality. // A file may implement io.ReaderAt or io.Seeker as optimizations.
type File interface { type File interface {
Stat() (FileInfo, error) Stat() (FileInfo, error)
Read([]byte) (int, error) Read([]byte) (int, error)