uslice

package
Version: v0.0.0-...-cdf6abf Latest Latest
Warning

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

Go to latest
Published: May 12, 2015 License: GPL-2.0 Imports: 1 Imported by: 0

README

uslice

-- import "github.com/go-utils/uslice"

Go programming helpers for common 'pseudo-generic' typed-slice needs.

Usage

func BoolAppendUnique
func BoolAppendUnique(ref *[]bool, v bool)

Appends v to *ref only if *ref does not already contain v.

func BoolAppendUniques
func BoolAppendUniques(ref *[]bool, vals ...bool)

Appends each value in vals to *ref only *ref does not already contain it.

func BoolAt
func BoolAt(slice []bool, val bool) int

Returns the position of val in slice.

func BoolConvert
func BoolConvert(src []interface{}, sparse bool) (dst []bool)

Converts src to dst.

If sparse is true, then only successfully converted bool values are placed in dst, so there may not be a 1-to-1 correspondence of dst to src in length or indices.

If sparse is false, dst has the same length as src and non-convertable values remain zeroed.

func BoolEach
func BoolEach(sl []bool, apply ...func(bool) bool) []bool

Sets each bool in sl to the result of passing it to each apply func. Although sl is modified in-place, it is also returned for convenience.

func BoolEnsureCap
func BoolEnsureCap(ref *[]bool, capacity int)

Calls BoolSetCap only if the current cap(*ref) is less than the specified capacity.

func BoolEnsureLen
func BoolEnsureLen(ref *[]bool, length int)

Calls BoolSetLen only if the current len(*ref) is less than the specified length.

func BoolEquivalent
func BoolEquivalent(one, two []bool) bool

Returns whether one and two only contain identical values, regardless of ordering.

func BoolHas
func BoolHas(slice []bool, val bool) bool

Returns whether val is in slice.

func BoolHasAny
func BoolHasAny(slice []bool, vals ...bool) bool

Returns whether at least one of the specified vals is contained in slice.

func BoolRemove
func BoolRemove(ref *[]bool, v bool, all bool)

Removes the first occurrence of v encountered in *ref, or all occurrences if all is true.

func BoolSetCap
func BoolSetCap(ref *[]bool, capacity int)

Sets *ref to a copy of *ref with the specified capacity.

func BoolSetLen
func BoolSetLen(ref *[]bool, length int)

Sets *ref to a copy of *ref with the specified length.

func BoolWithout
func BoolWithout(slice []bool, keepOrder bool, withoutVals ...bool) []bool

Removes all specified withoutVals from slice.

func F64AppendUnique
func F64AppendUnique(ref *[]float64, v float64)

Appends v to *ref only if *ref does not already contain v.

func F64AppendUniques
func F64AppendUniques(ref *[]float64, vals ...float64)

Appends each value in vals to *ref only *ref does not already contain it.

func F64At
func F64At(slice []float64, val float64) int

Returns the position of val in slice.

func F64Convert
func F64Convert(src []interface{}, sparse bool) (dst []float64)

Converts src to dst.

If sparse is true, then only successfully converted float64 values are placed in dst, so there may not be a 1-to-1 correspondence of dst to src in length or indices.

If sparse is false, dst has the same length as src and non-convertable values remain zeroed.

func F64Each
func F64Each(sl []float64, apply ...func(float64) float64) []float64

Sets each float64 in sl to the result of passing it to each apply func. Although sl is modified in-place, it is also returned for convenience.

func F64EnsureCap
func F64EnsureCap(ref *[]float64, capacity int)

Calls F64SetCap only if the current cap(*ref) is less than the specified capacity.

func F64EnsureLen
func F64EnsureLen(ref *[]float64, length int)

Calls F64SetLen only if the current len(*ref) is less than the specified length.

func F64Equivalent
func F64Equivalent(one, two []float64) bool

Returns whether one and two only contain identical values, regardless of ordering.

func F64Has
func F64Has(slice []float64, val float64) bool

Returns whether val is in slice.

func F64HasAny
func F64HasAny(slice []float64, vals ...float64) bool

Returns whether at least one of the specified vals is contained in slice.

func F64Remove
func F64Remove(ref *[]float64, v float64, all bool)

Removes the first occurrence of v encountered in *ref, or all occurrences if all is true.

func F64SetCap
func F64SetCap(ref *[]float64, capacity int)

Sets *ref to a copy of *ref with the specified capacity.

func F64SetLen
func F64SetLen(ref *[]float64, length int)

Sets *ref to a copy of *ref with the specified length.

func F64Without
func F64Without(slice []float64, keepOrder bool, withoutVals ...float64) []float64

Removes all specified withoutVals from slice.

func IntAppendUnique
func IntAppendUnique(ref *[]int, v int)

Appends v to *ref only if *ref does not already contain v.

func IntAppendUniques
func IntAppendUniques(ref *[]int, vals ...int)

Appends each value in vals to *ref only *ref does not already contain it.

func IntAt
func IntAt(slice []int, val int) int

Returns the position of val in slice.

func IntConvert
func IntConvert(src []interface{}, sparse bool) (dst []int)

Converts src to dst.

If sparse is true, then only successfully converted int values are placed in dst, so there may not be a 1-to-1 correspondence of dst to src in length or indices.

If sparse is false, dst has the same length as src and non-convertable values remain zeroed.

func IntEach
func IntEach(sl []int, apply ...func(int) int) []int

Sets each int in sl to the result of passing it to each apply func. Although sl is modified in-place, it is also returned for convenience.

func IntEnsureCap
func IntEnsureCap(ref *[]int, capacity int)

Calls IntSetCap only if the current cap(*ref) is less than the specified capacity.

func IntEnsureLen
func IntEnsureLen(ref *[]int, length int)

Calls IntSetLen only if the current len(*ref) is less than the specified length.

func IntEquivalent
func IntEquivalent(one, two []int) bool

Returns whether one and two only contain identical values, regardless of ordering.

func IntHas
func IntHas(slice []int, val int) bool

Returns whether val is in slice.

func IntHasAny
func IntHasAny(slice []int, vals ...int) bool

Returns whether at least one of the specified vals is contained in slice.

func IntRemove
func IntRemove(ref *[]int, v int, all bool)

Removes the first occurrence of v encountered in *ref, or all occurrences if all is true.

func IntSetCap
func IntSetCap(ref *[]int, capacity int)

Sets *ref to a copy of *ref with the specified capacity.

func IntSetLen
func IntSetLen(ref *[]int, length int)

Sets *ref to a copy of *ref with the specified length.

func IntWithout
func IntWithout(slice []int, keepOrder bool, withoutVals ...int) []int

Removes all specified withoutVals from slice.

func StrAppendUnique
func StrAppendUnique(ref *[]string, v string)

Appends v to *ref only if *ref does not already contain v.

func StrAppendUniques
func StrAppendUniques(ref *[]string, vals ...string)

Appends each value in vals to *ref only *ref does not already contain it.

func StrAt
func StrAt(slice []string, val string) int

Returns the position of val in slice.

func StrAtIgnoreCase
func StrAtIgnoreCase(vals []string, val string) int

Returns the position of lower-case val in lower-case vals.

func StrConvert
func StrConvert(src []interface{}, sparse bool) (dst []string)

Converts src to dst.

If sparse is true, then only successfully converted string values are placed in dst, so there may not be a 1-to-1 correspondence of dst to src in length or indices.

If sparse is false, dst has the same length as src and non-convertable values remain zeroed.

func StrEach
func StrEach(sl []string, apply ...func(string) string) []string

Sets each string in sl to the result of passing it to each apply func. Although sl is modified in-place, it is also returned for convenience.

func StrEnsureCap
func StrEnsureCap(ref *[]string, capacity int)

Calls StrSetCap only if the current cap(*ref) is less than the specified capacity.

func StrEnsureLen
func StrEnsureLen(ref *[]string, length int)

Calls StrSetLen only if the current len(*ref) is less than the specified length.

func StrEquivalent
func StrEquivalent(one, two []string) bool

Returns whether one and two only contain identical values, regardless of ordering.

func StrHas
func StrHas(slice []string, val string) bool

Returns whether val is in slice.

func StrHasAny
func StrHasAny(slice []string, vals ...string) bool

Returns whether at least one of the specified vals is contained in slice.

func StrHasIgnoreCase
func StrHasIgnoreCase(vals []string, val string) bool

Returns whether lower-case val is in lower-case vals.

func StrRemove
func StrRemove(ref *[]string, v string, all bool)

Removes the first occurrence of v encountered in *ref, or all occurrences if all is true.

func StrSetCap
func StrSetCap(ref *[]string, capacity int)

Sets *ref to a copy of *ref with the specified capacity.

func StrSetLen
func StrSetLen(ref *[]string, length int)

Sets *ref to a copy of *ref with the specified length.

func StrWithout
func StrWithout(slice []string, keepOrder bool, withoutVals ...string) []string

Removes all specified withoutVals from slice.

-- godocdown http://github.com/robertkrimen/godocdown

Documentation

Overview

Go programming helpers for common 'pseudo-generic' typed-slice needs.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func BoolAppendUnique

func BoolAppendUnique(ref *[]bool, v bool)

Appends `v` to `*ref` only if `*ref` does not already contain `v`.

func BoolAppendUniques

func BoolAppendUniques(ref *[]bool, vals ...bool)

Appends each value in `vals` to `*ref` only `*ref` does not already contain it.

func BoolAt

func BoolAt(slice []bool, val bool) int

Returns the position of `val` in `slice`.

func BoolConvert

func BoolConvert(src []interface{}, sparse bool) (dst []bool)

Converts `src` to `dst`.

If `sparse` is `true`, then only successfully converted `bool` values are placed in `dst`, so there may not be a 1-to-1 correspondence of `dst` to `src` in length or indices.

If `sparse` is `false`, `dst` has the same length as `src` and non-convertable values remain zeroed.

func BoolEach

func BoolEach(sl []bool, apply ...func(bool) bool) []bool

Sets each `bool` in `sl` to the result of passing it to each `apply` func. Although `sl` is modified in-place, it is also returned for convenience.

func BoolEnsureCap

func BoolEnsureCap(ref *[]bool, capacity int)

Calls `BoolSetCap` only if the current `cap(*ref)` is less than the specified `capacity`.

func BoolEnsureLen

func BoolEnsureLen(ref *[]bool, length int)

Calls `BoolSetLen` only if the current `len(*ref)` is less than the specified `length`.

func BoolEquivalent

func BoolEquivalent(one, two []bool) bool

Returns whether `one` and `two` only contain identical values, regardless of ordering.

func BoolHas

func BoolHas(slice []bool, val bool) bool

Returns whether `val` is in `slice`.

func BoolHasAny

func BoolHasAny(slice []bool, vals ...bool) bool

Returns whether at least one of the specified `vals` is contained in `slice`.

func BoolRemove

func BoolRemove(ref *[]bool, v bool, all bool)

Removes the first occurrence of `v` encountered in `*ref`, or all occurrences if `all` is `true`.

func BoolSetCap

func BoolSetCap(ref *[]bool, capacity int)

Sets `*ref` to a copy of `*ref` with the specified `capacity`.

func BoolSetLen

func BoolSetLen(ref *[]bool, length int)

Sets `*ref` to a copy of `*ref` with the specified `length`.

func BoolWithout

func BoolWithout(slice []bool, keepOrder bool, withoutVals ...bool) []bool

Removes all specified `withoutVals` from `slice`.

func F64AppendUnique

func F64AppendUnique(ref *[]float64, v float64)

Appends `v` to `*ref` only if `*ref` does not already contain `v`.

func F64AppendUniques

func F64AppendUniques(ref *[]float64, vals ...float64)

Appends each value in `vals` to `*ref` only `*ref` does not already contain it.

func F64At

func F64At(slice []float64, val float64) int

Returns the position of `val` in `slice`.

func F64Convert

func F64Convert(src []interface{}, sparse bool) (dst []float64)

Converts `src` to `dst`.

If `sparse` is `true`, then only successfully converted `float64` values are placed in `dst`, so there may not be a 1-to-1 correspondence of `dst` to `src` in length or indices.

If `sparse` is `false`, `dst` has the same length as `src` and non-convertable values remain zeroed.

func F64Each

func F64Each(sl []float64, apply ...func(float64) float64) []float64

Sets each `float64` in `sl` to the result of passing it to each `apply` func. Although `sl` is modified in-place, it is also returned for convenience.

func F64EnsureCap

func F64EnsureCap(ref *[]float64, capacity int)

Calls `F64SetCap` only if the current `cap(*ref)` is less than the specified `capacity`.

func F64EnsureLen

func F64EnsureLen(ref *[]float64, length int)

Calls `F64SetLen` only if the current `len(*ref)` is less than the specified `length`.

func F64Equivalent

func F64Equivalent(one, two []float64) bool

Returns whether `one` and `two` only contain identical values, regardless of ordering.

func F64Has

func F64Has(slice []float64, val float64) bool

Returns whether `val` is in `slice`.

func F64HasAny

func F64HasAny(slice []float64, vals ...float64) bool

Returns whether at least one of the specified `vals` is contained in `slice`.

func F64Remove

func F64Remove(ref *[]float64, v float64, all bool)

Removes the first occurrence of `v` encountered in `*ref`, or all occurrences if `all` is `true`.

func F64SetCap

func F64SetCap(ref *[]float64, capacity int)

Sets `*ref` to a copy of `*ref` with the specified `capacity`.

func F64SetLen

func F64SetLen(ref *[]float64, length int)

Sets `*ref` to a copy of `*ref` with the specified `length`.

func F64Without

func F64Without(slice []float64, keepOrder bool, withoutVals ...float64) []float64

Removes all specified `withoutVals` from `slice`.

func IntAppendUnique

func IntAppendUnique(ref *[]int, v int)

Appends `v` to `*ref` only if `*ref` does not already contain `v`.

func IntAppendUniques

func IntAppendUniques(ref *[]int, vals ...int)

Appends each value in `vals` to `*ref` only `*ref` does not already contain it.

func IntAt

func IntAt(slice []int, val int) int

Returns the position of `val` in `slice`.

func IntConvert

func IntConvert(src []interface{}, sparse bool) (dst []int)

Converts `src` to `dst`.

If `sparse` is `true`, then only successfully converted `int` values are placed in `dst`, so there may not be a 1-to-1 correspondence of `dst` to `src` in length or indices.

If `sparse` is `false`, `dst` has the same length as `src` and non-convertable values remain zeroed.

func IntEach

func IntEach(sl []int, apply ...func(int) int) []int

Sets each `int` in `sl` to the result of passing it to each `apply` func. Although `sl` is modified in-place, it is also returned for convenience.

func IntEnsureCap

func IntEnsureCap(ref *[]int, capacity int)

Calls `IntSetCap` only if the current `cap(*ref)` is less than the specified `capacity`.

func IntEnsureLen

func IntEnsureLen(ref *[]int, length int)

Calls `IntSetLen` only if the current `len(*ref)` is less than the specified `length`.

func IntEquivalent

func IntEquivalent(one, two []int) bool

Returns whether `one` and `two` only contain identical values, regardless of ordering.

func IntHas

func IntHas(slice []int, val int) bool

Returns whether `val` is in `slice`.

func IntHasAny

func IntHasAny(slice []int, vals ...int) bool

Returns whether at least one of the specified `vals` is contained in `slice`.

func IntRemove

func IntRemove(ref *[]int, v int, all bool)

Removes the first occurrence of `v` encountered in `*ref`, or all occurrences if `all` is `true`.

func IntSetCap

func IntSetCap(ref *[]int, capacity int)

Sets `*ref` to a copy of `*ref` with the specified `capacity`.

func IntSetLen

func IntSetLen(ref *[]int, length int)

Sets `*ref` to a copy of `*ref` with the specified `length`.

func IntWithout

func IntWithout(slice []int, keepOrder bool, withoutVals ...int) []int

Removes all specified `withoutVals` from `slice`.

func StrAppendUnique

func StrAppendUnique(ref *[]string, v string)

Appends `v` to `*ref` only if `*ref` does not already contain `v`.

func StrAppendUniques

func StrAppendUniques(ref *[]string, vals ...string)

Appends each value in `vals` to `*ref` only `*ref` does not already contain it.

func StrAt

func StrAt(slice []string, val string) int

Returns the position of `val` in `slice`.

func StrAtIgnoreCase

func StrAtIgnoreCase(vals []string, val string) int

Returns the position of lower-case `val` in lower-case `vals`.

func StrConvert

func StrConvert(src []interface{}, sparse bool) (dst []string)

Converts `src` to `dst`.

If `sparse` is `true`, then only successfully converted `string` values are placed in `dst`, so there may not be a 1-to-1 correspondence of `dst` to `src` in length or indices.

If `sparse` is `false`, `dst` has the same length as `src` and non-convertable values remain zeroed.

func StrEach

func StrEach(sl []string, apply ...func(string) string) []string

Sets each `string` in `sl` to the result of passing it to each `apply` func. Although `sl` is modified in-place, it is also returned for convenience.

func StrEnsureCap

func StrEnsureCap(ref *[]string, capacity int)

Calls `StrSetCap` only if the current `cap(*ref)` is less than the specified `capacity`.

func StrEnsureLen

func StrEnsureLen(ref *[]string, length int)

Calls `StrSetLen` only if the current `len(*ref)` is less than the specified `length`.

func StrEquivalent

func StrEquivalent(one, two []string) bool

Returns whether `one` and `two` only contain identical values, regardless of ordering.

func StrHas

func StrHas(slice []string, val string) bool

Returns whether `val` is in `slice`.

func StrHasAny

func StrHasAny(slice []string, vals ...string) bool

Returns whether at least one of the specified `vals` is contained in `slice`.

func StrHasIgnoreCase

func StrHasIgnoreCase(vals []string, val string) bool

Returns whether lower-case `val` is in lower-case `vals`.

func StrRemove

func StrRemove(ref *[]string, v string, all bool)

Removes the first occurrence of `v` encountered in `*ref`, or all occurrences if `all` is `true`.

func StrSetCap

func StrSetCap(ref *[]string, capacity int)

Sets `*ref` to a copy of `*ref` with the specified `capacity`.

func StrSetLen

func StrSetLen(ref *[]string, length int)

Sets `*ref` to a copy of `*ref` with the specified `length`.

func StrWithout

func StrWithout(slice []string, keepOrder bool, withoutVals ...string) []string

Removes all specified `withoutVals` from `slice`.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL