import "gopkg.in/guregu/null.v2"
null is a library with reasonable options for dealing with nullable SQL and JSON values
There are two packages: null
and its subpackage zero
.
Types in null
will only be considered null on null input, and will JSON encode to null
. If you need zero and null be considered separate values, use these.
Types in zero
are treated like zero values in Go: blank string input will produce a null zero.String
, and null Strings will JSON encode to ""
. If you need zero and null treated the same, use these.
All types implement sql.Scanner
and driver.Valuer
, so you can use this library in place of sql.NullXXX
. All types also implement: encoding.TextMarshaler
, encoding.TextUnmarshaler
, json.Marshaler
, and json.Unmarshaler
.
A nullable string.
Will marshal to a blank string if null. Blank string input produces a null String. In other words, null values and empty values are considered equivalent. Can unmarshal from sql.NullString
JSON input.
A nullable int64.
Will marshal to 0 if null. Blank string or 0 input produces a null Int. In other words, null values and empty values are considered equivalent. Can unmarshal from sql.NullInt64
JSON input.
A nullable float64.
Will marshal to 0 if null. Blank string or 0 input produces a null Float. In other words, null values and empty values are considered equivalent. Can unmarshal from sql.NullFloat64
JSON input.
A nullable bool.
Will marshal to false if null. Blank string or false input produces a null Float. In other words, null values and empty values are considered equivalent. Can unmarshal from sql.NullBool
JSON input.
An even nuller nullable string.
Unlike zero.String
, null.String
will marshal to null if null. Zero (blank) input will not produce a null String. Can unmarshal from sql.NullString
JSON input.
An even nuller nullable int64.
Unlike zero.Int
, null.Int
will marshal to null if null. Zero input will not produce a null Int. Can unmarshal from sql.NullInt64
JSON input.
An even nuller nullable float64.
Unlike zero.Float
, null.Float
will marshal to null if null. Zero input will not produce a null Float. Can unmarshal from sql.NullFloat64
JSON input.
An even nuller nullable float64.
Unlike zero.Bool
, null.Bool
will marshal to null if null. False input will not produce a null Bool. Can unmarshal from sql.NullBool
JSON input.
json
's ",omitempty"
struct tag does not work correctly right now. It will never omit a null or empty String. This should be fixed in Go 1.4.
BSD