mirror of
https://github.com/golang/go.git
synced 2025-12-08 06:10:04 +00:00
abe384f68a
Phrases like "returns whether or not the image is opaque" could be describing what the function does (it always returns, regardless of the opacity) or what it returns (a boolean indicating the opacity). Even when the "or not" is missing, the phrasing is bizarre. Go with "reports whether", which is still clunky but at least makes it clear we're talking about the return value. These were edited by hand. A few were cleaned up in other ways. R=golang-dev, dsymonds CC=golang-dev https://golang.org/cl/11699043
65 lines
1.9 KiB
Go
65 lines
1.9 KiB
Go
// Copyright 2009 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package os
|
|
|
|
import (
|
|
"errors"
|
|
)
|
|
|
|
// Portable analogs of some common system call errors.
|
|
var (
|
|
ErrInvalid = errors.New("invalid argument")
|
|
ErrPermission = errors.New("permission denied")
|
|
ErrExist = errors.New("file already exists")
|
|
ErrNotExist = errors.New("file does not exist")
|
|
)
|
|
|
|
// PathError records an error and the operation and file path that caused it.
|
|
type PathError struct {
|
|
Op string
|
|
Path string
|
|
Err error
|
|
}
|
|
|
|
func (e *PathError) Error() string { return e.Op + " " + e.Path + ": " + e.Err.Error() }
|
|
|
|
// SyscallError records an error from a specific system call.
|
|
type SyscallError struct {
|
|
Syscall string
|
|
Err error
|
|
}
|
|
|
|
func (e *SyscallError) Error() string { return e.Syscall + ": " + e.Err.Error() }
|
|
|
|
// NewSyscallError returns, as an error, a new SyscallError
|
|
// with the given system call name and error details.
|
|
// As a convenience, if err is nil, NewSyscallError returns nil.
|
|
func NewSyscallError(syscall string, err error) error {
|
|
if err == nil {
|
|
return nil
|
|
}
|
|
return &SyscallError{syscall, err}
|
|
}
|
|
|
|
// IsExist returns a boolean indicating whether the error is known to report
|
|
// that a file or directory already exists. It is satisfied by ErrExist as
|
|
// well as some syscall errors.
|
|
func IsExist(err error) bool {
|
|
return isExist(err)
|
|
}
|
|
|
|
// IsNotExist returns a boolean indicating whether the error is known to
|
|
// report that a file or directory does not exist. It is satisfied by
|
|
// ErrNotExist as well as some syscall errors.
|
|
func IsNotExist(err error) bool {
|
|
return isNotExist(err)
|
|
}
|
|
|
|
// IsPermission returns a boolean indicating whether the error is known to
|
|
// report that permission is denied. It is satisfied by ErrPermission as well
|
|
// as some syscall errors.
|
|
func IsPermission(err error) bool {
|
|
return isPermission(err)
|
|
}
|