package copystructure

import "github.com/mitchellh/copystructure"

Index ¶

• Variables
• func Copy(v interface{}) (interface{}, error)
• func Must(v interface{}, err error) interface{}
• type Config
• func (c Config) Copy(v interface{}) (interface{}, error)
• type CopierFunc

Examples ¶

• Copy

Variables ¶

var Copiers map[reflect.Type]CopierFunc = make(map[reflect.Type]CopierFunc)

Copiers is a map of types that behave specially when they are copied. If a type is found in this map while deep copying, this function will be called to copy it instead of attempting to copy all fields.

The key should be the type, obtained using: reflect.TypeOf(value with type).

It is unsafe to write to this map after Copies have started. If you are writing to this map while also copying, wrap all modifications to this map as well as to Copy in a mutex.

Functions ¶

func Copy ¶

func Copy(v interface{}) (interface{}, error)

Copy returns a deep copy of v.

{
	input := map[string]interface{}{
		"bob": map[string]interface{}{
			"emails": []string{"a", "b"},
		},
	}

	dup, err := Copy(input)
	if err != nil {
		panic(err)
	}

	fmt.Printf("%#v", dup)
	// Output:
	// map[string]interface {}{"bob":map[string]interface {}{"emails":[]string{"a", "b"}}}
}

map[string]interface {}{"bob":map[string]interface {}{"emails":[]string{"a", "b"}}}

func Must ¶

func Must(v interface{}, err error) interface{}

Must is a helper that wraps a call to a function returning (interface{}, error) and panics if the error is non-nil. It is intended for use in variable initializations and should only be used when a copy error should be a crashing case.

Types ¶

type Config ¶

type Config struct {
	// Lock any types that are a sync.Locker and are not a mutex while copying.
	// If there is an RLocker method, use that to get the sync.Locker.
	Lock bool

	// Copiers is a map of types associated with a CopierFunc. Use the global
	// Copiers map if this is nil.
	Copiers map[reflect.Type]CopierFunc
}

func (Config) Copy ¶

func (c Config) Copy(v interface{}) (interface{}, error)

type CopierFunc ¶

type CopierFunc func(interface{}) (interface{}, error)

CopierFunc is a function that knows how to deep copy a specific type. Register these globally with the Copiers variable.

Source Files ¶

copier_time.go copystructure.go