github.com/tcnksm/go@v0.0.0-20141208075154-439b32936367/src/go/scanner/errors.go (about)

     1  // Copyright 2009 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  package scanner
     6  
     7  import (
     8  	"fmt"
     9  	"go/token"
    10  	"io"
    11  	"sort"
    12  )
    13  
    14  // In an ErrorList, an error is represented by an *Error.
    15  // The position Pos, if valid, points to the beginning of
    16  // the offending token, and the error condition is described
    17  // by Msg.
    18  //
    19  type Error struct {
    20  	Pos token.Position
    21  	Msg string
    22  }
    23  
    24  // Error implements the error interface.
    25  func (e Error) Error() string {
    26  	if e.Pos.Filename != "" || e.Pos.IsValid() {
    27  		// don't print "<unknown position>"
    28  		// TODO(gri) reconsider the semantics of Position.IsValid
    29  		return e.Pos.String() + ": " + e.Msg
    30  	}
    31  	return e.Msg
    32  }
    33  
    34  // ErrorList is a list of *Errors.
    35  // The zero value for an ErrorList is an empty ErrorList ready to use.
    36  //
    37  type ErrorList []*Error
    38  
    39  // Add adds an Error with given position and error message to an ErrorList.
    40  func (p *ErrorList) Add(pos token.Position, msg string) {
    41  	*p = append(*p, &Error{pos, msg})
    42  }
    43  
    44  // Reset resets an ErrorList to no errors.
    45  func (p *ErrorList) Reset() { *p = (*p)[0:0] }
    46  
    47  // ErrorList implements the sort Interface.
    48  func (p ErrorList) Len() int      { return len(p) }
    49  func (p ErrorList) Swap(i, j int) { p[i], p[j] = p[j], p[i] }
    50  
    51  func (p ErrorList) Less(i, j int) bool {
    52  	e := &p[i].Pos
    53  	f := &p[j].Pos
    54  	// Note that it is not sufficient to simply compare file offsets because
    55  	// the offsets do not reflect modified line information (through //line
    56  	// comments).
    57  	if e.Filename < f.Filename {
    58  		return true
    59  	}
    60  	if e.Filename == f.Filename {
    61  		if e.Line < f.Line {
    62  			return true
    63  		}
    64  		if e.Line == f.Line {
    65  			return e.Column < f.Column
    66  		}
    67  	}
    68  	return false
    69  }
    70  
    71  // Sort sorts an ErrorList. *Error entries are sorted by position,
    72  // other errors are sorted by error message, and before any *Error
    73  // entry.
    74  //
    75  func (p ErrorList) Sort() {
    76  	sort.Sort(p)
    77  }
    78  
    79  // RemoveMultiples sorts an ErrorList and removes all but the first error per line.
    80  func (p *ErrorList) RemoveMultiples() {
    81  	sort.Sort(p)
    82  	var last token.Position // initial last.Line is != any legal error line
    83  	i := 0
    84  	for _, e := range *p {
    85  		if e.Pos.Filename != last.Filename || e.Pos.Line != last.Line {
    86  			last = e.Pos
    87  			(*p)[i] = e
    88  			i++
    89  		}
    90  	}
    91  	(*p) = (*p)[0:i]
    92  }
    93  
    94  // An ErrorList implements the error interface.
    95  func (p ErrorList) Error() string {
    96  	switch len(p) {
    97  	case 0:
    98  		return "no errors"
    99  	case 1:
   100  		return p[0].Error()
   101  	}
   102  	return fmt.Sprintf("%s (and %d more errors)", p[0], len(p)-1)
   103  }
   104  
   105  // Err returns an error equivalent to this error list.
   106  // If the list is empty, Err returns nil.
   107  func (p ErrorList) Err() error {
   108  	if len(p) == 0 {
   109  		return nil
   110  	}
   111  	return p
   112  }
   113  
   114  // PrintError is a utility function that prints a list of errors to w,
   115  // one error per line, if the err parameter is an ErrorList. Otherwise
   116  // it prints the err string.
   117  //
   118  func PrintError(w io.Writer, err error) {
   119  	if list, ok := err.(ErrorList); ok {
   120  		for _, e := range list {
   121  			fmt.Fprintf(w, "%s\n", e)
   122  		}
   123  	} else if err != nil {
   124  		fmt.Fprintf(w, "%s\n", err)
   125  	}
   126  }