Stowage/go
2
0
Fork 0
mirror of https://github.com/golang/go.git synced 2025-12-08 06:10:04 +00:00
Code Issues Projects Releases Packages Wiki Activity

all: rename os.Error to error in various non-code contexts

Browse source 
R=adg
CC=golang-dev
https://golang.org/cl/5328062
This commit is contained in:
Russ Cox 2011-11-01 22:58:09 -04:00
parent abd3260990
commit 492098eb75
34 changed files with 91 additions and 105 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/codelab/wiki/index.html
View file

@ -107,7 +107,7 @@ func (p *Page) save() error {
<p> <p>
This method's signature reads: "This is a method named <code>save</code> that This method's signature reads: "This is a method named <code>save</code> that
takes as its receiver <code>p</code>, a pointer to <code>Page</code> . It takes takes as its receiver <code>p</code>, a pointer to <code>Page</code> . It takes
no parameters, and returns a value of type <code>os.Error</code>." no parameters, and returns a value of type <code>error</code>."
</p> </p>
<p> <p>
@ -116,7 +116,7 @@ file. For simplicity, we will use the <code>Title</code> as the file name.
</p> </p>
<p> <p>
The <code>save</code> method returns an <code>os.Error</code> value because The <code>save</code> method returns an <code>error</code> value because
that is the return type of <code>WriteFile</code> (a standard library function that is the return type of <code>WriteFile</code> (a standard library function
that writes a byte slice to a file). The <code>save</code> method returns the that writes a byte slice to a file). The <code>save</code> method returns the
error value, to let the application handle it should anything go wrong while error value, to let the application handle it should anything go wrong while
@ -152,7 +152,7 @@ The function <code>loadPage</code> constructs the file name from
<p> <p>
Functions can return multiple values. The standard library function Functions can return multiple values. The standard library function
<code>io.ReadFile</code> returns <code>[]byte</code> and <code>os.Error</code>. <code>io.ReadFile</code> returns <code>[]byte</code> and <code>error</code>.
In <code>loadPage</code>, error isn't being handled yet; the "blank identifier" In <code>loadPage</code>, error isn't being handled yet; the "blank identifier"
represented by the underscore (<code>_</code>) symbol is used to throw away the represented by the underscore (<code>_</code>) symbol is used to throw away the
error return value (in essence, assigning the value to nothing). error return value (in essence, assigning the value to nothing).
@ -161,7 +161,7 @@ error return value (in essence, assigning the value to nothing).
<p> <p>
But what happens if <code>ReadFile</code> encounters an error? For example, But what happens if <code>ReadFile</code> encounters an error? For example,
the file might not exist. We should not ignore such errors. Let's modify the the file might not exist. We should not ignore such errors. Let's modify the
function to return <code>*Page</code> and <code>os.Error</code>. function to return <code>*Page</code> and <code>error</code>.
</p> </p>
<pre> <pre>
@ -178,7 +178,7 @@ func loadPage(title string) (*Page, error) {
<p> <p>
Callers of this function can now check the second parameter; if it is Callers of this function can now check the second parameter; if it is
<code>nil</code> then it has successfully loaded a Page. If not, it will be an <code>nil</code> then it has successfully loaded a Page. If not, it will be an
<code>os.Error</code> that can be handled by the caller (see the <a <code>error</code> that can be handled by the caller (see the <a
href="http://golang.org/pkg/os/#Error">os package documentation</a> for href="http://golang.org/pkg/os/#Error">os package documentation</a> for
details). details).
</p> </p>
@ -337,7 +337,7 @@ HTML, and writes it to <code>w</code>, the <code>http.ResponseWriter</code>.
</p> </p>
<p> <p>
Again, note the use of <code>_</code> to ignore the <code>os.Error</code> Again, note the use of <code>_</code> to ignore the <code>error</code>
return value from <code>loadPage</code>. This is done here for simplicity return value from <code>loadPage</code>. This is done here for simplicity
and generally considered bad practice. We will attend to this later. and generally considered bad practice. We will attend to this later.
</p> </p>
@ -711,7 +711,7 @@ var templates = make(map[string]*template.Template)
Then we create an <code>init</code> function, which will be called before Then we create an <code>init</code> function, which will be called before
<code>main</code> at program initialization. The function <code>main</code> at program initialization. The function
<code>template.Must</code> is a convenience wrapper that panics when passed a <code>template.Must</code> is a convenience wrapper that panics when passed a
non-nil <code>os.Error</code> value, and otherwise returns the non-nil <code>error</code> value, and otherwise returns the
<code>*Template</code> unaltered. A panic is appropriate here; if the templates <code>*Template</code> unaltered. A panic is appropriate here; if the templates
can't be loaded the only sensible thing to do is exit the program. can't be loaded the only sensible thing to do is exit the program.
</p> </p>
@ -768,7 +768,7 @@ The function <code>regexp.MustCompile</code> will parse and compile the
regular expression, and return a <code>regexp.Regexp</code>. regular expression, and return a <code>regexp.Regexp</code>.
<code>MustCompile</code> is distinct from <code>Compile</code> in that it will <code>MustCompile</code> is distinct from <code>Compile</code> in that it will
panic if the expression compilation fails, while <code>Compile</code> returns panic if the expression compilation fails, while <code>Compile</code> returns
an <code>os.Error</code> as a second parameter. an <code>error</code> as a second parameter.
</p> </p>
<p> <p>

16
doc/codelab/wiki/wiki.html
View file

@ -101,7 +101,7 @@ But what about persistent storage? We can address that by creating a
<p> <p>
This method's signature reads: "This is a method named <code>save</code> that This method's signature reads: "This is a method named <code>save</code> that
takes as its receiver <code>p</code>, a pointer to <code>Page</code> . It takes takes as its receiver <code>p</code>, a pointer to <code>Page</code> . It takes
no parameters, and returns a value of type <code>os.Error</code>." no parameters, and returns a value of type <code>error</code>."
</p> </p>
<p> <p>
@ -110,7 +110,7 @@ file. For simplicity, we will use the <code>Title</code> as the file name.
</p> </p>
<p> <p>
The <code>save</code> method returns an <code>os.Error</code> value because The <code>save</code> method returns an <code>error</code> value because
that is the return type of <code>WriteFile</code> (a standard library function that is the return type of <code>WriteFile</code> (a standard library function
that writes a byte slice to a file). The <code>save</code> method returns the that writes a byte slice to a file). The <code>save</code> method returns the
error value, to let the application handle it should anything go wrong while error value, to let the application handle it should anything go wrong while
@ -142,7 +142,7 @@ The function <code>loadPage</code> constructs the file name from
<p> <p>
Functions can return multiple values. The standard library function Functions can return multiple values. The standard library function
<code>io.ReadFile</code> returns <code>[]byte</code> and <code>os.Error</code>. <code>io.ReadFile</code> returns <code>[]byte</code> and <code>error</code>.
In <code>loadPage</code>, error isn't being handled yet; the "blank identifier" In <code>loadPage</code>, error isn't being handled yet; the "blank identifier"
represented by the underscore (<code>_</code>) symbol is used to throw away the represented by the underscore (<code>_</code>) symbol is used to throw away the
error return value (in essence, assigning the value to nothing). error return value (in essence, assigning the value to nothing).
@ -151,7 +151,7 @@ error return value (in essence, assigning the value to nothing).
<p> <p>
But what happens if <code>ReadFile</code> encounters an error? For example, But what happens if <code>ReadFile</code> encounters an error? For example,
the file might not exist. We should not ignore such errors. Let's modify the the file might not exist. We should not ignore such errors. Let's modify the
function to return <code>*Page</code> and <code>os.Error</code>. function to return <code>*Page</code> and <code>error</code>.
</p> </p>
<pre> <pre>
@ -161,7 +161,7 @@ function to return <code>*Page</code> and <code>os.Error</code>.
<p> <p>
Callers of this function can now check the second parameter; if it is Callers of this function can now check the second parameter; if it is
<code>nil</code> then it has successfully loaded a Page. If not, it will be an <code>nil</code> then it has successfully loaded a Page. If not, it will be an
<code>os.Error</code> that can be handled by the caller (see the <a <code>error</code> that can be handled by the caller (see the <a
href="http://golang.org/pkg/os/#Error">os package documentation</a> for href="http://golang.org/pkg/os/#Error">os package documentation</a> for
details). details).
</p> </p>
@ -297,7 +297,7 @@ HTML, and writes it to <code>w</code>, the <code>http.ResponseWriter</code>.
</p> </p>
<p> <p>
Again, note the use of <code>_</code> to ignore the <code>os.Error</code> Again, note the use of <code>_</code> to ignore the <code>error</code>
return value from <code>loadPage</code>. This is done here for simplicity return value from <code>loadPage</code>. This is done here for simplicity
and generally considered bad practice. We will attend to this later. and generally considered bad practice. We will attend to this later.
</p> </p>
@ -575,7 +575,7 @@ our <code>*Template</code> values, keyed by <code>string</code>
Then we create an <code>init</code> function, which will be called before Then we create an <code>init</code> function, which will be called before
<code>main</code> at program initialization. The function <code>main</code> at program initialization. The function
<code>template.Must</code> is a convenience wrapper that panics when passed a <code>template.Must</code> is a convenience wrapper that panics when passed a
non-nil <code>os.Error</code> value, and otherwise returns the non-nil <code>error</code> value, and otherwise returns the
<code>*Template</code> unaltered. A panic is appropriate here; if the templates <code>*Template</code> unaltered. A panic is appropriate here; if the templates
can't be loaded the only sensible thing to do is exit the program. can't be loaded the only sensible thing to do is exit the program.
</p> </p>
@ -622,7 +622,7 @@ The function <code>regexp.MustCompile</code> will parse and compile the
regular expression, and return a <code>regexp.Regexp</code>. regular expression, and return a <code>regexp.Regexp</code>.
<code>MustCompile</code> is distinct from <code>Compile</code> in that it will <code>MustCompile</code> is distinct from <code>Compile</code> in that it will
panic if the expression compilation fails, while <code>Compile</code> returns panic if the expression compilation fails, while <code>Compile</code> returns
an <code>os.Error</code> as a second parameter. an <code>error</code> as a second parameter.
</p> </p>
<p> <p>

4
doc/debugging_with_gdb.html
View file

@ -288,8 +288,8 @@ The other goroutine, number 1, is stuck in <code>runtime.gosched</code>, blocked
#1 0x00000000004031c9 in runtime.chanrecv (c=void, ep=void, selected=void, received=void) #1 0x00000000004031c9 in runtime.chanrecv (c=void, ep=void, selected=void, received=void)
at /home/lvd/g/src/pkg/runtime/chan.c:342 at /home/lvd/g/src/pkg/runtime/chan.c:342
#2 0x0000000000403299 in runtime.chanrecv1 (t=void, c=void) at/home/lvd/g/src/pkg/runtime/chan.c:423 #2 0x0000000000403299 in runtime.chanrecv1 (t=void, c=void) at/home/lvd/g/src/pkg/runtime/chan.c:423
#3 0x000000000043075b in testing.RunTests (matchString={void (struct string, struct string, bool *, os.Error *)} 0x7ffff7f9ef60, tests= []testing.InternalTest = {...}) at /home/lvd/g/src/pkg/testing/testing.go:201 #3 0x000000000043075b in testing.RunTests (matchString={void (struct string, struct string, bool *, error *)} 0x7ffff7f9ef60, tests= []testing.InternalTest = {...}) at /home/lvd/g/src/pkg/testing/testing.go:201
#4 0x00000000004302b1 in testing.Main (matchString={void (struct string, struct string, bool *, os.Error *)} 0x7ffff7f9ef80, tests= []testing.InternalTest = {...}, benchmarks= []testing.InternalBenchmark = {...}) #4 0x00000000004302b1 in testing.Main (matchString={void (struct string, struct string, bool *, error *)} 0x7ffff7f9ef80, tests= []testing.InternalTest = {...}, benchmarks= []testing.InternalBenchmark = {...})
at /home/lvd/g/src/pkg/testing/testing.go:168 at /home/lvd/g/src/pkg/testing/testing.go:168
#5 0x0000000000400dc1 in main.main () at /home/lvd/g/src/pkg/regexp/_testmain.go:98 #5 0x0000000000400dc1 in main.main () at /home/lvd/g/src/pkg/regexp/_testmain.go:98
#6 0x00000000004022e7 in runtime.mainstart () at /home/lvd/g/src/pkg/runtime/amd64/asm.s:78 #6 0x00000000004022e7 in runtime.mainstart () at /home/lvd/g/src/pkg/runtime/amd64/asm.s:78

2
src/cmd/cgo/out.go
View file

@ -276,7 +276,7 @@ func (p *Package) writeDefsFunc(fc, fgo2 *os.File, n *Name) {
v[0] = 0; v[0] = 0;
v[1] = 0; v[1] = 0;
} else { } else {
·_Cerrno(v, e); /* fill in v as os.Error for errno e */ ·_Cerrno(v, e); /* fill in v as error for errno e */
} }
}`) }`)
} }

2
src/cmd/goinstall/main.go
View file

@ -304,7 +304,7 @@ func isStandardPath(s string) bool {
// run runs the command cmd in directory dir with standard input stdin. // run runs the command cmd in directory dir with standard input stdin.
// If the command fails, run prints the command and output on standard error // If the command fails, run prints the command and output on standard error
// in addition to returning a non-nil os.Error. // in addition to returning a non-nil error.
func run(dir string, stdin []byte, cmd ...string) error { func run(dir string, stdin []byte, cmd ...string) error {
return genRun(dir, stdin, cmd, false) return genRun(dir, stdin, cmd, false)
} }

36
src/cmd/govet/govet.go
View file

@ -232,23 +232,23 @@ type MethodSig struct {
// we let it go. But if it does have a fmt.ScanState, then the // we let it go. But if it does have a fmt.ScanState, then the
// rest has to match. // rest has to match.
var canonicalMethods = map[string]MethodSig{ var canonicalMethods = map[string]MethodSig{
// "Flush": {{}, {"os.Error"}}, // http.Flusher and jpeg.writer conflict // "Flush": {{}, {"error"}}, // http.Flusher and jpeg.writer conflict
"Format": {[]string{"=fmt.State", "rune"}, []string{}}, // fmt.Formatter "Format": {[]string{"=fmt.State", "rune"}, []string{}}, // fmt.Formatter
"GobDecode": {[]string{"[]byte"}, []string{"os.Error"}}, // gob.GobDecoder "GobDecode": {[]string{"[]byte"}, []string{"error"}}, // gob.GobDecoder
"GobEncode": {[]string{}, []string{"[]byte", "os.Error"}}, // gob.GobEncoder "GobEncode": {[]string{}, []string{"[]byte", "error"}}, // gob.GobEncoder
"MarshalJSON": {[]string{}, []string{"[]byte", "os.Error"}}, // json.Marshaler "MarshalJSON": {[]string{}, []string{"[]byte", "error"}}, // json.Marshaler
"MarshalXML": {[]string{}, []string{"[]byte", "os.Error"}}, // xml.Marshaler "MarshalXML": {[]string{}, []string{"[]byte", "error"}}, // xml.Marshaler
"Peek": {[]string{"=int"}, []string{"[]byte", "os.Error"}}, // image.reader (matching bufio.Reader) "Peek": {[]string{"=int"}, []string{"[]byte", "error"}}, // image.reader (matching bufio.Reader)
"ReadByte": {[]string{}, []string{"byte", "os.Error"}}, // io.ByteReader "ReadByte": {[]string{}, []string{"byte", "error"}}, // io.ByteReader
"ReadFrom": {[]string{"=io.Reader"}, []string{"int64", "os.Error"}}, // io.ReaderFrom "ReadFrom": {[]string{"=io.Reader"}, []string{"int64", "error"}}, // io.ReaderFrom
"ReadRune": {[]string{}, []string{"rune", "int", "os.Error"}}, // io.RuneReader "ReadRune": {[]string{}, []string{"rune", "int", "error"}}, // io.RuneReader
"Scan": {[]string{"=fmt.ScanState", "rune"}, []string{"os.Error"}}, // fmt.Scanner "Scan": {[]string{"=fmt.ScanState", "rune"}, []string{"error"}}, // fmt.Scanner
"Seek": {[]string{"=int64", "int"}, []string{"int64", "os.Error"}}, // io.Seeker "Seek": {[]string{"=int64", "int"}, []string{"int64", "error"}}, // io.Seeker
"UnmarshalJSON": {[]string{"[]byte"}, []string{"os.Error"}}, // json.Unmarshaler "UnmarshalJSON": {[]string{"[]byte"}, []string{"error"}}, // json.Unmarshaler
"UnreadByte": {[]string{}, []string{"os.Error"}}, "UnreadByte": {[]string{}, []string{"error"}},
"UnreadRune": {[]string{}, []string{"os.Error"}}, "UnreadRune": {[]string{}, []string{"error"}},
"WriteByte": {[]string{"byte"}, []string{"os.Error"}}, // jpeg.writer (matching bufio.Writer) "WriteByte": {[]string{"byte"}, []string{"error"}}, // jpeg.writer (matching bufio.Writer)
"WriteTo": {[]string{"=io.Writer"}, []string{"int64", "os.Error"}}, // io.WriterTo "WriteTo": {[]string{"=io.Writer"}, []string{"int64", "error"}}, // io.WriterTo
} }
func (f *File) checkMethod(id *ast.Ident, t *ast.FuncType) { func (f *File) checkMethod(id *ast.Ident, t *ast.FuncType) {
@ -560,11 +560,11 @@ type BadTypeUsedInTests struct {
X int "hello" // ERROR "struct field tag" X int "hello" // ERROR "struct field tag"
} }
func (t *BadTypeUsedInTests) Scan(x fmt.ScanState, c byte) { // ERROR "method Scan[(]x fmt.ScanState, c byte[)] should have signature Scan[(]fmt.ScanState, rune[)] os.Error" func (t *BadTypeUsedInTests) Scan(x fmt.ScanState, c byte) { // ERROR "method Scan[(]x fmt.ScanState, c byte[)] should have signature Scan[(]fmt.ScanState, rune[)] error"
} }
type BadInterfaceUsedInTests interface { type BadInterfaceUsedInTests interface {
ReadByte() byte // ERROR "method ReadByte[(][)] byte should have signature ReadByte[(][)] [(]byte, os.Error[)]" ReadByte() byte // ERROR "method ReadByte[(][)] byte should have signature ReadByte[(][)] [(]byte, error[)]"
} }
// printf is used by the test. // printf is used by the test.

2
src/pkg/compress/bzip2/bit_reader.go
View file

@ -10,7 +10,7 @@ import (
) )
// bitReader wraps an io.Reader and provides the ability to read values, // bitReader wraps an io.Reader and provides the ability to read values,
// bit-by-bit, from it. Its Read* methods don't return the usual os.Error // bit-by-bit, from it. Its Read* methods don't return the usual error
// because the error handling was verbose. Instead, any error is kept and can // because the error handling was verbose. Instead, any error is kept and can
// be checked afterwards. // be checked afterwards.
type bitReader struct { type bitReader struct {

3
src/pkg/crypto/rsa/rsa.go
View file

@ -55,8 +55,7 @@ type CRTValue struct {
} }
// Validate performs basic sanity checks on the key. // Validate performs basic sanity checks on the key.
// It returns nil if the key is valid, or else an os.Error describing a problem. // It returns nil if the key is valid, or else an error describing a problem.
func (priv *PrivateKey) Validate() error { func (priv *PrivateKey) Validate() error {
// Check that the prime factors are actually prime. Note that this is // Check that the prime factors are actually prime. Note that this is
// just a sanity check. Since the random witnesses chosen by // just a sanity check. Since the random witnesses chosen by

2
src/pkg/crypto/tls/conn.go
View file

@ -828,7 +828,7 @@ func (c *Conn) OCSPResponse() []byte {
} }
// VerifyHostname checks that the peer certificate chain is valid for // VerifyHostname checks that the peer certificate chain is valid for
// connecting to host. If so, it returns nil; if not, it returns an os.Error // connecting to host. If so, it returns nil; if not, it returns an error
// describing the problem. // describing the problem.
func (c *Conn) VerifyHostname(host string) error { func (c *Conn) VerifyHostname(host string) error {
c.handshakeMutex.Lock() c.handshakeMutex.Lock()

2
src/pkg/crypto/x509/verify.go
View file

@ -226,7 +226,7 @@ func matchHostnames(pattern, host string) bool {
} }
// VerifyHostname returns nil if c is a valid certificate for the named host. // VerifyHostname returns nil if c is a valid certificate for the named host.
// Otherwise it returns an os.Error describing the mismatch. // Otherwise it returns an error describing the mismatch.
func (c *Certificate) VerifyHostname(h string) error { func (c *Certificate) VerifyHostname(h string) error {
if len(c.DNSNames) > 0 { if len(c.DNSNames) > 0 {
for _, match := range c.DNSNames { for _, match := range c.DNSNames {

2
src/pkg/exp/ssh/channel.go
View file

@ -20,7 +20,7 @@ type Channel interface {
// peer is likely to signal a protocol error and drop the connection. // peer is likely to signal a protocol error and drop the connection.
Reject(reason RejectionReason, message string) error Reject(reason RejectionReason, message string) error
// Read may return a ChannelRequest as an os.Error. // Read may return a ChannelRequest as an error.
Read(data []byte) (int, error) Read(data []byte) (int, error)
Write(data []byte) (int, error) Write(data []byte) (int, error)
Close() error Close() error

2
src/pkg/exp/types/gcimporter.go
View file

@ -188,7 +188,7 @@ func (p *gcParser) error(err interface{}) {
if s, ok := err.(string); ok { if s, ok := err.(string); ok {
err = errors.New(s) err = errors.New(s)
} }
// panic with a runtime.Error if err is not an os.Error // panic with a runtime.Error if err is not an error
panic(importError{p.scanner.Pos(), err.(error)}) panic(importError{p.scanner.Pos(), err.(error)})
} }

2
src/pkg/fmt/print.go
View file

@ -198,7 +198,7 @@ func Sprintf(format string, a ...interface{}) string {
} }
// Errorf formats according to a format specifier and returns the string // Errorf formats according to a format specifier and returns the string
// as a value that satisfies os.Error. // as a value that satisfies error.
func Errorf(format string, a ...interface{}) error { func Errorf(format string, a ...interface{}) error {
return errors.New(Sprintf(format, a...)) return errors.New(Sprintf(format, a...))
} }

2
src/pkg/go/ast/print.go
View file

@ -114,7 +114,7 @@ func (p *printer) Write(data []byte) (n int, err error) {
return return
} }
// localError wraps locally caught os.Errors so we can distinguish // localError wraps locally caught errors so we can distinguish
// them from genuine panics which we don't want to return as errors. // them from genuine panics which we don't want to return as errors.
type localError struct { type localError struct {
err error err error

2
src/pkg/go/printer/printer.go
View file

@ -54,7 +54,7 @@ const (
noExtraLinebreak noExtraLinebreak
) )
// local error wrapper so we can distinguish os.Errors we want to return // local error wrapper so we can distinguish errors we want to return
// as errors from genuine panics (which we don't want to return as errors) // as errors from genuine panics (which we don't want to return as errors)
type osError struct { type osError struct {
err error err error

4
src/pkg/go/scanner/errors.go
View file

@ -135,8 +135,8 @@ func (h *ErrorVector) GetErrorList(mode int) ErrorList {
return list return list
} }
// GetError is like GetErrorList, but it returns an os.Error instead // GetError is like GetErrorList, but it returns an error instead
// so that a nil result can be assigned to an os.Error variable and // so that a nil result can be assigned to an error variable and
// remains nil. // remains nil.
// //
func (h *ErrorVector) GetError(mode int) error { func (h *ErrorVector) GetError(mode int) error {

10
src/pkg/gob/error.go
View file

@ -9,16 +9,16 @@ import "fmt"
// Errors in decoding and encoding are handled using panic and recover. // Errors in decoding and encoding are handled using panic and recover.
// Panics caused by user error (that is, everything except run-time panics // Panics caused by user error (that is, everything except run-time panics
// such as "index out of bounds" errors) do not leave the file that caused // such as "index out of bounds" errors) do not leave the file that caused
// them, but are instead turned into plain os.Error returns. Encoding and // them, but are instead turned into plain error returns. Encoding and
// decoding functions and methods that do not return an os.Error either use // decoding functions and methods that do not return an error either use
// panic to report an error or are guaranteed error-free. // panic to report an error or are guaranteed error-free.
// A gobError wraps an os.Error and is used to distinguish errors (panics) generated in this package. // A gobError is used to distinguish errors (panics) generated in this package.
type gobError struct { type gobError struct {
err error err error
} }
// errorf is like error but takes Printf-style arguments to construct an os.Error. // errorf is like error_ but takes Printf-style arguments to construct an error.
// It always prefixes the message with "gob: ". // It always prefixes the message with "gob: ".
func errorf(format string, args ...interface{}) { func errorf(format string, args ...interface{}) {
error_(fmt.Errorf("gob: "+format, args...)) error_(fmt.Errorf("gob: "+format, args...))
@ -30,7 +30,7 @@ func error_(err error) {
} }
// catchError is meant to be used as a deferred function to turn a panic(gobError) into a // catchError is meant to be used as a deferred function to turn a panic(gobError) into a
// plain os.Error. It overwrites the error return of the function that deferred its call. // plain error. It overwrites the error return of the function that deferred its call.
func catchError(err *error) { func catchError(err *error) {
if e := recover(); e != nil { if e := recover(); e != nil {
*err = e.(gobError).err // Will re-panic if not one of our errors, such as a runtime error. *err = e.(gobError).err // Will re-panic if not one of our errors, such as a runtime error.

2
src/pkg/old/netchan/import.go
View file

@ -186,7 +186,7 @@ func (imp *Importer) Import(name string, chT interface{}, dir Dir, size int) err
// The channel to be bound to the remote site's channel is provided // The channel to be bound to the remote site's channel is provided
// in the call and may be of arbitrary channel type. // in the call and may be of arbitrary channel type.
// Despite the literal signature, the effective signature is // Despite the literal signature, the effective signature is
// ImportNValues(name string, chT chan T, dir Dir, size, n int) os.Error // ImportNValues(name string, chT chan T, dir Dir, size, n int) error
// Example usage: // Example usage:
// imp, err := NewImporter("tcp", "netchanserver.mydomain.com:1234") // imp, err := NewImporter("tcp", "netchanserver.mydomain.com:1234")
// if err != nil { log.Fatal(err) } // if err != nil { log.Fatal(err) }

4
src/pkg/os/dir_plan9.go
View file

@ -22,7 +22,7 @@ import (
// If n <= 0, Readdir returns all the FileInfo from the directory in // If n <= 0, Readdir returns all the FileInfo from the directory in
// a single slice. In this case, if Readdir succeeds (reads all // 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 // the way to the end of the directory), it returns the slice and a
// nil os.Error. If it encounters an error before the end of the // nil error. If it encounters an error before the end of the
// directory, Readdir returns the FileInfo read until that point // directory, Readdir returns the FileInfo read until that point
// and a non-nil error. // and a non-nil error.
func (file *File) Readdir(n int) (fi []FileInfo, err error) { func (file *File) Readdir(n int) (fi []FileInfo, err error) {
@ -87,7 +87,7 @@ func (file *File) Readdir(n int) (fi []FileInfo, err error) {
// If n <= 0, Readdirnames returns all the names from the directory in // If n <= 0, Readdirnames returns all the names from the directory in
// a single slice. In this case, if Readdirnames succeeds (reads all // 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 // the way to the end of the directory), it returns the slice and a
// nil os.Error. If it encounters an error before the end of the // nil error. If it encounters an error before the end of the
// directory, Readdirnames returns the names read until that point and // directory, Readdirnames returns the names read until that point and
// a non-nil error. // a non-nil error.
func (file *File) Readdirnames(n int) (names []string, err error) { func (file *File) Readdirnames(n int) (names []string, err error) {

2
src/pkg/os/dir_unix.go
View file

@ -24,7 +24,7 @@ const (
// If n <= 0, Readdirnames returns all the names from the directory in // If n <= 0, Readdirnames returns all the names from the directory in
// a single slice. In this case, if Readdirnames succeeds (reads all // 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 // the way to the end of the directory), it returns the slice and a
// nil os.Error. If it encounters an error before the end of the // nil error. If it encounters an error before the end of the
// directory, Readdirnames returns the names read until that point and // directory, Readdirnames returns the names read until that point and
// a non-nil error. // a non-nil error.
func (f *File) Readdirnames(n int) (names []string, err error) { func (f *File) Readdirnames(n int) (names []string, err error) {

2
src/pkg/os/file_unix.go
View file

@ -141,7 +141,7 @@ func Lstat(name string) (fi *FileInfo, err error) {
// If n <= 0, Readdir returns all the FileInfo from the directory in // If n <= 0, Readdir returns all the FileInfo from the directory in
// a single slice. In this case, if Readdir succeeds (reads all // 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 // the way to the end of the directory), it returns the slice and a
// nil os.Error. If it encounters an error before the end of the // nil error. If it encounters an error before the end of the
// directory, Readdir returns the FileInfo read until that point // directory, Readdir returns the FileInfo read until that point
// and a non-nil error. // and a non-nil error.
func (file *File) Readdir(n int) (fi []FileInfo, err error) { func (file *File) Readdir(n int) (fi []FileInfo, err error) {

2
src/pkg/os/file_windows.go
View file

@ -131,7 +131,7 @@ func (file *File) Close() error {
// If n <= 0, Readdir returns all the FileInfo from the directory in // If n <= 0, Readdir returns all the FileInfo from the directory in
// a single slice. In this case, if Readdir succeeds (reads all // 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 // the way to the end of the directory), it returns the slice and a
// nil os.Error. If it encounters an error before the end of the // nil error. If it encounters an error before the end of the
// directory, Readdir returns the FileInfo read until that point // directory, Readdir returns the FileInfo read until that point
// and a non-nil error. // and a non-nil error.
func (file *File) Readdir(n int) (fi []FileInfo, err error) { func (file *File) Readdir(n int) (fi []FileInfo, err error) {

2
src/pkg/regexp/all_test.go
View file

@ -32,7 +32,7 @@ var good_re = []string{
/* /*
type stringError struct { type stringError struct {
re string re string
err os.Error err error
} }
var bad_re = []stringError{ var bad_re = []stringError{

2
src/pkg/rpc/debug.go
View file

@ -27,7 +27,7 @@ const debugText = `<html>
<th align=center>Method</th><th align=center>Calls</th> <th align=center>Method</th><th align=center>Calls</th>
{{range .Method}} {{range .Method}}
<tr> <tr>
<td align=left font=fixed>{{.Name}}({{.Type.ArgType}}, {{.Type.ReplyType}}) os.Error</td> <td align=left font=fixed>{{.Name}}({{.Type.ArgType}}, {{.Type.ReplyType}}) error</td>
<td align=center>{{.Type.NumCalls}}</td> <td align=center>{{.Type.NumCalls}}</td>
</tr> </tr>
{{end}} {{end}}

25
src/pkg/rpc/server.go
View file

@ -18,12 +18,12 @@
registering the service). registering the service).
- the method has two arguments, both exported or local types. - the method has two arguments, both exported or local types.
- the method's second argument is a pointer. - the method's second argument is a pointer.
- the method has return type os.Error. - the method has return type error.
The method's first argument represents the arguments provided by the caller; the The method's first argument represents the arguments provided by the caller; the
second argument represents the result parameters to be returned to the caller. second argument represents the result parameters to be returned to the caller.
The method's return value, if non-nil, is passed back as a string that the client The method's return value, if non-nil, is passed back as a string that the client
sees as an os.ErrorString. sees as if created by errors.New.
The server may handle requests on a single connection by calling ServeConn. More The server may handle requests on a single connection by calling ServeConn. More
typically it will create a network listener and call Accept or, for an HTTP typically it will create a network listener and call Accept or, for an HTTP
@ -55,14 +55,14 @@
type Arith int type Arith int
func (t *Arith) Multiply(args *Args, reply *int) os.Error { func (t *Arith) Multiply(args *Args, reply *int) error {
*reply = args.A * args.B *reply = args.A * args.B
return nil return nil
} }
func (t *Arith) Divide(args *Args, quo *Quotient) os.Error { func (t *Arith) Divide(args *Args, quo *Quotient) error {
if args.B == 0 { if args.B == 0 {
return os.ErrorString("divide by zero") return errors.New("divide by zero")
} }
quo.Quo = args.A / args.B quo.Quo = args.A / args.B
quo.Rem = args.A % args.B quo.Rem = args.A % args.B
@ -133,10 +133,9 @@ const (
DefaultDebugPath = "/debug/rpc" DefaultDebugPath = "/debug/rpc"
) )
// Precompute the reflect type for os.Error. Can't use os.Error directly // Precompute the reflect type for error. Can't use error directly
// because Typeof takes an empty interface value. This is annoying. // because Typeof takes an empty interface value. This is annoying.
var unusedError *error var typeOfError = reflect.TypeOf((*error)(nil)).Elem()
var typeOfOsError = reflect.TypeOf(unusedError).Elem()
type methodType struct { type methodType struct {
sync.Mutex // protects counters sync.Mutex // protects counters
@ -210,7 +209,7 @@ func isExportedOrBuiltinType(t reflect.Type) bool {
// receiver value that satisfy the following conditions: // receiver value that satisfy the following conditions:
// - exported method // - exported method
// - two arguments, both pointers to exported structs // - two arguments, both pointers to exported structs
// - one return value, of type os.Error // - one return value, of type error
// It returns an error if the receiver is not an exported type or has no // It returns an error if the receiver is not an exported type or has no
// suitable methods. // suitable methods.
// The client accesses each method using a string of the form "Type.Method", // The client accesses each method using a string of the form "Type.Method",
@ -281,13 +280,13 @@ func (server *Server) register(rcvr interface{}, name string, useName bool) erro
log.Println("method", mname, "reply type not exported or local:", replyType) log.Println("method", mname, "reply type not exported or local:", replyType)
continue continue
} }
// Method needs one out: os.Error. // Method needs one out: error.
if mtype.NumOut() != 1 { if mtype.NumOut() != 1 {
log.Println("method", mname, "has wrong number of outs:", mtype.NumOut()) log.Println("method", mname, "has wrong number of outs:", mtype.NumOut())
continue continue
} }
if returnType := mtype.Out(0); returnType != typeOfOsError { if returnType := mtype.Out(0); returnType != typeOfError {
log.Println("method", mname, "returns", returnType.String(), "not os.Error") log.Println("method", mname, "returns", returnType.String(), "not error")
continue continue
} }
s.method[mname] = &methodType{method: method, ArgType: argType, ReplyType: replyType} s.method[mname] = &methodType{method: method, ArgType: argType, ReplyType: replyType}
@ -339,7 +338,7 @@ func (s *service) call(server *Server, sending *sync.Mutex, mtype *methodType, r
function := mtype.method.Func function := mtype.method.Func
// Invoke the method, providing a new value for the reply. // Invoke the method, providing a new value for the reply.
returnValues := function.Call([]reflect.Value{s.rcvr, argv, replyv}) returnValues := function.Call([]reflect.Value{s.rcvr, argv, replyv})
// The return value for the method is an os.Error. // The return value for the method is an error.
errInter := returnValues[0].Interface() errInter := returnValues[0].Interface()
errmsg := "" errmsg := ""
if errInter != nil { if errInter != nil {

2
src/pkg/runtime/error.go
View file

@ -10,7 +10,7 @@ type Error interface {
// RuntimeError is a no-op function but // RuntimeError is a no-op function but
// serves to distinguish types that are runtime // serves to distinguish types that are runtime
// errors from ordinary os.Errors: a type is a // errors from ordinary errors: a type is a
// runtime error if it has a RuntimeError method. // runtime error if it has a RuntimeError method.
RuntimeError() RuntimeError()
} }

4
src/pkg/smtp/auth.go
View file

@ -13,7 +13,7 @@ type Auth interface {
// and optionally data to include in the initial AUTH message // and optionally data to include in the initial AUTH message
// sent to the server. It can return proto == "" to indicate // sent to the server. It can return proto == "" to indicate
// that the authentication should be skipped. // that the authentication should be skipped.
// If it returns a non-nil os.Error, the SMTP client aborts // If it returns a non-nil error, the SMTP client aborts
// the authentication attempt and closes the connection. // the authentication attempt and closes the connection.
Start(server *ServerInfo) (proto string, toServer []byte, err error) Start(server *ServerInfo) (proto string, toServer []byte, err error)
@ -21,7 +21,7 @@ type Auth interface {
// the fromServer data. If more is true, the server expects a // the fromServer data. If more is true, the server expects a
// response, which Next should return as toServer; otherwise // response, which Next should return as toServer; otherwise
// Next should return toServer == nil. // Next should return toServer == nil.
// If Next returns a non-nil os.Error, the SMTP client aborts // If Next returns a non-nil error, the SMTP client aborts
// the authentication attempt and closes the connection. // the authentication attempt and closes the connection.
Next(fromServer []byte, more bool) (toServer []byte, err error) Next(fromServer []byte, more bool) (toServer []byte, err error)
} }

2
src/pkg/tabwriter/tabwriter.go
View file

@ -212,7 +212,7 @@ func (b *Writer) dump() {
print("\n") print("\n")
} }
// local error wrapper so we can distinguish os.Errors we want to return // local error wrapper so we can distinguish errors we want to return
// as errors from genuine panics (which we don't want to return as errors) // as errors from genuine panics (which we don't want to return as errors)
type osError struct { type osError struct {
err error err error

4
src/pkg/template/doc.go
View file

@ -117,7 +117,7 @@ An argument is a simple value, denoted by one of the following.
.Method .Method
The result is the value of invoking the method with dot as the The result is the value of invoking the method with dot as the
receiver, dot.Method(). Such a method must have one return value (of receiver, dot.Method(). Such a method must have one return value (of
any type) or two return values, the second of which is an os.Error. any type) or two return values, the second of which is an error.
If it has two and the returned error is non-nil, execution terminates If it has two and the returned error is non-nil, execution terminates
and an error is returned to the caller as the value of Execute. and an error is returned to the caller as the value of Execute.
Method invocations may be chained and combined with fields and keys Method invocations may be chained and combined with fields and keys
@ -159,7 +159,7 @@ passed as the last argument of the following command. The output of the final
command in the pipeline is the value of the pipeline. command in the pipeline is the value of the pipeline.
The output of a command will be either one value or two values, the second of The output of a command will be either one value or two values, the second of
which has type os.Error. If that second value is present and evaluates to which has type error. If that second value is present and evaluates to
non-nil, execution terminates and the error is returned to the caller of non-nil, execution terminates and the error is returned to the caller of
Execute. Execute.

2
src/pkg/template/exec.go
View file

@ -492,7 +492,7 @@ func (s *state) evalCall(dot, fun reflect.Value, name string, args []parse.Node,
argv[i] = final argv[i] = final
} }
result := fun.Call(argv) result := fun.Call(argv)
// If we have an os.Error that is not nil, stop execution and return that error to the caller. // If we have an error that is not nil, stop execution and return that error to the caller.
if len(result) == 2 && !result[1].IsNil() { if len(result) == 2 && !result[1].IsNil() {
s.errorf("error calling %s: %s", name, result[1].Interface().(error)) s.errorf("error calling %s: %s", name, result[1].Interface().(error))
} }

2
src/pkg/template/exec_test.go
View file

@ -158,7 +158,7 @@ func (t *T) MSort(m map[string]int) []string {
return keys return keys
} }
// EPERM returns a value and an os.Error according to its argument. // EPERM returns a value and an error according to its argument.
func (t *T) EPERM(error bool) (bool, error) { func (t *T) EPERM(error bool) (bool, error) {
if error { if error {
return true, os.EPERM return true, os.EPERM

4
src/pkg/template/funcs.go
View file

@ -17,7 +17,7 @@ import (
// FuncMap is the type of the map defining the mapping from names to functions. // FuncMap is the type of the map defining the mapping from names to functions.
// Each function must have either a single return value, or two return values of // Each function must have either a single return value, or two return values of
// which the second has type os.Error. If the second argument evaluates to non-nil // which the second has type error. If the second argument evaluates to non-nil
// during execution, execution terminates and Execute returns an error. // during execution, execution terminates and Execute returns an error.
type FuncMap map[string]interface{} type FuncMap map[string]interface{}
@ -68,7 +68,7 @@ func addFuncs(out, in FuncMap) {
// goodFunc checks that the function or method has the right result signature. // goodFunc checks that the function or method has the right result signature.
func goodFunc(typ reflect.Type) bool { func goodFunc(typ reflect.Type) bool {
// We allow functions with 1 result or 2 results where the second is an os.Error. // We allow functions with 1 result or 2 results where the second is an error.
switch { switch {
case typ.NumOut() == 1: case typ.NumOut() == 1:
return true return true

4
src/pkg/template/helper.go
View file

@ -14,7 +14,7 @@ import (
// Functions and methods to parse a single template. // Functions and methods to parse a single template.
// Must is a helper that wraps a call to a function returning (*Template, os.Error) // Must is a helper that wraps a call to a function returning (*Template, error)
// and panics if the error is non-nil. It is intended for use in variable initializations // and panics if the error is non-nil. It is intended for use in variable initializations
// such as // such as
// var t = template.Must(template.New("name").Parse("text")) // var t = template.Must(template.New("name").Parse("text"))
@ -66,7 +66,7 @@ func (t *Template) parseFileInSet(filename string, set *Set) (*Template, error)
// Functions and methods to parse a set. // Functions and methods to parse a set.
// SetMust is a helper that wraps a call to a function returning (*Set, os.Error) // SetMust is a helper that wraps a call to a function returning (*Set, error)
// and panics if the error is non-nil. It is intended for use in variable initializations // and panics if the error is non-nil. It is intended for use in variable initializations
// such as // such as
// var s = template.SetMust(template.ParseSetFiles("file")) // var s = template.SetMust(template.ParseSetFiles("file"))

20
src/pkg/utf8/string.go
View file

@ -4,6 +4,8 @@
package utf8 package utf8
import "errors"
// String wraps a regular string with a small structure that provides more // String wraps a regular string with a small structure that provides more
// efficient indexing by code point index, as opposed to byte index. // efficient indexing by code point index, as opposed to byte index.
// Scanning incrementally forwards or backwards is O(1) per index operation // Scanning incrementally forwards or backwards is O(1) per index operation
@ -193,19 +195,5 @@ func (s *String) At(i int) rune {
return r return r
} }
// We want the panic in At(i) to satisfy os.Error, because that's what var outOfRange = errors.New("utf8.String: index out of range")
// runtime panics satisfy, but we can't import os. This is our solution. var sliceOutOfRange = errors.New("utf8.String: slice index out of range")
// error is the type of the error returned if a user calls String.At(i) with i out of range.
// It satisfies os.Error and runtime.Error.
type error_ string
func (err error_) String() string {
return string(err)
}
func (err error_) RunTimeError() {
}
var outOfRange = error_("utf8.String: index out of range")
var sliceOutOfRange = error_("utf8.String: slice index out of range")