types

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 4, 2025 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Package types provides some useful types which implement the `sql.Scanner` and `driver.Valuer` interfaces, suitable for use as scan and value targets with database/sql.

Index

Constants

This section is empty.

Variables

View Source
var EmptyJSON = JSONText("{}")

EmptyJSON is a JSON without key-value pairs.

View Source
var ErrBadBitBoolSource = errors.New("bad []byte type assertion")

ErrBadBitBoolSource is returned when BitBool.Scan the type assertion fails

View Source
var ErrIncopatibleTypeForGzipText = errors.New("incompatible type for GzippedText")

ErrIncopatibleTypeForGzipText is returned when the type passed to GzippedText.Scan is incompatible

Functions

This section is empty.

Types

type BitBool

type BitBool bool

BitBool is an implementation of a bool for the MySQL type BIT(1). This type allows you to avoid wasting an entire byte for MySQL's boolean type TINYINT.

func (*BitBool) Scan

func (b *BitBool) Scan(src any) error

Scan implements the sql.Scanner interface, and turns the bitfield incoming from MySQL into a BitBool

func (BitBool) Value

func (b BitBool) Value() (driver.Value, error)

Value implements the driver.Valuer interface, and turns the BitBool into a bitfield (BIT(1)) for MySQL storage.

type GzippedText

type GzippedText struct {
	// contains filtered or unexported fields
}

GzippedText is a []byte which transparently gzips data being submitted to a database and ungzips data being Scanned from a database.

func NewGzippedText

func NewGzippedText(content ...byte) *GzippedText

func (*GzippedText) Bytes

func (g *GzippedText) Bytes() []byte

Bytes returns the gzipped text bytes

func (*GzippedText) Scan

func (g *GzippedText) Scan(src any) error

Scan implements the sql.Scanner interface, ungzipping the value coming off the wire and storing the raw result in the GzippedText.

func (GzippedText) Value

func (g GzippedText) Value() (driver.Value, error)

Value implements the driver.Valuer interface, gzipping the raw value of this GzippedText.

type JSONText

type JSONText json.RawMessage

JSONText is a json.RawMessage, which is a []byte underneath. Value() validates the json format in the source, and returns an error if the json is not valid. Scan does no validation. JSONText additionally implements `Unmarshal`, which unmarshals the json within to an any

func NewJSONText

func NewJSONText(data ...byte) JSONText

NewJSONText returns a new JSONText with the given data.

func (JSONText) MarshalJSON

func (j JSONText) MarshalJSON() ([]byte, error)

MarshalJSON returns the *j as the JSON encoding of j.

func (*JSONText) Scan

func (j *JSONText) Scan(src any) error

Scan stores the src in *j. No validation is done.

func (JSONText) String

func (j JSONText) String() string

String supports pretty printing for JSONText types.

func (*JSONText) Unmarshal

func (j *JSONText) Unmarshal(v any) error

Unmarshal unmarshal's the json in j to v, as in json.Unmarshal.

func (*JSONText) UnmarshalJSON

func (j *JSONText) UnmarshalJSON(data []byte) error

UnmarshalJSON sets *j to a copy of data

func (JSONText) Value

func (j JSONText) Value() (driver.Value, error)

Value returns j as a value. This does a validating unmarshal into another RawMessage. If j is invalid json, it returns an error.

type NullJSONText

type NullJSONText struct {
	JSONText
	Valid bool // Valid is true if JSONText is not NULL
}

NullJSONText represents a JSONText that may be null. NullJSONText implements the scanner interface so it can be used as a scan destination, similar to NullString.

func (*NullJSONText) Scan

func (n *NullJSONText) Scan(value any) error

Scan implements the Scanner interface.

func (NullJSONText) Value

func (n NullJSONText) Value() (driver.Value, error)

Value implements the driver Valuer interface.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL