ncode

package

v0.4.7 Latest Latest Go to latest Published: Nov 11, 2026 License: MIT Imports: 13 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/aerth/mostly

Links

Open Source Insights

README ¶

encoding

Documentation ¶

Overview ¶

Package ncode for twist

Index ¶

Variables
func B2N(b []byte) uint64
func DecodeJSON[T any](b []byte) (T, error)
func DecodeJSONReadCloser[T any](r io.ReadCloser) (T, error)
func DecodeJSONReader[T any](rdr io.Reader) (T, error)
func DecodeRequestBody[T any](w http.ResponseWriter, r *http.Request) (T, error)
func JSONIndent(a any) []byte
func JSONString(a any) string
func N2B[E constraints.Unsigned](n E) []byte
func ParseBase[T constraints.Unsigned](in string, base int) (T, error)
func ParseNumber[T constraints.Unsigned](in string) (T, error)
func Twist[T ~string | ~[]byte](a []string) []T
func TwistAny[T any, K any](a []T, fn func(v T) K) []K
func TwistAnySkipError[T any, K any](a []K, fn func(s K) (T, error)) ([]T, error)
func TwistAnyWithError[T any, K any](a []K, fn func(s K) (T, error)) ([]T, error)
func TwistBack[T ~string | ~[]byte](a []T) []string
func TwistFormat[T any](a []T, fn func(v T) string) []string
func TwistParse[T any](a []string, fn func(s string) (T, error)) ([]T, error)
func TwistParse2[T any, A any, B any](a []A, b B, fn2 func(a A, b B) (T, error)) ([]T, error)
func TwistParse2Ptr[T any, A any, B any](a []A, b B, fn2 func(a A, b B) (*T, error)) ([]*T, error)
func TwistParsePtr[T any](a []string, fn func(s string) (*T, error)) ([]*T, error)
func VarList[T any, A ~[]T](a ...T) A
type NCode
- func Twister[T any, V any](fn func(s V) (T, error)) NCode[T, V]
- func (n NCode[T, K]) Twist(a []K) ([]T, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	Binary = binary.LittleEndian
	JSON   = toJSON
)

View Source

var (
	S2B = VarList[string, []string]
	ANY = VarList[any, []any]
)

View Source

var DebugJSONRequests = false

View Source

var ErrOverflow = errors.New("overflow, possible incorrect data type")

View Source

var ErrSkip = errors.New("skip error")

View Source

var ErrZeroLength = fmt.Errorf("cannot decode zero length")

ErrZeroLength 404 not found

Functions ¶

func B2N ¶

func B2N(b []byte) uint64

B2N []byte to number

func DecodeJSON ¶ added in v0.4.4

func DecodeJSON[T any](b []byte) (T, error)

func DecodeJSONReadCloser ¶ added in v0.4.4

func DecodeJSONReadCloser[T any](r io.ReadCloser) (T, error)

func DecodeJSONReader ¶ added in v0.4.4

func DecodeJSONReader[T any](rdr io.Reader) (T, error)

DecodeJSONReader does not close reader. set `DebugJSONRequests = true` for debug logging

See DecodeJSONReadCloser

func DecodeRequestBody ¶

func DecodeRequestBody[T any](w http.ResponseWriter, r *http.Request) (T, error)

DecodeRequestBody (and close body)

func JSONIndent ¶ added in v0.4.4

func JSONIndent(a any) []byte

JSONIndent ... eg: ncode.JSON = ncode.JSONIndent

func JSONString ¶ added in v0.4.4

func JSONString(a any) string

func N2B ¶

func N2B[E constraints.Unsigned](n E) []byte

N2B Number to []byte

func ParseBase ¶

func ParseBase[T constraints.Unsigned](in string, base int) (T, error)

ParseBase string->~uint

func ParseNumber ¶

func ParseNumber[T constraints.Unsigned](in string) (T, error)

ParseNumber string->~uint

func Twist ¶

func Twist[T ~string | ~[]byte](a []string) []T

Twist strings into things, O(n)

func TwistAny ¶

func TwistAny[T any, K any](a []T, fn func(v T) K) []K

TwistAny array into another kind of array

func TwistAnySkipError ¶ added in v0.4.4

func TwistAnySkipError[T any, K any](a []K, fn func(s K) (T, error)) ([]T, error)

TwistAnySkipError in case theres a parsing issue. Errored are skipped and items will be zero-value in returned slice.

Errors are collected

func TwistAnyWithError ¶

func TwistAnyWithError[T any, K any](a []K, fn func(s K) (T, error)) ([]T, error)

TwistAnyWithError in case theres a parsing issue. skip elements (but continue indexes) by returning ErrSkip in fn function

Skipped items will be zero-value in returned slice.

func TwistBack ¶

func TwistBack[T ~string | ~[]byte](a []T) []string

TwistBack things into strings, O(n)

func TwistFormat ¶

func TwistFormat[T any](a []T, fn func(v T) string) []string

TwistFormat array into a string array

func TwistParse ¶

func TwistParse[T any](a []string, fn func(s string) (T, error)) ([]T, error)

TwistParse strings into any things (with error handling) skip elements (but continue indexes) by returning ErrSkip in fn function

Example:

ncode.TwistParse[url.URL]([]string{"google.com", "myspace.com"}, url.Parse)

TODO: skip without incrementing index

func TwistParse2 ¶ added in v0.4.4

func TwistParse2[T any, A any, B any](a []A, b B, fn2 func(a A, b B) (T, error)) ([]T, error)

TwistParse2 strings into any things (with error handling) skip elements (but continue indexes) by returning ErrSkip in fn function

Example:

ncode.TwistParse2[url.URL]([]string{"google.com", "myspace.com"}, url.Parse2)

TODO: skip without incrementing index

func TwistParse2Ptr ¶ added in v0.4.4

func TwistParse2Ptr[T any, A any, B any](a []A, b B, fn2 func(a A, b B) (*T, error)) ([]*T, error)

func TwistParsePtr ¶ added in v0.4.4

func TwistParsePtr[T any](a []string, fn func(s string) (*T, error)) ([]*T, error)

func VarList ¶ added in v0.4.7

func VarList[T any, A ~[]T](a ...T) A

Types ¶

type NCode ¶ added in v0.4.4

type NCode[T any, K any] struct {
	NonFatalErrors bool
	Fn             func(s K) (T, error)
}

func Twister ¶ added in v0.4.7

func Twister[T any, V any](fn func(s V) (T, error)) NCode[T, V]

func (NCode[T, K]) Twist ¶ added in v0.4.7

func (n NCode[T, K]) Twist(a []K) ([]T, error)

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
constraints Package constraints defines a set of useful constraints to be used with type parameters.	Package constraints defines a set of useful constraints to be used with type parameters.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL