package status

Import Path
	google.golang.org/grpc/internal/status (on go.dev)

Dependency Relation
	imports 6 packages, and imported by one package

Involved Source Files

	   d➜ status.go
		Package status implements errors returned by gRPC.  These errors are
		serialized and transmitted on the wire between server and client, and allow
		for additional data to be transmitted via the Details field in the status
		proto.  gRPC service handlers should return an error created by this
		package, and gRPC clients should expect a corresponding error to be
		returned from the RPC call.

		This package upholds the invariants that a non-nil error may not
		contain an OK code, and an OK code must result in a nil error.
Package-Level Type Names (total 2, both are exported)

	/* sort exporteds by: alphabet | popularity */
	 type Error (struct)
		Error wraps a pointer of a status proto. It implements error and Status,
		and a nil *Error should never be returned by this package.

		Fields (only one, which is unexported)
			/* one unexported ... *//* one unexported: */
			e *spb.Status
		Methods (total 3, all are exported)
			(*T) Error() string
			(*T) GRPCStatus() *Status
				GRPCStatus returns the Status represented by se.

			(*T) Is(target error) bool
				Is implements future error.Is functionality.
				A Error is equivalent if the code and message are identical.

		Implements (at least one exported)
			*T : error

	 type Status (struct)
		Status represents an RPC status code, message, and details.  It is immutable
		and should be created with New, Newf, or FromProto.

		Fields (only one, which is unexported)
			/* one unexported ... *//* one unexported: */
			s *spb.Status
		Methods (total 6, all are exported)
			(*T) Code() codes.Code
				Code returns the status code contained in s.

			(*T) Details() []interface{}
				Details returns a slice of details messages attached to the status.
				If a detail cannot be decoded, the error is returned in place of the detail.

			(*T) Err() error
				Err returns an immutable error representing s; returns nil if s.Code() is OK.

			(*T) Message() string
				Message returns the message contained in s.

			(*T) Proto() *spb.Status
				Proto returns s's status as an spb.Status proto message.

			(*T) WithDetails(details ...proto.Message) (*Status, error)
				WithDetails returns a new status with the provided details messages appended to the status.
				If any errors are encountered, it returns nil and the first error encountered.

		As Outputs Of (at least 13, in which 12 are exported)
			func FromProto(s *spb.Status) *Status
			func New(c codes.Code, msg string) *Status
			func Newf(c codes.Code, format string, a ...interface{}) *Status
			func (*Error).GRPCStatus() *Status
			func (*Status).WithDetails(details ...proto.Message) (*Status, error)
			func google.golang.org/grpc/internal/transport.(*Stream).Status() *status.Status
			func google.golang.org/grpc/status.Convert(err error) *status.Status
			func google.golang.org/grpc/status.FromContextError(err error) *status.Status
			func google.golang.org/grpc/status.FromError(err error) (s *status.Status, ok bool)
			func google.golang.org/grpc/status.FromProto(s *spb.Status) *status.Status
			func google.golang.org/grpc/status.New(c codes.Code, msg string) *status.Status
			func google.golang.org/grpc/status.Newf(c codes.Code, format string, a ...interface{}) *status.Status
			/* at least one unexported ... *//* at least one unexported: */
			func google.golang.org/grpc.checkRecvPayload(pf grpc.payloadFormat, recvCompress string, haveCompressor bool) *status.Status
		As Inputs Of (at least 2, in which 1 are exported)
			func google.golang.org/grpc/internal/transport.ServerTransport.WriteStatus(s *transport.Stream, st *status.Status) error
			/* at least one unexported ... *//* at least one unexported: */
			func go.opencensus.io/plugin/ocgrpc.statusCodeToString(s *status.Status) string
		As Types Of (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			  var google.golang.org/grpc/internal/transport.statusGoAway *Status
			  var google.golang.org/grpc.statusOK *Status


Package-Level Functions (total 5, all are exported)

	 func Err(c codes.Code, msg string) error
		Err returns an error representing c and msg.  If c is OK, returns nil.

	 func Errorf(c codes.Code, format string, a ...interface{}) error
		Errorf returns Error(c, fmt.Sprintf(format, a...)).

	 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 ...interface{}) *Status
		Newf returns New(c, fmt.Sprintf(format, a...)).

The pages are generated with Golds v0.3.2-preview. (GOOS=darwin GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @Go100and1 (reachable from the left QR code) to get the latest news of Golds.