Package nul implements a nullable optional-type, for the Go programming language. In other programming languages, an optional-type might be know as: a option-type, or a maybe-type.
Go to file
Charles Iliya Krempeaux 73f29b1d15 cosmetic 2024-08-07 00:31:18 -07:00
LICENSE changelog.ca -> reiver.link 2024-08-01 16:32:26 -07:00
README.md changelog.ca -> reiver.link 2024-08-01 16:32:26 -07:00
go.mod "sourcecode.social/reiver/go-erorr" -> "github.com/reiver/go-erorr" 2024-08-01 16:31:41 -07:00
go.sum "sourcecode.social/reiver/go-erorr" -> "github.com/reiver/go-erorr" 2024-08-01 16:31:41 -07:00
nullable.go initial commits 2023-09-24 07:55:56 +09:00
nullable_filter_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_get_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_gostring_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_marshaljson.go "sourcecode.social/reiver/go-erorr" -> "github.com/reiver/go-erorr" 2024-08-01 16:31:41 -07:00
nullable_marshaljson_bool_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_marshaljson_int_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_marshaljson_string_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_unmarshaljson.go cosmetic 2024-08-07 00:31:18 -07:00
nullable_unmarshaljson_bool_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_unmarshaljson_int_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_unmarshaljson_string_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_whennothing_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_whennull_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00
nullable_whensomething_test.go "sourcecode.social/reiver/go-nul" -> "github.com/reiver/go-nul" 2024-08-01 16:28:38 -07:00

README.md

go-nul

Package nul implements a nullable optional-type, for the Go programming language.

In other programming languages, an optional-type might be known as: a option-type, or a maybe-type.

Documention

Online documentation, which includes examples, can be found at: http://godoc.org/github.com/reiver/go-nul

GoDoc

Examples

Here is an example nullable optional-type that can hold a string:

import "github.com/reiver/go-nul"

//

var op nul.Nullable[string] // the default value is nothing.

// ...

if nul.Nothing[string]() == op {
	fmt.Println("nothing")
}

// ...

op = nul.Null[string]()

// ...

if nul.Null[string]() == op {
	fmt.Println("null")
}

// ...

op = nul.Something("Hello world! 👾")

// ...

switch op {
case op.Nothing[string]():
	//@TODO
case op.Null[string]():
	//@TODO
case op.Something("apple"):
	//@TODO
case op.Something("banana"):
	//@TODO
case op.Something("cherry"):
	//@TODO
default:
	//@TODO
}

// ...

value, found := op.Get()
if found {
	fmt.Println("VALUE:", value)
} else {
	fmt.Println("either nothing or null")
}

Import

To import package nul use import code like the follownig:

import "github.com/reiver/go-nul"

Installation

To install package nul do the following:

GOPROXY=direct go get https://github.com/reiver/go-nul

Author

Package nul was written by Charles Iliya Krempeaux