123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187 |
- package sets
- import (
- "reflect"
- "sort"
- )
- type Empty struct{}
- // sets.String is a set of strings, implemented via map[string]struct{} for minimal memory consumption.
- type String map[string]Empty
- // NewString creates a String from a list of values.
- func NewString(items ...string) String {
- ss := String{}
- ss.Insert(items...)
- return ss
- }
- // StringKeySet creates a String from a keys of a map[string](? extends interface{}).
- // If the value passed in is not actually a map, this will panic.
- func StringKeySet(theMap interface{}) String {
- v := reflect.ValueOf(theMap)
- ret := String{}
- for _, keyValue := range v.MapKeys() {
- ret.Insert(keyValue.Interface().(string))
- }
- return ret
- }
- // Insert adds items to the set.
- func (s String) Insert(items ...string) {
- for _, item := range items {
- s[item] = Empty{}
- }
- }
- // Delete removes all items from the set.
- func (s String) Delete(items ...string) {
- for _, item := range items {
- delete(s, item)
- }
- }
- // Has returns true if and only if item is contained in the set.
- func (s String) Has(item string) bool {
- _, contained := s[item]
- return contained
- }
- // HasAll returns true if and only if all items are contained in the set.
- func (s String) HasAll(items ...string) bool {
- for _, item := range items {
- if !s.Has(item) {
- return false
- }
- }
- return true
- }
- // HasAny returns true if any items are contained in the set.
- func (s String) HasAny(items ...string) bool {
- for _, item := range items {
- if s.Has(item) {
- return true
- }
- }
- return false
- }
- // Difference returns a set of objects that are not in s2
- // For example:
- // s1 = {a1, a2, a3}
- // s2 = {a1, a2, a4, a5}
- // s1.Difference(s2) = {a3}
- // s2.Difference(s1) = {a4, a5}
- func (s String) Difference(s2 String) String {
- result := NewString()
- for key := range s {
- if !s2.Has(key) {
- result.Insert(key)
- }
- }
- return result
- }
- // Union returns a new set which includes items in either s1 or s2.
- // For example:
- // s1 = {a1, a2}
- // s2 = {a3, a4}
- // s1.Union(s2) = {a1, a2, a3, a4}
- // s2.Union(s1) = {a1, a2, a3, a4}
- func (s1 String) Union(s2 String) String {
- result := NewString()
- for key := range s1 {
- result.Insert(key)
- }
- for key := range s2 {
- result.Insert(key)
- }
- return result
- }
- // Intersection returns a new set which includes the item in BOTH s1 and s2
- // For example:
- // s1 = {a1, a2}
- // s2 = {a2, a3}
- // s1.Intersection(s2) = {a2}
- func (s1 String) Intersection(s2 String) String {
- var walk, other String
- result := NewString()
- if s1.Len() < s2.Len() {
- walk = s1
- other = s2
- } else {
- walk = s2
- other = s1
- }
- for key := range walk {
- if other.Has(key) {
- result.Insert(key)
- }
- }
- return result
- }
- // IsSuperset returns true if and only if s1 is a superset of s2.
- func (s1 String) IsSuperset(s2 String) bool {
- for item := range s2 {
- if !s1.Has(item) {
- return false
- }
- }
- return true
- }
- // Equal returns true if and only if s1 is equal (as a set) to s2.
- // Two sets are equal if their membership is identical.
- // (In practice, this means same elements, order doesn't matter)
- func (s1 String) Equal(s2 String) bool {
- return len(s1) == len(s2) && s1.IsSuperset(s2)
- }
- type sortableSliceOfString []string
- func (s sortableSliceOfString) Len() int { return len(s) }
- func (s sortableSliceOfString) Less(i, j int) bool { return lessString(s[i], s[j]) }
- func (s sortableSliceOfString) Swap(i, j int) { s[i], s[j] = s[j], s[i] }
- // List returns the contents as a sorted string slice.
- func (s String) List() []string {
- res := make(sortableSliceOfString, 0, len(s))
- for key := range s {
- res = append(res, key)
- }
- sort.Sort(res)
- return []string(res)
- }
- // UnsortedList returns the slice with contents in random order.
- func (s String) UnsortedList() []string {
- res := make([]string, 0, len(s))
- for key := range s {
- res = append(res, key)
- }
- return res
- }
- // Returns a single element from the set.
- func (s String) PopAny() (string, bool) {
- for key := range s {
- s.Delete(key)
- return key, true
- }
- var zeroValue string
- return zeroValue, false
- }
- // Len returns the size of the set.
- func (s String) Len() int {
- return len(s)
- }
- func lessString(lhs, rhs string) bool {
- return lhs < rhs
- }
|