nan

package module
v0.0.0-...-2543a67 Latest Latest
Warning

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

 Go to latest Published: Mar 5, 2025 License: MIT Imports: 16 Imported by: 0

README

nan - No Allocations Nevermore

Package nan - Zero allocation Nullable structures in one library with handy conversion functions, marshallers and unmarshallers.

Godoc Coverage Status Go Report Card Go

Features:

  • short name "nan"
  • handy conversion functions
  • select which marshalers you want and limit dependencies to only those you actually need
  • ability to convert your custom structs to nan compatible type with Valid field and all requested encoders/decoders

Supported types:

  • bool
  • float32
  • float64
  • int
  • int8
  • int16
  • int32
  • int64
  • string
  • time.Time
  • uint
  • uint8
  • uint16
  • uint32
  • uint64
  • more types will be added as necessary

Supported marshallers:

  • Standart JSON
  • encoding.TextMarshaler/TextUnmarshaler. Reuses standard JSON logic and format
  • jsoniter
  • easyjson
  • go-json
  • Scylla and Cassandra. Compatible with gocql
  • SQL

Usage

Simply create struct field or variable with one of the exported types and use it without any changes to external API.

JSON input/output will be converted to null or non null values. Scylla and Cassandra will use wire format compatible with gocql.

var data struct {
  Code nan.NullString `json:"code"`
}

b, err := jsoniter.Marshal(data)
if err != nil {
  panic(err)
}

// {"code":null}
println(string(b))

data.Code = nan.String("1")
// Equals to
// data.Code = nan.NullString{String: "1", Valid: true}

b, err = jsoniter.Marshal(data)
if err != nil {
  panic(err)
}

// {"code":"1"}
println(string(b))

code := "2"

// From addr. Can has value or be nil
data.Code = nan.StringAddr(&code)

b, err = jsoniter.Marshal(data)
if err != nil {
  panic(err)
}

// {"code":"2"}
println(string(b))

// To usual value from nan
codeVal := data.Code.String

// 2
println(codeVal)

// To value addr from nan
codeAddr := data.Code.Addr()

// 2
println(*codeAddr)

Helpers

How often you write something like this?

val := true
addr := &val

With nan helpers you can write shorter

addr := nan.Bool(true).Addr()

With this you got less lines of code without readability loose.

Generate marshalers

# go install github.com/requirednetsu/nan/cmd/nan@latest
# nan -help

Instead of depending on the whole github.com/requirednetsu/nan you can also use nan command to select which marshalers you want. Simply run nan with one or more arguments and it will generate implementations for the specified marshalers in the current directory. For example, running

# nan gen -json -jsoniter

will generate nan.go, json.go, jsoniter.go files in the current working directory that contain only encoding/json and jsoniter marshalers. Nothing else will be generated so you don't have to depend on all the marshalers that github.com/requirednetsu/nan supports. Generated files will use current directory name as its package name. You can also specify your own package name with -pkg argument.

Custom structs generator

Imagine, that you have custom struct

type MyStruct struct {
	ID   int
	Name string
}

Use nan command on its file

# nan extra -json -jsoniter example/structs.go

This will generate *_nan.go near source files with json (or any other supported marshallers). And now you have nan compatible struct with all needed marshallers

var val MyStruct

nullVal := NanMyStruct(val)
// Equals to
// nullVal := NullMyStruct{MyStruct: val, Valid: true}

fmt.Println(nullVal.ID)

See example to specific of easyjson, cql, sql generation.

nan extra coommand supports any number of file names at command line.

Benchmarks

See here.

sqlc integration

See here.

Documentation

Overview

Package nan - Zero allocation Nullable structures in one library with handy conversion functions, marshallers and unmarshallers.

Features: - short name "nan" - handy conversion functions - select which marshalers you want and limit dependencies to only those you actually need - ability to convert your custom structs to nan compatible type with Valid field and all requested encoders/decoders

Supported types: - bool - float32 - float64 - int - int8 - int16 - int32 - int64 - string - time.Time - more types will be added as necessary

Supported marshallers: - Standart JSON - encoding.TextMarshaler/TextUnmarshaler. Reuses standard JSON logic and format - jsoniter - easyjson - go-json - Scylla and Cassandra. Compatible with gocql - SQL

Usage

Simply create struct field or variable with one of the exported types and use it without any changes to external API.

JSON input/output will be converted to null or non null values. Scylla and Cassandra will use wire format compatible with gocql. 

var data struct {
	Code nan.NullString `json:"code"`
}

b, err := jsoniter.Marshal(data)
if err != nil {
	panic(err)
}

// {"code":null}
println(string(b))

data.Code = nan.String("1")
// Equals to
// data.Code = nan.NullString{String: "1", Valid: true}

b, err = jsoniter.Marshal(data)
if err != nil {
	panic(err)
}

// {"code":"1"}
println(string(b))

code := "2"

// From addr. Can has value or be nil
data.Code = nan.StringAddr(&code)

b, err = jsoniter.Marshal(data)
if err != nil {
	panic(err)
}

// {"code":"2"}
println(string(b))

// To usual value from nan
codeVal := data.Code.String

// 2
println(codeVal)

// To value addr from nan
codeAddr := data.Code.Addr()

// 2
println(*codeAddr)

Index

Constants

This section is empty.

Variables

View Source 
var EmbeddedSources embed.FS

Functions

This section is empty.

Types

type NullBool 

type NullBool struct {
	Bool  bool
	Valid bool // Valid is true if Bool is not NULL
}

NullBool - nullable bool

func Bool 

func Bool(v bool) NullBool

Bool - converts bool to NullBool

func BoolAddr 

func BoolAddr(v *bool) NullBool

BoolAddr - converts bool address to NullBool

func BoolToNullBool deprecated 

func BoolToNullBool(v bool) NullBool

BoolToNullBool - converts bool to NullBool

Deprecated: use shorter variant

func (NullBool) Addr 

func (n NullBool) Addr() *bool

func (NullBool) IsDefined 

func (n NullBool) IsDefined() bool

func (NullBool) IsValid 

func (n NullBool) IsValid() bool

func (NullBool) MarshalCQL 

func (n NullBool) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullBool) MarshalEasyJSON 

func (n NullBool) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullBool) MarshalJSON 

func (n NullBool) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullBool) MarshalText 

func (n NullBool) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullBool) Scan 

func (n *NullBool) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullBool) UnmarshalCQL 

func (n *NullBool) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullBool) UnmarshalEasyJSON 

func (n *NullBool) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullBool) UnmarshalJSON 

func (n *NullBool) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullBool) UnmarshalText 

func (n *NullBool) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullBool) Value 

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

Value implements the driver Valuer interface.

type NullFloat32 

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

NullFloat32 - nullable float32

func Float32 

func Float32(v float32) NullFloat32

Float32 - converts float32 to NullFloat32

func Float32Addr 

func Float32Addr(v *float32) NullFloat32

Float32Addr - converts float32 address to NullFloat32

func Float32ToNullFloat32 deprecated 

func Float32ToNullFloat32(v float32) NullFloat32

Float32ToNullFloat32 - converts float32 to NullFloat32

Deprecated: use shorter variant

func (NullFloat32) Addr 

func (n NullFloat32) Addr() *float32

func (NullFloat32) IsDefined 

func (n NullFloat32) IsDefined() bool

func (NullFloat32) IsValid 

func (n NullFloat32) IsValid() bool

func (NullFloat32) MarshalCQL 

func (n NullFloat32) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullFloat32) MarshalEasyJSON 

func (n NullFloat32) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullFloat32) MarshalJSON 

func (n NullFloat32) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullFloat32) MarshalText 

func (n NullFloat32) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullFloat32) Scan 

func (n *NullFloat32) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullFloat32) UnmarshalCQL 

func (n *NullFloat32) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullFloat32) UnmarshalEasyJSON 

func (n *NullFloat32) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullFloat32) UnmarshalJSON 

func (n *NullFloat32) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullFloat32) UnmarshalText 

func (n *NullFloat32) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullFloat32) Value 

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

Value implements the driver Valuer interface.

type NullFloat64 

type NullFloat64 struct {
	Float64 float64
	Valid   bool // Valid is true if Float64 is not NULL
}

NullFloat64 - nullable float64

func Float64 

func Float64(v float64) NullFloat64

Float64 - converts float64 to NullFloat64

