func Code(err error) codes.Code
Code returns the Code of the error if it is a Status error or if it wraps a Status error. If that is not the case, it returns codes.OK if err is nil, or codes.Unknown otherwise.
func Error(c codes.Code, msg string) error
Error returns an error representing c and msg. If c is OK, returns nil.
func ErrorProto(s *spb.Status) error
ErrorProto returns an error representing s. If s.Code is OK, returns nil.
func Errorf(c codes.Code, format string, a ...any) error
Errorf returns Error(c, fmt.Sprintf(format, a...)).
Status references google.golang.org/grpc/internal/status. It represents an RPC status code, message, and details. It is immutable and should be created with New, Newf, or FromProto. https://godoc.org/google.golang.org/grpc/internal/status
type Status = status.Status
func Convert(err error) *Status
Convert is a convenience function which removes the need to handle the boolean return value from FromError.
func FromContextError(err error) *Status
FromContextError converts a context error or wrapped context error into a Status. It returns a Status with codes.OK if err is nil, or a Status with codes.Unknown if err is non-nil and not a context error.
func FromError(err error) (s *Status, ok bool)
FromError returns a Status representation of err.
If err was produced by this package or implements the method `GRPCStatus() *Status` and `GRPCStatus()` does not return nil, or if err wraps a type satisfying this, the Status from `GRPCStatus()` is returned. For wrapped errors, the message returned contains the entire err.Error() text and not just the wrapped status. In that case, ok is true.
If err is nil, a Status is returned with codes.OK and no message, and ok is true.
If err implements the method `GRPCStatus() *Status` and `GRPCStatus()` returns nil (which maps to Codes.OK), or if err wraps a type satisfying this, a Status is returned with codes.Unknown and err's Error() message, and ok is false.
Otherwise, err is an error not compatible with this package. In this case, a Status is returned with codes.Unknown and err's Error() message, and ok is false.
func FromProto(s *spb.Status) *Status
FromProto returns a Status representing s.
func New(c codes.Code, msg string) *Status
New returns a Status representing c and msg.
func Newf(c codes.Code, format string, a ...any) *Status
Newf returns New(c, fmt.Sprintf(format, a...)).