nulls

package module
v0.4.2 Latest Latest
Warning

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

 Go to latest Published: Sep 4, 2022 License: MIT Imports: 9 Imported by: 243

README

github.com/gobuffalo/nulls

This package should be used in place of the built-in null types in the sql package.

The real benefit of this packages comes in its implementation of MarshalJSON and UnmarshalJSON to properly encode/decode null values.

Installation

$ go get github.com/gobuffalo/nulls

Supported Datatypes

  • string (nulls.String) - Replaces sql.NullString
  • int64 (nulls.Int64) - Replaces sql.NullInt64
  • float64 (nulls.Float64) - Replaces sql.NullFloat64
  • bool (nulls.Bool) - Replaces sql.NullBool
  • []byte (nulls.ByteSlice)
  • float32 (nulls.Float32)
  • int (nulls.Int)
  • int32 (nulls.Int32)
  • uint32 (nulls.UInt32)
  • time.Time (nulls.Time)
  • uuid.UUID (nulls.UUID)

Documentation

Index

Constants

View Source 
const Version = "v0.1.0"

Version of nulls

Variables

This section is empty.

Functions

func RegisterWithSchema 

func RegisterWithSchema(reg register)

RegisterWithSchema allows for the nulls package to be used with http://www.gorillatoolkit.org/pkg/schema#Converter

Types

type Bool 

type Bool struct {
	Bool  bool
	Valid bool
}

Bool replaces sql.NullBool with an implementation that supports proper JSON encoding/decoding.

func NewBool 

func NewBool(b bool) Bool

NewBool returns a new, properly instantiated Boll object.

func (Bool) Interface 

func (ns Bool) Interface() interface{}

Interface implements the nullable interface. It returns nil if the bool is not valid, otherwise it returns the bool value.

func (Bool) MarshalJSON 

func (ns Bool) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Bool) Scan 

func (ns *Bool) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Bool) UnmarshalJSON 

func (ns *Bool) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the proper representation of that value. The strings "true" and "t" will be considered "true", "false" and "f" will be treated as "false". All other values will be set to null by Valid = false

func (*Bool) UnmarshalText 

func (ns *Bool) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Bool) Value 

func (ns Bool) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type ByteSlice 

type ByteSlice struct {
	ByteSlice []byte
	Valid     bool // Valid is true if ByteSlice is not NULL
}

ByteSlice adds an implementation for []byte that supports proper JSON encoding/decoding.

func NewByteSlice 

func NewByteSlice(b []byte) ByteSlice

NewByteSlice returns a new, properly instantiated ByteSlice object.

func (ByteSlice) Interface 

func (ns ByteSlice) Interface() interface{}

Interface implements the nullable interface. It returns nil if the byte slice is not valid, otherwise it returns the byte slice value.

func (ByteSlice) MarshalJSON 

func (ns ByteSlice) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*ByteSlice) Scan 

func (ns *ByteSlice) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*ByteSlice) UnmarshalJSON 

func (ns *ByteSlice) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*ByteSlice) UnmarshalText 

func (ns *ByteSlice) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (ByteSlice) Value 

func (ns ByteSlice) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Float32 

type Float32 struct {
	Float32 float32
	Valid   bool // Valid is true if Float32 is not NULL
}

Float32 adds an implementation for float32 that supports proper JSON encoding/decoding.

func NewFloat32 

func NewFloat32(i float32) Float32

NewFloat32 returns a new, properly instantiated Float32 object.

func (Float32) Interface 

func (ns Float32) Interface() interface{}

Interface implements the nullable interface. It returns nil if the float32 is not valid, otherwise it returns the float32 value.

func (Float32) MarshalJSON 

func (ns Float32) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Float32) Scan 

func (ns *Float32) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Float32) UnmarshalJSON 

func (ns *Float32) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Float32) UnmarshalText 

func (ns *Float32) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Float32) Value 

func (ns Float32) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Float64 

type Float64 sql.NullFloat64

Float64 replaces sql.NullFloat64 with an implementation that supports proper JSON encoding/decoding.

func NewFloat64 

func NewFloat64(i float64) Float64

NewFloat64 returns a new, properly instantiated Float64 object.

func (Float64) Interface 

func (ns Float64) Interface() interface{}

Interface implements the nullable interface. It returns nil if the float64 is not valid, otherwise it returns the float64 value.

func (Float64) MarshalJSON 

func (ns Float64) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Float64) Scan 

func (ns *Float64) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Float64) UnmarshalJSON 

func (ns *Float64) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Float64) UnmarshalText 

func (ns *Float64) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Float64) Value 

func (ns Float64) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Int 

type Int struct {
	Int   int
	Valid bool // Valid is true if Int is not NULL
}

Int adds an implementation for int that supports proper JSON encoding/decoding.

func NewInt 

func NewInt(i int) Int

NewInt returns a new, properly instantiated Int object.

func (Int) Interface 

func (ns Int) Interface() interface{}

Interface implements the nullable interface. It returns nil if the int is not valid, otherwise it returns the int value.

func (Int) MarshalJSON 

func (ns Int) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Int) Scan 

func (ns *Int) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Int) UnmarshalJSON 

func (ns *Int) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Int) UnmarshalText 

func (ns *Int) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Int) Value 

func (ns Int) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Int32 

type Int32 struct {
	Int32 int32
	Valid bool // Valid is true if Int32 is not NULL
}

Int32 adds an implementation for int32 that supports proper JSON encoding/decoding.

