errs

README

サンプルリスト

このディレクトリには以下のサンプルがあります。

file	example name	note
error_basic.go	error_basic	error のハンドリングについてのサンプル
error_sentinel.go	error_sentinel	Goにおけるエラー処理イディオムの sentinel error check についてのサンプルです.
error_typeassertion.go	error_typeassertion	Goにおけるエラー処理イディオムの type assertion check についてのサンプルです.
error_wrap_unwrap.go	error_wrap_unwrap	Goにおけるエラー処理にてエラーを内包するやり方についてのサンプルです。
error_is_and_as.go	error_is_and_as	errors.Is(), errors.As() のサンプルです。
error_wrap_multiple_error.go	error_wrap_multiple_error	Go 1.20 で導入された %w を複数指定できるようになった機能のサンプルです。

Documentation

Overview

Package errs -- エラーについてのサンプルが配置されているパッケージです。

Index

• Variables
• func Basic() error
• func ErrorJoin() error
• func ErrorJoinErrorsAs() error
• func ErrorJoinFmtErrorf() error
• func IsAndAs() error
• func NewRegister() mapping.Register
• func Sentinel() error
• func TypeAssertion() error
• func WrapAndUnwrap() error
• func WrapMultipleError() error
• type MyError1
  • func (me MyError1) Error() string
• type MyError2
  • func (me MyError2) Error() string
• type MyError3
  • func (me MyError3) Error() string
• type TypeAssertionError
  • func (t *TypeAssertionError) Error() string
• type WrapError
  • func (w *WrapError) Error() string
  • func (w *WrapError) Unwrap() error

Variables

var (
	// ErrSentinel -- sentinel error check
	ErrSentinel = errors.New("example: sentinel error check")
)

Functions

func Basic

func Basic() error

Basic -- error のハンドリングについてのサンプル REFERENCES::

• https://github.com/robpike/ivy/blob/master/ivy_test.go
• https://stackoverflow.com/questions/9371031/how-do-i-create-crossplatform-file-paths-in-go
• https://qiita.com/andromeda/items/c5195307cd08537d4fad

func ErrorJoin

func ErrorJoin() error

ErrorJoin は、Go 1.20 で追加された errors.Join のサンプルです.

Go 1.20 で、errors.Join が追加され、複数のエラーを纏めて一つに することが標準ライブラリで出来るようになった.

REFERENCES

• https://pkg.go.dev/errors@go1.20.1#Join

func ErrorJoinErrorsAs

func ErrorJoinErrorsAs() error

ErrorJoinErrorsAs は、Go1.20から追加された errors.Join() と errors.As() の関係性についてのサンプルです.

func ErrorJoinFmtErrorf

func ErrorJoinFmtErrorf() error

ErrorJoinFmtErrorf は、Go1.20から追加された複数エラーを纏める機能が追加されたfmt.Errorfのサンプルです.

func IsAndAs

func IsAndAs() error

IsAndAs -- errors.Is(), errors.As() のサンプルです。

REFERENCES

• https://pkg.go.dev/errors@go1.19
• https://zenn.dev/msksgm/articles/20220325-unwrap-errors-is-as

func NewRegister

func NewRegister() mapping.Register

NewRegister -- このパッケージ用のサンプルを登録する mapping.Register を生成します。

func Sentinel

func Sentinel() error

Sentinel は、Goにおけるエラー処理イディオムの sentinel error check についてのサンプルです. REFERENCES::

• https://medium.com/onefootball-locker-room/a-look-at-go-1-13-errors-9f6c9f6accb6

func TypeAssertion

func TypeAssertion() error

TypeAssertion は、Goにおけるエラー処理イディオムの type assertion check についてのサンプルです. REFERENCES::

• https://medium.com/onefootball-locker-room/a-look-at-go-1-13-errors-9f6c9f6accb6

func WrapAndUnwrap

func WrapAndUnwrap() error

WrapAndUnwrap は、Goにおけるエラー処理にてエラーを内包するやり方についてのサンプルです。 REFERENCES::

• https://medium.com/onefootball-locker-room/a-look-at-go-1-13-errors-9f6c9f6accb6

func WrapMultipleError

func WrapMultipleError() error

WrapMultipleError は、Go 1.20 で導入された %w を複数指定できるようになった機能のサンプルです。

REFERENCES

• https://future-architect.github.io/articles/20230126a/
• https://tip.golang.org/doc/go1.20#errors

Types

type MyError1

type MyError1 struct {
	Message string
	Code    int
}

func (MyError1) Error

func (me MyError1) Error() string

type MyError2

type MyError2 struct {
	Message string
	Code    int
}

func (MyError2) Error

func (me MyError2) Error() string

type MyError3

type MyError3 struct {
	Message string
	Code    int
}

func (MyError3) Error

func (me MyError3) Error() string

type TypeAssertionError

type TypeAssertionError struct{}

TypeAssertionError -- type assertion check

func (*TypeAssertionError) Error

func (t *TypeAssertionError) Error() string

type WrapError

type WrapError struct {
	InnerError error
}

WrapError -- wrap error object

func (*WrapError) Error

func (w *WrapError) Error() string

func (*WrapError) Unwrap

func (w *WrapError) Unwrap() error

Unwrap -- 内包しているエラーを返します。