errors

Documentation

Overview

Package errors implements functions to manipulate errors.

Example (StackTraceFormatting)

package main

import (
	"fmt"

	"github.com/komuw/ong/errors"
)

const expectedUser = "admin"

func login(user string) error {
	if user == expectedUser {
		return nil
	}

	return errors.New("invalid user")
}

func main() {
	err := login("badGuy")
	fmt.Printf("%+v", err)
}

Index

• func New(text string) error
• func StackTrace(err error) string
• func Wrap(err error) error

Examples

• Package (StackTraceFormatting)

Functions

func New

func New(text string) error

New returns an error with the supplied message. It also records the stack trace at the point it was called.

Error values implement fmt.Formatter and can be formatted by the fmt package. The following verbs are supported:

%s   print the error.
%v   see %s
%+v  print the error and stacktrace.

func StackTrace

func StackTrace(err error) string

StackTrace returns the stack trace contained in err, if any, else an empty string.

func Wrap

func Wrap(err error) error

Wrap returns err, capturing a stack trace.