func Float64Addr 

func Float64Addr(v *float64) NullFloat64

Float64Addr - converts float64 address to NullFloat64

func Float64ToNullFloat64 deprecated 

func Float64ToNullFloat64(v float64) NullFloat64

Float64ToNullFloat64 - converts float64 to NullFloat64

Deprecated: use shorter variant

func (NullFloat64) Addr 

func (n NullFloat64) Addr() *float64

func (NullFloat64) IsDefined 

func (n NullFloat64) IsDefined() bool

func (NullFloat64) IsValid 

func (n NullFloat64) IsValid() bool

func (NullFloat64) MarshalCQL 

func (n NullFloat64) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullFloat64) MarshalEasyJSON 

func (n NullFloat64) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullFloat64) MarshalJSON 

func (n NullFloat64) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullFloat64) MarshalText 

func (n NullFloat64) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullFloat64) Scan 

func (n *NullFloat64) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullFloat64) UnmarshalCQL 

func (n *NullFloat64) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullFloat64) UnmarshalEasyJSON 

func (n *NullFloat64) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullFloat64) UnmarshalJSON 

func (n *NullFloat64) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullFloat64) UnmarshalText 

func (n *NullFloat64) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullFloat64) Value 

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

Value implements the driver Valuer interface.

type NullInt 

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

NullInt - nullable int

func Int 

func Int(v int) NullInt

Int - converts int to NullInt

func IntAddr 

func IntAddr(v *int) NullInt

IntAddr - converts int address to NullInt

func IntToNullInt deprecated 

func IntToNullInt(v int) NullInt

IntToNullInt - converts int to NullInt

Deprecated: use shorter variant

func (NullInt) Addr 

func (n NullInt) Addr() *int

func (NullInt) IsDefined 

func (n NullInt) IsDefined() bool

func (NullInt) IsValid 

func (n NullInt) IsValid() bool

func (NullInt) MarshalCQL 

func (n NullInt) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullInt) MarshalEasyJSON 

func (n NullInt) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullInt) MarshalJSON 

func (n NullInt) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullInt) MarshalText 

func (n NullInt) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullInt) Scan 

func (n *NullInt) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullInt) UnmarshalCQL 

func (n *NullInt) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullInt) UnmarshalEasyJSON 

func (n *NullInt) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullInt) UnmarshalJSON 

func (n *NullInt) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullInt) UnmarshalText 

func (n *NullInt) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullInt) Value 

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

Value implements the driver Valuer interface.

type NullInt8 

type NullInt8 struct {
	Int8  int8
	Valid bool // Valid is true if Int8 is not NULL
}

NullInt8 - nullable int8

func Int8 

func Int8(v int8) NullInt8

Int8 - converts int8 to NullInt8

func Int8Addr 

func Int8Addr(v *int8) NullInt8

Int8Addr - converts int8 address to NullInt8

func Int8ToNullInt8 deprecated 

func Int8ToNullInt8(v int8) NullInt8

Int8ToNullInt8 - converts int8 to NullInt8

Deprecated: use shorter variant

func (NullInt8) Addr 

func (n NullInt8) Addr() *int8

func (NullInt8) IsDefined 

func (n NullInt8) IsDefined() bool

func (NullInt8) IsValid 

func (n NullInt8) IsValid() bool

func (NullInt8) MarshalCQL 

func (n NullInt8) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullInt8) MarshalEasyJSON 

func (n NullInt8) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullInt8) MarshalJSON 

func (n NullInt8) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullInt8) MarshalText 

func (n NullInt8) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullInt8) Scan 

func (n *NullInt8) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullInt8) UnmarshalCQL 

func (n *NullInt8) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullInt8) UnmarshalEasyJSON 

func (n *NullInt8) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullInt8) UnmarshalJSON 

func (n *NullInt8) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullInt8) UnmarshalText 

func (n *NullInt8) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullInt8) Value 

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

Value implements the driver Valuer interface.

type NullInt16 

type NullInt16 struct {
	Int16 int16
	Valid bool // Valid is true if Int16 is not NULL
}

NullInt16 - nullable int16

func Int16 

func Int16(v int16) NullInt16

Int16 - converts int16 to NullInt16

func Int16Addr 

func Int16Addr(v *int16) NullInt16

Int16Addr - converts int16 address to NullInt16

func Int16ToNullInt16 deprecated 

func Int16ToNullInt16(v int16) NullInt16

Int16ToNullInt16 - converts int16 to NullInt16

Deprecated: use shorter variant

func (NullInt16) Addr 

func (n NullInt16) Addr() *int16

func (NullInt16) IsDefined 

func (n NullInt16) IsDefined() bool

func (NullInt16) IsValid 

func (n NullInt16) IsValid() bool

func (NullInt16) MarshalCQL 

func (n NullInt16) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullInt16) MarshalEasyJSON 

func (n NullInt16) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullInt16) MarshalJSON 

func (n NullInt16) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullInt16) MarshalText 

func (n NullInt16) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullInt16) Scan 

func (n *NullInt16) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullInt16) UnmarshalCQL 

func (n *NullInt16) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullInt16) UnmarshalEasyJSON 

func (n *NullInt16) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullInt16) UnmarshalJSON 

func (n *NullInt16) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullInt16) UnmarshalText 

func (n *NullInt16) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullInt16) Value 

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

Value implements the driver Valuer interface.

type NullInt32 

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

NullInt32 - nullable int32

func Int32 

func Int32(v int32) NullInt32

Int32 - converts int32 to NullInt32

func Int32Addr 

func Int32Addr(v *int32) NullInt32

Int32Addr - converts int32 address to NullInt32

func Int32ToNullInt32 deprecated 

func Int32ToNullInt32(v int32) NullInt32

Int32ToNullInt32 - converts int32 to NullInt32

Deprecated: use shorter variant

func (NullInt32) Addr 

func (n NullInt32) Addr() *int32

func (NullInt32) IsDefined 

func (n NullInt32) IsDefined() bool

func (NullInt32) IsValid 

func (n NullInt32) IsValid() bool

func (NullInt32) MarshalCQL 

func (n NullInt32) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullInt32) MarshalEasyJSON 

func (n NullInt32) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullInt32) MarshalJSON 

func (n NullInt32) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullInt32) MarshalText 

func (n NullInt32) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullInt32) Scan 

func (n *NullInt32) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullInt32) UnmarshalCQL 

func (n *NullInt32) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullInt32) UnmarshalEasyJSON 

func (n *NullInt32) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullInt32) UnmarshalJSON 

func (n *NullInt32) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullInt32) UnmarshalText 

func (n *NullInt32) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullInt32) Value 

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

Value implements the driver Valuer interface.

type NullInt64 

type NullInt64 struct {
	Int64 int64
	Valid bool // Valid is true if Int64 is not NULL
}

NullInt64 - nullable int64

func Int64 

func Int64(v int64) NullInt64

Int64 - converts int64 to NullInt64

func Int64Addr 

func Int64Addr(v *int64) NullInt64

Int64Addr - converts int64 address to NullInt64

func Int64ToNullInt64 deprecated 

func Int64ToNullInt64(v int64) NullInt64

Int64ToNullInt64 - converts int64 to NullInt64

Deprecated: use shorter variant

func (NullInt64) Addr 

func (n NullInt64) Addr() *int64

func (NullInt64) IsDefined 

func (n NullInt64) IsDefined() bool

func (NullInt64) IsValid 

func (n NullInt64) IsValid() bool

func (NullInt64) MarshalCQL 

func (n NullInt64) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullInt64) MarshalEasyJSON 

func (n NullInt64) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullInt64) MarshalJSON 

func (n NullInt64) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullInt64) MarshalText 

func (n NullInt64) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullInt64) Scan 

func (n *NullInt64) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullInt64) UnmarshalCQL 

func (n *NullInt64) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullInt64) UnmarshalEasyJSON 

func (n *NullInt64) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullInt64) UnmarshalJSON 

func (n *NullInt64) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullInt64) UnmarshalText 

func (n *NullInt64) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullInt64) Value 

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

Value implements the driver Valuer interface.

type NullString 

type NullString struct {
	String string
	Valid  bool // Valid is true if String is not NULL
}

NullString - nullable string

func String 

func String(v string) NullString

String - converts string to NullString

