package renameio
import "cmd/go/internal/renameio"
Package renameio writes files atomically by renaming temporary files.
Index ¶
- func Pattern(filename string) string
- func ReadFile(filename string) ([]byte, error)
- func WriteFile(filename string, data []byte, perm fs.FileMode) (err error)
- func WriteToFile(filename string, data io.Reader, perm fs.FileMode) (err error)
Functions ¶
func Pattern ¶
Pattern returns a glob pattern that matches the unrenamed temporary files created when writing to filename.
func ReadFile ¶
ReadFile is like os.ReadFile, but on Windows retries spurious errors that may occur if the file is concurrently replaced.
Errors are classified heuristically and retries are bounded, so even this function may occasionally return a spurious error on Windows. If so, the error will likely wrap one of:
- syscall.ERROR_ACCESS_DENIED
- syscall.ERROR_FILE_NOT_FOUND
- internal/syscall/windows.ERROR_SHARING_VIOLATION
func WriteFile ¶
WriteFile is like os.WriteFile, but first writes data to an arbitrary file in the same directory as filename, then renames it atomically to the final name.
That ensures that the final location, if it exists, is always a complete file.
func WriteToFile ¶
WriteToFile is a variant of WriteFile that accepts the data as an io.Reader instead of a slice.
Source Files ¶
- Version
- v1.16.11
- Published
- Dec 2, 2021
- Platform
- linux/amd64
- Imports
- 8 packages
- Last checked
- 3 minutes ago –
Tools for package owners.