null - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #typescript #go #rust #deep-learning #docker #nodejs #windows #awesome #security #mcp #ios #openai

null

(★ 2,070)

reasonable handling of nullable values

파일 탐색기

최종 버전 다운로드 (.zip)

- - test.yml
- float.go
- int.go
- type.go
- bool.go
- bool_test.go
- byte.go
- float.go
- float_test.go
- int.go
- int16.go
- int32.go
- int_test.go
- string.go
- string_test.go
- time.go
- time_test.go
- value.go
- value_test.go
.gitignore
bench_test.go
bool.go
bool_test.go
byte.go
float.go
float_test.go
go.mod
int.go
int16.go
int32.go
int_test.go
LICENSE
README.md
string.go
string_test.go
time.go
time_test.go
value.go
value_test.go

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/guregu/null

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd null

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## null [![GoDoc](https://godoc.org/github.com/guregu/null/v6?status.svg)](https://godoc.org/github.com/guregu/null/v6)
`import "github.com/guregu/null/v6"`

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 `""`. Zero values of these types will be considered null to SQL. If you need zero and null treated the same, use these.

#### Interfaces

- All types implement `sql.Scanner` and `driver.Valuer`, so you can use this library in place of `sql.NullXXX`.
- All types also implement `json.Marshaler` and `json.Unmarshaler`, so you can marshal them to their native JSON representation.
- All non-generic types implement `encoding.TextMarshaler`, `encoding.TextUnmarshaler`. A null object's `MarshalText` will return a blank string.
- All types implement `interface { IsZero() bool }`. Combined with Go 1.24's `,omitzero`, this lets you omit null types from JSON.

## null package

`import "github.com/guregu/null/v6"`

#### null.String
Nullable string.

Marshals to JSON null if SQL source data is null. Zero (blank) input will not produce a null String.

#### null.Int, null.Int32, null.Int16, null.Byte
Nullable int64/int32/int16/byte.

Marshals to JSON null if SQL source data is null. Zero input will not produce a null Int.

#### null.Float
Nullable float64.

Marshals to JSON null if SQL source data is null. Zero input will not produce a null Float.

#### null.Bool
Nullable bool.

Marshals to JSON null if SQL source data is null. False input will not produce a null Bool.

#### null.Time

Marshals to JSON null if SQL source data is null. Zero input will not produce a null Time.

#### null.Value
Generic nullable value.

Will marshal to JSON null if SQL source data is null. Does not implement `encoding.TextMarshaler`.

## zero package

`import "github.com/guregu/null/v6/zero"`

#### zero.String
Nullable string.

Will marshal to a blank string if null. Blank string input produces a null String. Null values and zero values are considered equivalent.

#### zero.Int, zero.Int32, zero.Int16, zero.Byte
Nullable int64/int32/int16/byte.

Will marshal to 0 if null. 0 produces a null Int. Null values and zero values are considered equivalent.

#### zero.Float
Nullable float64.

Will marshal to 0.0 if null. 0.0 produces a null Float. Null values and zero values are considered equivalent.

#### zero.Bool
Nullable bool.

Will marshal to false if null. `false` produces a null Float. Null values and zero values are considered equivalent.

#### zero.Time
Nullable time.

Will marshal to the zero time if null. Uses `time.Time`'s marshaler.

#### zero.Value[`T`]
Generic nullable value.

Will marshal to zero value if null. `T` is required to be a comparable type. Does not implement `encoding.TextMarshaler`.

## About

### Q&A

#### Can you add support for other types?
This package is intentionally limited in scope. It will only support the types that [`driver.Value`](https://godoc.org/database/sql/driver#Value) supports. Feel free to fork this and add more types if you want.

#### Can you add a feature that ____?
This package isn't intended to be a catch-all data-wrangling package. It is essentially finished. If you have an idea for a new feature, feel free to open an issue to talk about it or fork this package, but don't expect this to do everything.

### Package history

#### v6
- Added `ValueOr` method to each type

#### v5
- Now a Go module under the path `github.com/guregu/null/v6`
- Added missing types from `database/sql`: `Int32, Int16, Byte`
- Added generic `Value[T]` embedding `sql.Null[T]`

#### v4
- Available at `gopkg.in/guregu/null.v4`
- Unmarshaling from JSON `sql.NullXXX` JSON objects (e.g. `{"Int64": 123, "Valid": true}`) is no longer supported. It's unlikely many people used this, but if you need it, use v3.

### Bugs
- ~~`json`'s `",omitempty"` struct tag does not work correctly right now. It will never omit a null or empty String. This might be [fixed eventually](https://github.com/golang/go/issues/11939).~~
  - As of Go 1.24, you can use `,omitzero` to omit this package's types. Only took 10 years!

### License
BSD