func StringAddr 

func StringAddr(v *string) NullString

StringAddr - converts string address to NullString

func StringToNullString deprecated 

func StringToNullString(v string) NullString

StringToNullString - converts string to NullString

Deprecated: use shorter variant

func (NullString) Addr 

func (n NullString) Addr() *string

func (NullString) IsDefined 

func (n NullString) IsDefined() bool

func (NullString) IsValid 

func (n NullString) IsValid() bool

func (NullString) MarshalCQL 

func (n NullString) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullString) MarshalEasyJSON 

func (n NullString) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullString) MarshalJSON 

func (n NullString) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullString) MarshalText 

func (n NullString) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullString) Scan 

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

Scan - scan value from sql driver

func (*NullString) UnmarshalCQL 

func (n *NullString) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullString) UnmarshalEasyJSON 

func (n *NullString) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullString) UnmarshalJSON 

func (n *NullString) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullString) UnmarshalText 

func (n *NullString) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullString) Value 

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

Value implements the driver Valuer interface.

type NullTime 

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

NullTime - nullable time.Time

func Time 

func Time(v time.Time) NullTime

Time - converts time.Time to NullTime

func TimeAddr 

func TimeAddr(v *time.Time) NullTime

TimeAddr - converts time.Time address to NullTime

func TimeToNullTime deprecated 

func TimeToNullTime(v time.Time) NullTime

TimeToNullTime - converts time.Time to NullTime

Deprecated: use shorter variant

func (NullTime) Addr 

func (n NullTime) Addr() *time.Time

func (NullTime) IsDefined 

func (n NullTime) IsDefined() bool

func (NullTime) IsValid 

func (n NullTime) IsValid() bool

func (NullTime) MarshalCQL 

func (n NullTime) MarshalCQL(info gocql.TypeInfo) ([]byte, error)

MarshalCQL - marshaller for cql

func (NullTime) MarshalEasyJSON 

func (n NullTime) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullTime) MarshalJSON 

func (n NullTime) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullTime) MarshalText 

func (n NullTime) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullTime) Scan 

func (n *NullTime) Scan(value interface{}) error

Scan - scan value from sql driver

func (*NullTime) UnmarshalCQL 

func (n *NullTime) UnmarshalCQL(info gocql.TypeInfo, data []byte) error

UnmarshalCQL - unmarshaller for cql

func (*NullTime) UnmarshalEasyJSON 

func (n *NullTime) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullTime) UnmarshalJSON 

func (n *NullTime) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullTime) UnmarshalText 

func (n *NullTime) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

func (NullTime) Value 

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

Value implements the driver Valuer interface.

type NullUint 

type NullUint struct {
	Uint  uint
	Valid bool // Valid is true if Uint is not NULL
}

NullUint - nullable uint

func Uint 

func Uint(v uint) NullUint

Uint - converts uint to NullUint

func UintAddr 

func UintAddr(v *uint) NullUint

UintAddr - converts uint address to NullUint

func (NullUint) Addr 

func (n NullUint) Addr() *uint

func (NullUint) IsDefined 

func (n NullUint) IsDefined() bool

func (NullUint) IsValid 

func (n NullUint) IsValid() bool

func (NullUint) MarshalEasyJSON 

func (n NullUint) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullUint) MarshalJSON 

func (n NullUint) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullUint) MarshalText 

func (n NullUint) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullUint) UnmarshalEasyJSON 

func (n *NullUint) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullUint) UnmarshalJSON 

func (n *NullUint) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullUint) UnmarshalText 

func (n *NullUint) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

type NullUint8 

type NullUint8 struct {
	Uint8 uint8
	Valid bool // Valid is true if Uint8 is not NULL
}

NullUint8 - nullable uint8

func Uint8 

func Uint8(v uint8) NullUint8

Uint8 - converts uint8 to NullUint8

func Uint8Addr 

func Uint8Addr(v *uint8) NullUint8

Uint8Addr - converts uint8 address to NullUint8

func (NullUint8) Addr 

func (n NullUint8) Addr() *uint8

func (NullUint8) IsDefined 

func (n NullUint8) IsDefined() bool

func (NullUint8) IsValid 

func (n NullUint8) IsValid() bool

func (NullUint8) MarshalEasyJSON 

func (n NullUint8) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullUint8) MarshalJSON 

func (n NullUint8) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullUint8) MarshalText 

func (n NullUint8) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullUint8) UnmarshalEasyJSON 

func (n *NullUint8) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullUint8) UnmarshalJSON 

func (n *NullUint8) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullUint8) UnmarshalText 

func (n *NullUint8) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

type NullUint16 

type NullUint16 struct {
	Uint16 uint16
	Valid  bool // Valid is true if Uint16 is not NULL
}

NullUint16 - nullable uint16

func Uint16 

func Uint16(v uint16) NullUint16

Uint16 - converts uint16 to NullUint16

func Uint16Addr 

func Uint16Addr(v *uint16) NullUint16

Uint16Addr - converts uint16 address to NullUint16

func (NullUint16) Addr 

func (n NullUint16) Addr() *uint16

func (NullUint16) IsDefined 

func (n NullUint16) IsDefined() bool

func (NullUint16) IsValid 

func (n NullUint16) IsValid() bool

func (NullUint16) MarshalEasyJSON 

func (n NullUint16) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullUint16) MarshalJSON 

func (n NullUint16) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullUint16) MarshalText 

func (n NullUint16) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullUint16) UnmarshalEasyJSON 

func (n *NullUint16) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullUint16) UnmarshalJSON 

func (n *NullUint16) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullUint16) UnmarshalText 

func (n *NullUint16) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

type NullUint32 

type NullUint32 struct {
	Uint32 uint32
	Valid  bool // Valid is true if Uint32 is not NULL
}

NullUint32 - nullable uint32

func Uint32 

func Uint32(v uint32) NullUint32

Uint32 - converts uint32 to NullUint32

func Uint32Addr 

func Uint32Addr(v *uint32) NullUint32

Uint32Addr - converts uint32 address to NullUint32

func (NullUint32) Addr 

func (n NullUint32) Addr() *uint32

func (NullUint32) IsDefined 

func (n NullUint32) IsDefined() bool

func (NullUint32) IsValid 

func (n NullUint32) IsValid() bool

func (NullUint32) MarshalEasyJSON 

func (n NullUint32) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullUint32) MarshalJSON 

func (n NullUint32) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullUint32) MarshalText 

func (n NullUint32) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullUint32) UnmarshalEasyJSON 

func (n *NullUint32) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullUint32) UnmarshalJSON 

func (n *NullUint32) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullUint32) UnmarshalText 

func (n *NullUint32) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

type NullUint64 

type NullUint64 struct {
	Uint64 uint64
	Valid  bool // Valid is true if Uint64 is not NULL
}

NullUint64 - nullable uint64

func Uint64 

func Uint64(v uint64) NullUint64

Uint64 - converts uint64 to NullUint64

func Uint64Addr 

func Uint64Addr(v *uint64) NullUint64

Uint64Addr - converts uint64 address to NullUint64

func (NullUint64) Addr 

func (n NullUint64) Addr() *uint64

func (NullUint64) IsDefined 

func (n NullUint64) IsDefined() bool

func (NullUint64) IsValid 

func (n NullUint64) IsValid() bool

func (NullUint64) MarshalEasyJSON 

func (n NullUint64) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON - marshaller for easyjson

func (NullUint64) MarshalJSON 

func (n NullUint64) MarshalJSON() ([]byte, error)

MarshalJSON - marshaller for json

func (NullUint64) MarshalText 

func (n NullUint64) MarshalText() ([]byte, error)

MarshalText - marshaller for text

func (*NullUint64) UnmarshalEasyJSON 

func (n *NullUint64) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON - unmarshaller for easyjson

func (*NullUint64) UnmarshalJSON 

func (n *NullUint64) UnmarshalJSON(data []byte) error

UnmarshalJSON - unmarshaller for json

func (*NullUint64) UnmarshalText 

func (n *NullUint64) UnmarshalText(text []byte) error

UnmarshalText - unmarshaller for text

type Validator 

type Validator interface {
	IsValid() bool
}

Validator is implemented by all nan types and returns Valid field

Source Files

View all Source files

Directories

Path Synopsis
cmd
nan command
basic command

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.