func NewInt32 

func NewInt32(i int32) Int32

NewInt32 returns a new, properly instantiated Int object.

func (Int32) Interface 

func (ns Int32) Interface() interface{}

Interface implements the nullable interface. It returns nil if the int32 is not valid, otherwise it returns the int32 value.

func (Int32) MarshalJSON 

func (ns Int32) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Int32) Scan 

func (ns *Int32) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Int32) UnmarshalJSON 

func (ns *Int32) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Int32) UnmarshalText 

func (ns *Int32) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Int32) Value 

func (ns Int32) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Int64 

type Int64 sql.NullInt64

Int64 replaces sql.Int64 with an implementation that supports proper JSON encoding/decoding.

func NewInt64 

func NewInt64(i int64) Int64

NewInt64 returns a new, properly instantiated Int64 object.

func (Int64) Interface 

func (ns Int64) Interface() interface{}

Interface implements the nullable interface. It returns nil if the int64 is not valid, otherwise it returns the int64 value.

func (Int64) MarshalJSON 

func (ns Int64) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Int64) Scan 

func (ns *Int64) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Int64) UnmarshalJSON 

func (ns *Int64) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Int64) UnmarshalText 

func (ns *Int64) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Int64) Value 

func (ns Int64) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Nulls 

type Nulls struct {
	Value interface{}
}

Nulls a generic nulls type. something that implements nullable interface. can be any of nulls.Int, nulls.uuid.UUID nulls.String, etc.

func New 

func New(i interface{}) *Nulls

New returns a wrapper called nulls for the interface passed as a param.

func (*Nulls) Interface 

func (nulls *Nulls) Interface() interface{}

Interface calls Interface function for value.

func (*Nulls) Parse 

func (nulls *Nulls) Parse(value interface{}) interface{}

Parse parses the specified value to the corresponding nullable type. value is one of the inner value hold by a nullable type. i.e int, string, uuid.UUID etc.

type String 

type String sql.NullString

String replaces sql.NullString with an implementation that supports proper JSON encoding/decoding.

func NewString 

func NewString(s string) String

NewString returns a new, properly instantiated String object.

func (String) Interface 

func (ns String) Interface() interface{}

Interface implements the nullable interface. It returns nil if the string is not valid, otherwise it returns the string value.

func (String) MarshalJSON 

func (ns String) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*String) Scan 

func (ns *String) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*String) UnmarshalJSON 

func (ns *String) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*String) UnmarshalText 

func (ns *String) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (String) Value 

func (ns String) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type Time 

type Time struct {
	Time  time.Time
	Valid bool // Valid is true if Time is not NULL
}

Time replaces sql.NullTime with an implementation that supports proper JSON encoding/decoding.

func NewTime 

func NewTime(t time.Time) Time

NewTime returns a new, properly instantiated Time object.

func (Time) Interface 

func (ns Time) Interface() interface{}

Interface implements the nullable interface. It returns nil if the Time is not valid, otherwise it returns the Time value.

func (Time) MarshalJSON 

func (ns Time) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*Time) Scan 

func (ns *Time) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*Time) UnmarshalJSON 

func (ns *Time) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*Time) UnmarshalText 

func (ns *Time) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (Time) Value 

func (ns Time) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type UInt32 

type UInt32 struct {
	UInt32 uint32
	Valid  bool // Valid is true if Int is not NULL
}

UInt32 adds an implementation for int that supports proper JSON encoding/decoding.

func NewUInt32 

func NewUInt32(i uint32) UInt32

NewUInt32 returns a new, properly instantiated Int object.

func (UInt32) Interface 

func (ns UInt32) Interface() interface{}

Interface implements the nullable interface. It returns nil if the uint32 is not valid, otherwise it returns the uint32 value.

func (UInt32) MarshalJSON 

func (ns UInt32) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*UInt32) Scan 

func (ns *UInt32) Scan(value interface{}) error

Scan implements the Scanner interface.

func (*UInt32) UnmarshalJSON 

func (ns *UInt32) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*UInt32) UnmarshalText 

func (ns *UInt32) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (UInt32) Value 

func (ns UInt32) Value() (driver.Value, error)

Value implements the driver Valuer interface.

type UUID 

type UUID struct {
	UUID  uuid.UUID
	Valid bool
}

UUID can be used with the standard sql package to represent a UUID value that can be NULL in the database

func NewUUID 

func NewUUID(u uuid.UUID) UUID

NewUUID returns a new, properly instantiated UUID object.

func (UUID) Interface 

func (u UUID) Interface() interface{}

Interface implements the nullable interface. It returns nil if the UUID is not valid, otherwise it returns the UUID value.

func (UUID) MarshalJSON 

func (u UUID) MarshalJSON() ([]byte, error)

MarshalJSON marshals the underlying value to a proper JSON representation.

func (*UUID) Scan 

func (u *UUID) Scan(src interface{}) error

Scan implements the sql.Scanner interface.

func (*UUID) UnmarshalJSON 

func (u *UUID) UnmarshalJSON(text []byte) error

UnmarshalJSON will unmarshal a JSON value into the propert representation of that value.

func (*UUID) UnmarshalText 

func (u *UUID) UnmarshalText(text []byte) error

UnmarshalText will unmarshal text value into the propert representation of that value.

func (UUID) Value 

func (u UUID) Value() (driver.Value, error)

Value implements the driver.Valuer interface.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.